11.01.2013 Views

Oracle Forms Developer – Form Builder Reference, Volume 1

Oracle Forms Developer – Form Builder Reference, Volume 1

Oracle Forms Developer – Form Builder Reference, Volume 1

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

When-Clear-Block trigger<br />

Description<br />

Fires just before <strong>Form</strong> <strong>Builder</strong> clears the data from the current block.<br />

Note that the When-Clear-Block trigger does not fire when <strong>Form</strong> <strong>Builder</strong> clears the current block during<br />

the CLEAR_FORM event.<br />

Definition Level form or block<br />

Legal Commands<br />

SELECT statements, unrestricted built-ins<br />

Enter Query Mode yes<br />

Usage Notes<br />

• Use a When-Clear-Block trigger to perform an action every time <strong>Form</strong> <strong>Builder</strong> flushes the current<br />

block. For example, you might want to perform an automatic commit whenever this condition<br />

occurs.<br />

• In a When-Clear-Block trigger, the value of SYSTEM.RECORD_STATUS is unreliable because<br />

there is no current record. An alternative is to use GET_RECORD_PROPERTY to obtain the<br />

record status. Because GET_RECORD_PROPERTY requires reference to a specific record, its<br />

value is always accurate.<br />

On Failure<br />

no effect on the clearing of the block<br />

Fires In<br />

CLEAR_BLOCK<br />

COUNT_QUERY<br />

ENTER_QUERY<br />

Open the Query<br />

See Process Flowcharts<br />

499

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!