Oracle Forms Developer – Form Builder Reference, Volume 1

FIND_OLE_VERB built-in
Description
Returns an OLE verb index. An OLE verb specifies the action that you can perform on an OLE object,
and each OLE verb has a corresponding OLE verb index. The OLE verb index is returned as a
VARCHAR2 string and must be converted to NUMBER when used in FORMS_OLE.EXE_VERB. You
must define an appropriately typed variable to accept the return value.
Syntax
FUNCTION FIND_OLE_VERB
(item_id Item,
verb_name VARCHAR2);
FUNCTION FIND_OLE_VERB
(item_name VARCHAR2,
verb_name VARCHAR2);
Returns VARCHAR2
Built-in Type unrestricted function
Enter Query Mode no
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.
verb_name Specifies the name of an OLE verb. An OLE verb specifies the action that
you can perform on an OLE object. Use the Forms_OLE.Get_Verb_Name
built-in to obtain this value. The data type of the name is VARCHAR2
string.
FIND_OLE_VERB restrictions
Valid only on Microsoft Windows and Macintosh.
FIND_OLE_VERB examples
132
/*
** Built-in: EXEC_VERB
** Example: Finds an OLE verb index for use with the
** Forms_OLE.Exec_Verb built-in.
** trigger: When-Button-Pressed
*/
DECLARE
item_id ITEM;
item_name VARCHAR(25) := ’OLEITM’;
verb_index_str VARCHAR(20);
verb_index NUMBER;