A script-enabled browser is required for this page to function properly.

UNSET_GROUP_SELECTION Built-in

Syntax

UNSET_GROUP_SELECTION
(recordgroup_id RecordGroup,
row_number
NUMBER);

UNSET_GROUP_SELECTION
(recordgroup_name VARCHAR2,
row_number
NUMBER);

Built-in Type unrestricted procedure

Enter Query Mode yes

Description

Unmarks the specified row in the indicated record group. Use the procedure to unmark rows that have been programmatically selected by a previous call to SET_GROUP_SELECTION.

Rows are numbered sequentially starting at 1. If you select rows 3, 8, and 12, for example, those rows are considered by Oracle Forms to be selections 1, 2, and 3. You can undo any row selections for the entire group by calling the RESET_GROUP_SELECTION Built-in.

Parameters

recordgroup_id 
 
Specifies the unique ID that Oracle Forms assigns to the record group when created. Use the FIND_GROUP Built-in to return the ID to a variable. The data type of the ID is RecordGroup.
 
recordgroup_name 
 
Specifies the name of the record group that you gave to the group when creating it. The data type of the name is VARCHAR2.
 
row_number 
 
Specifies the number of the record group row that you want to select. The value you specify is a NUMBER.

UNSET_GROUP_SELECTION Example

/*
** Built-in: UNSET_GROUP_SELECTION
** Example: Clear all of the even rows as selected in the
** record group whose id is passed-in as a
** parameter.
*/
PROCEDURE Clear_Even_Rows ( rg_id RecordGroup ) IS
BEGIN
FOR j IN 1..Get_Group_Row_Count(rg_id) LOOP
IF MOD(j,2)=0 THEN
Unset_Group_Selection( rg_id, j );
END IF;
END LOOP;
END;