VADELIA |
||||
(I/B) |
Attention : cette fonction n'est utilisable que dans une partie client Windows.
Description
Renvoie la variable objet graphique dont le nom statique est passé en paramètre. Ce nom statique peut être plus ou moins qualifié.
Syntaxe
Résultat = &RECUPERER_OBJET(Nom_Statique)
Paramètres
Définition |
Contenu |
Contrôles |
|
Résultat |
Variable de type OBJET_GRAPHIQUE. |
Objet graphique recherché (contrôle, fenêtre, menu). |
|
Nom statique |
Constante ou variable ALPHA. |
Contient le nom statique plus ou moins qualifié de l'objet à rechercher. |
Paramètre obligatoire. |
Syntaxes possibles du nom statique :
Type d'objet |
Syntaxe 1 |
Syntaxe 2 |
Syntaxe 3 |
Objet |
NomPgm.NomFen.NomObjet |
NomFen.NomObjet |
NomObjet |
Fenêtre |
NomPgm.NomFen.NomFen |
NomFen.NomFen |
NomFen |
ItemMenuFen |
NomPgm.NomFen.NomFen[IdMenu] |
NomFen.NomFen[IdMenu] |
NomFen[IdMenu] |
ItemMenuObj |
NomPgm.NomFen.NomObjet[EvtMenu] |
NomFen.NomObjet[IdMenu] |
NomObjet[IdMenu] |
Remarques :
NomPgm est le nom court d'un programme.
Lorsque le nom statique de l'objet n'est pas totalement qualifié, la génération du programme a la charge de le compléter avec les informations du contexte courant (programme courant, fenêtre courante et type de l'objet graphique cible). Dans le cas général, si la phase de génération n'est pas capable de compléter les informations à l'aide du contexte courant afin de définir un nom d'objet totalement qualifié, la fonction renvoie *OBJET_NULL.
- Si le générateur n'est pas capable de définir le type de l'objet attendu (ex : &RECUPERER_OBJET() = &RECUPERER_OBJET()), la fonction renvoie :
. le handle de l'objet si le nom est totalement qualifié,
. *OBJET_NULL sinon.
- Si le nom n'est pas totalement qualifié, mais le type attendu est *FENETRE, la fonction renvoie le handle de la fenêtre correspondant au nom.
- Si le nom est totalement qualifié, mais le type de l'objet ne correspond pas au type attendu, la fonction renvoie *OBJET_NULL. Ceci permet d'éviter d'affecter un objet non compatible à une variable OBJET_GRAPHIQUE.
Lorsque l'objet désigné n'est pas identifiable (nom partiellement qualifié + informations) ou inexistant, la valeur retournée par la fonction est *OBJET_NULL. Pour déterminer la raison qui amène au résultat *OBJET_NULL, il faut utiliser la fonction &CONTROLE_OBJET.
Par exemple
OBJET_GRAPHIQUE(LISTE_VALEURS) VarObjCbx
VarObjCbx = &RECUPERER_OBJET('IDCB_LSTVALEUR')
VarObjCbx = &RECUPERER_OBJET('ID_FEN1.IDCB_LSTVALEUR')
VarObjCbx = &RECUPERER_OBJET('PGESVAL.ID_FEN1.IDCB_LSTVALEUR')
Liste des fonctions prédéfinies par thème