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

DISPLAY_ITEM Built-in

Description

Maintained for backward compatibility only. For new applications, you should use the SET_ITEM_INSTANCE_PROPERTY Built-in. DISPLAY_ITEM modifies an item's appearance by assigning a specified display attribute to the item. DISPLAY_ITEM has the side-effect of also changing the appearance of any items that mirror the changed instance. SET_ITEM_INSTANCE_PROPERTY does not change mirror items.

You can reference any item in the current form.

Any change made by a DISPLAY_ITEM Built-in is effective until:

Syntax

PROCEDURE DISPLAY_ITEM
(item_id ITEM,
attribute
VARCHAR2);

PROCEDURE DISPLAY_ITEM
(item_name VARCHAR2,
attribute
VARCHAR2);

Built-in Type unrestricted procedure

Enter Query Mode yes

Parameters
item_id 
 
Specifies the unique ID that Oracle Forms assigns to the item when it creates the item. The data type of the ID is ITEM.
 
item_name 
 
Specifies the VARCHAR2 string you gave to the item when you created it.
 
attribute 
 
Specifies a named visual attribute that should exist. Oracle Forms will search for named visual attribute first.

Note: You can specify Normal as a method for applying the default attributes to an item, but only if your form does not contain a visual attribute or logical (or otherwise) called Normal. You can also specify NULL as a method for returning an item to its initial visual attributes (default, custom, or named).

DISPLAY_ITEM Examples

/*

** Built-in: DISPLAY_ITEM
** Example: Change the visual attribute of each item in the
** current record.
*/
DECLARE
cur_itm VARCHAR2(80);
cur_block VARCHAR2(80) := :System.Cursor_Block;
BEGIN
cur_itm := Get_Block_Property( cur_block, FIRST_ITEM );
WHILE ( cur_itm IS NOT NULL ) LOOP
cur_itm := cur_block||'.'||cur_itm;
Display_Item( cur_itm, 'My_Favorite_Named_Attribute');
cur_itm := Get_Item_Property( cur_itm, NEXTITEM );
END LOOP;
END;


SET_ITEM_PROPERTY Built-in

SET_ITEM_INSTANCE_PROPERTY Built-in