Oracle Forms Developer – Form Builder Reference, Volume 1

SET_ITEM_INSTANCE_PROPERTY built-in
Description
Modifies the current item instance in a block by changing the specified item property.
SET_ITEM_INSTANCE_PROPERTY does not change the appearance of items that mirror the current
instance.
You can reference any item in the current form. Note that SET_ITEM_INSTANCE_PROPERTY only
affects the display of the current instance of the item; other instances of the specified item are not
affected. This means that if you specify a display change for an item that exists in a multi-record block,
SET_ITEM_INSTANCE_PROPERTY only changes the instance of that item that belongs to the block’s
current record. If you want to change all instances of an item in a multi-record block, use
SET_ITEM_PROPERTY .
Any change made by a SET_ITEM_INSTANCE_PROPERTY remains in effect until:
• the same item instance is referenced by another SET_ITEM_INSTANCE_PROPERTY, or
• the same item instance is referenced by the DISPLAY_ITEM built-in, or
• the instance of the item is removed (e.g., through a CLEAR_RECORD or a query), or
• the current form is exited
Syntax
SET_ITEM_INSTANCE_PROPERTY
(item_id ITEM,
record_number NUMBER,
property NUMBER,
value VARCHAR2);
SET_ITEM_INSTANCE_PROPERTY
(item_name VARCHAR2,
record_number NUMBER,
property NUMBER,
value VARCHAR2);
SET_ITEM_INSTANCE_PROPERTY
(item_name VARCHAR2,
record_number NUMBER,
property NUMBER,
value NUMBER);
Built-in Type unrestricted procedure
Enter Query Mode yes
Parameters
item_id The unique ID that Form Builder assigned to the object when it created it.
Use the FIND_ITEM built-in to return the ID to a variable with datatype of
ITEM.
record_number The record number that you want to set. The record number is the record’s
position in the block. Specify as a whole number. You can specify
CURRENT_RECORD if you want to set the block’s current record.
382