VADELIA |
||||
(I/B) |
Attention : cette fonction n'est utilisable que dans une partie client Windows.
Description
Permet de récupérer le nom statique, ou des éléments du nom statique de l'objet graphique désigné par une variable de type OBJET_GRAPHIQUE.
Syntaxe
Résultat = &NOM_OBJET(VarObjGraphique;CsteSelection)
Paramètres
Définition |
Contenu |
Contrôles |
|
Résultat |
Variable ALPHA. |
Nom plus ou moins qualifié de l'objet. |
|
Variable Objet graphique |
Variable de type OBJET_GRAPHIQUE. |
Contrôle, Fenêtre ou Menu recherché. |
Paramètre obligatoire. |
Constante de sélection |
Constante ALPHA. |
*TOUT |
Paramètre obligatoire. |
Constantes de sélection possibles :
Niveau de détail |
Valeur |
*TOUT |
Nom totalement qualifié de l'objet graphique désigné par VarObjGraphique. |
*PGM |
Nom du programme de l'objet graphique désigné par VarObjGraphique. |
*FEN |
Nom de la fenêtre de l'objet graphique désigné par VarObjGraphique. |
*OBJ |
Nom de l'objet graphique désigné par VarObjGraphique. |
*MENU |
Nom de l'item de menu désigné par VarObjGraphique. |
Remarques :
Le format de la chaîne d'un nom totalement qualifié est celui présenté pour la fonction &RECUPERER_OBJET.
Pour une variable OBJET_GRAPHIQUE de type *FENETRE, la fonction &NOM_OBJET renvoie la même valeur pour *FEN et *OBJ.
Pour une variable OBJET_GRAPHIQUE de type *ITEM_MENU de fenêtre, la fonction &NOM_OBJET renvoie la même valeur pour *FEN et *OBJ.
Si VarObjGraphique équivaut à *OBJET_NULL, la fonction renvoie *BLANK.
Par exemple
ALPHA(200) MonALPHA200
OBJET_GRAPHIQUE(CHAMP_DE_SAISIE) MonObjetGraphiqueChamp
OBJET_GRAPHIQUE(*FENETRE) MonObjetGraphiqueFenetre
OBJET_GRAPHIQUE(*ITEM_MENU) MonObjetGraphiqueItemMenu
MonALPHA200= &NOM_OBJET(MonObjetGraphiqueChamp; '*TOUT')
* la fonction renvoie dans MonALPHA200 : 'MONPGM.MAFENETRE.CHS_01')
MonALPHA200= &NOM_OBJET(MonObjetGraphiqueChamp; '*PGM')
* la fonction renvoie dans MonALPHA200 : 'MONPGM')
MonALPHA200= &NOM_OBJET(MonObjetGraphiqueChamp; '*FEN')
* la fonction renvoie dans MonALPHA200 : 'MAFENETRE')
MonALPHA200= &NOM_OBJET(MonObjetGraphiqueChamp; '*OBJ')
* la fonction renvoie dans MonALPHA200 : 'CHS_01')
MonALPHA200= &NOM_OBJET(MonObjetGraphiqueChamp; '*MENU')
* la fonction renvoie dans MonALPHA200 : rien (*BLANK)
MonALPHA200= &NOM_OBJET(MonObjetGraphiqueFenetre; '*TOUT')
* la fonction renvoie dans MonALPHA200 : 'MONPGM.MAFENETRE')
MonALPHA200= &NOM_OBJET(MonObjetGraphiqueItemMenu; '*TOUT')
* la fonction renvoie dans MonALPHA200 : 'MONPGM.MAFENETRE.MONOBJET[IDS_MODIFIER]')
MonALPHA200= &NOM_OBJET(MonObjetGraphiqueItemMenu; '*MENU')
* la fonction renvoie dans MonALPHA200 : 'IDS_MODIFIER'
Liste des fonctions prédéfinies par thème