Oracle Forms Developer – Form Builder Reference, Volume 1

VBX.GET_VALUE_PROPERTY built-in
Description
Gets the VBX Control Value Property of a VBX control.
Syntax
VBX.GET_VALUE_PROPERTY
(item_id ITEM);
VBX.GET_VALUE_PROPERTY
(item_name VARCHAR2);
Built-in Type unrestricted function
Returns property
Enter Query Mode yes
Parameters
item_id Specifies the unique ID that Form Builder assigns to the item when created.
Use the FIND_ITEM built-in to return the ID to an appropriately typed
variable. The data type of the ID is ITEM.
item_name Specifies the name of the object created at design time. The data type of
the name is VARCHAR2 string.
VBX.GET_VALUE_PROPERTY restrictions
Valid only on Microsoft Windows.
VBX.GET_VALUE_PROPERTY examples
/*
** Built-in: VBX.GET_VALUE_PROPERTY
** Example: Passes the VBX Control Value to the user-defined
** Verify_Item_Value subprogram. Verify_Item_Value
** ensures the display value is the expected value.
*/
DECLARE
ItemName VARCHAR2(40) := ’SPINBUTTON’;
VBX_VAL_PROP VARCHAR2(40);
BEGIN
VBX_VAL_PROP := VBX.Get_Value_Property(ItemName);
Verify_Item_Value(VBX_VAL_PROP);
END;
461