VADELIA |
SADELIA |
|||
(I/B) |
(B) |
Description
Searches for the graphical object whose type and (partially- or fully-qualified) static name are set as parameters.
If the function finds an object matching the request, it returns *NORMAL. Otherwise it returns one of the following error codes:
- 100: The function was used on a server part;
- 200: The object cannot be fully qualified (inadequate context);
- 300: No fully qualified objects exist for the specified type.
Syntax
Result = &CHECK_OBJECT(StaticName, ObjectType)
Parameters
Description |
Contents |
Controls |
|
Result |
NUM_E or NUM_P numerical variable 3 characters long with 0 decimals. |
Result of the search for the specified object (and type). |
|
Static name |
ALPHA variable or constant. |
Partially- or fully-qualified static name of the object to be found. |
Mandatory parameter. |
Object type |
ALPHA constant. |
Basic Graphical Object (BGO) name, *MENU_ITEM (for a menu) or *WINDOW (for a window). |
Mandatory parameter. |
Possible static name syntaxes:
Object type |
Syntax 1 |
Syntax 2 |
Syntax 3 |
Object |
PgmName.WinName.ObjectName |
WinName.ObjectName |
ObjectName |
Window |
PgmName.WinName.WinName |
WinName.WinName |
WinName |
WinMenuItem |
PgmName.WinName.WinName[MenuId] |
WinName.WinName[MenuId] |
WinName[MenuId] |
MenuItemObject |
PgmName.WinName.ObjectName[MenuEvt] |
WinName.ObjectName[MenuId] |
ObjectName[MenuId] |
Example
NUM_E(3,0) MYNUMB30
MYNUME30= &CHECK_OBJECT('MyPgm.MyWindow.Mycontrol'; 'ENTRY_FIELD')
MYNUME30= &CHECK_OBJECT('MyPgm.MyWindow'; '*WINDOW')
MYNUME30= &CHECK_OBJECT('MyWindow.Mycontrol[MyMenu]'; '*MENU_ITEM')
List of predefined functions by topic