VADELIA |
||||
(I/B) |
Note: This function can only be used in Windows client parts.
Description
Retrieves the static name - or parts of the static name - of the graphic object described by a GRAPHIC_OBJECT variable.
Syntax
Result = &OBJECT_NAME(GraphicObjectVar;SelectionCst)
Parameters
Definition |
Content |
Controls |
|
Result |
ALPHA variable. |
Partially- or fully-qualified name of the object. |
|
Graphic object variable |
GRAPHIC_OBJECT variable. |
Control, Window or Menu being searched for. |
Mandatory parameter. |
Selection constant |
ALPHA constant. |
*ALL |
Mandatory parameter. |
Possible selection constants:
Detail level: |
Value |
*ALL |
Fully-qualified name of the graphic object described by GraphicObjectVar. |
*PGM |
Name of the program containing the graphic object described by GraphicObjectVar. |
*WIN |
Name of the window containing the graphic object described by GraphicObjectVar. |
*OBJ |
Name of the graphic object described by GraphicObjectVar. |
*MENU |
Name of the menu item described by GraphicObjectVar. |
Notes:
The format of the string representing a fully-qualified name is as described for the &GET_OBJECT function.
With *WINDOW type GRAPHIC_OBJECT variables, the &OBJECT_NAME function returns the same value for *WIN and *OBJ.
With window *MENU_ITEM type GRAPHIC_OBJECT variables, the &OBJECT_NAME function returns the same value for *WIN and *OBJ.
If GraphicObjectVar is *NULL_OBJECT, the function returns *BLANK.
Example
ALPHA(200) MyALPHA200
GRAPHIC_OBJECT(ENTRY_FIELD) MyFieldGraphicObject
GRAPHIC_OBJECT(*WINDOW) MyWindowGraphicObject
GRAPHIC_OBJECT(*MENU_ITEM) MyMenuItemGraphicObject
MyALPHA200= &OBJECT_NAME(MyFieldGraphicObject; '*ALL')
* the function returns the following in MyALPHA200: 'MYPGM.MYWINDOW.EF_01')
MyALPHA200= &OBJECT_NAME(MyFieldGraphicObject; '*PGM')
* the function returns the following in MyALPHA200: 'MYPGM')
MyALPHA200= &OBJECT_NAME(MyFieldGraphicObject; '*WIN')
* the function returns the following in MyALPHA200: 'MYWINDOW')
MyALPHA200= &OBJECT_NAME(MyFieldGraphicObject; '*OBJ')
* the function returns the following in MyALPHA200: 'CHS_01')
MyALPHA200= &OBJECT_NAME(MyFieldGraphicObject; '*MENU')
* the function returns the following in MyALPHA200: nothing (*BLANK)
MyALPHA200= &OBJECT_NAME(MyWindowGraphicObject; '*ALL')
* the function returns the following in MyALPHA200: 'MYPGM.MYWINDOW')
MyALPHA200= &OBJECT_NAME(MyMenuItemGraphicObject; '*ALL')
* the function returns the following in MyALPHA200: 'MYPGM.MYWINDOW.MYOBJECT[OPTION_MODIFY]')
MyALPHA200= &OBJECT_NAME(MyMenuItemGraphicObject; '*MENU')
* the function returns the following in MyALPHA200: 'OPTION_MODIFY'
List of predefined functions by topic