Oracle Forms Developer – Form Builder Reference, Volume 1

SET_GROUP_SELECTION built-in
Description
Marks the specified row in the given record group for subsequent programmatic row operations. Rows
are numbered sequentially starting at 1. If you select rows 3, 8, and 12, for example, those rows are
considered by Form Builder 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.
Syntax
SET_GROUP_SELECTION
(recordgroup_id RecordGroup,
row_number NUMBER);
SET_GROUP_SELECTION
(recordgroup_name VARCHAR2,
row_number NUMBER);
Built-in Type unrestricted procedure
Enter Query Mode yes
Parameters
recordgroup_id Specifies the unique ID that Form Builder 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.
SET_GROUP_SELECTION examples
380
/*
** Built-in: SET_GROUP_SELECTION
** Example: Set all of the even rows as selected in the
** record group whose id is passed-in as a
** parameter.
*/
PROCEDURE Select_Even_Rows ( rg_id RecordGroup ) IS
BEGIN
FOR j IN 1..Get_Group_Row_Count(rg_id) LOOP
IF MOD(j,2)=0 THEN
Set_Group_Selection( rg_id, j );
END IF;
END LOOP;
END;