Oracle Forms Developer – Form Builder Reference, Volume 1

DELETE_GROUP_ROW built-in
Description
Deletes the indicated row or all rows of the given record group. Form Builder automatically decrements
the row numbers of all rows that follow a deleted row. When rows are deleted, the appropriate memory
is freed and available to Form Builder.
If you choose to delete all rows of the group by supplying the ALL_ROWS constant, Form Builder
deletes the rows, but the group still exists until you perform the DELETE_GROUP subprogram.
When a single row is deleted, subsequent rows are renumbered so that row numbers remain contiguous.
Syntax
PROCEDURE DELETE_GROUP_ROW
(recordgroup_id RecordGroup,
row_number NUMBER);
PROCEDURE DELETE_GROUP_ROW
(recordgroup_name VARCHAR2,
row_number NUMBER);
Built-in Type unrestricted procedure
Enter Query Mode yes
Parameters
recordgroup_id The unique ID that Form Builder assigns the group when it creates it. The
data type of the ID is RecordGroup.
recordgroup_name The name you gave to the record group when you created it. The data type
of the name is VARCHAR2.
row_number Specifies the row to be deleted from the record group. Rows are
automatically numbered from 1 to n. Row number parameter data type is
NUMBER.
DELETE_GROUP_ROW restrictions
ALL_ROWS Specifies that Form Builder is to delete all rows without
deleting the record group. ALL_ROWS is a constant.
This built-in cannot be used to delete rows from a static record group.
DELETE_GROUP_ROW examples
/*
** Built-in: DELETE_GROUP_ROW
** Example: Delete certain number of records from the tail
** of the specified record group.
*/
PROCEDURE Delete_Tail_Records( recs_to_del NUMBER,
rg_name VARCHAR2 ) IS
rg_id RecordGroup;
77