Le mot-clé
MaFenêtre permet de manipuler la fenêtre courante. Lors de l'exécution de la fenêtre, le mot-clé
MaFenêtre est remplacé par la fenêtre et non par le nom de la fenêtre. Le mot-clé
MaFenêtre s'utilise alors comme une fenêtre.
Intérêt : Le mot-clé MaFenêtre permet de rendre un code local (champ, bouton, ...) ou global (procédure globale, classe, ...) indépendant de la fenêtre en cours.
Versions 16 et supérieures
Nouveauté 16
Versions 17 et supérieures
Nouveauté 17
Versions 18 et supérieures
Nouveauté 18
// Récupération du titre de la fenêtre en cours
TitreFenêtre = MaFenêtre.Titre
Remarques
Manipulation de la fenêtre en cours
- Le mot-clé MaFenêtre est toujours remplacé par la fenêtre en cours. Par exemple, utilisation de la propriété Titre :
MaFenêtre..Titre = "Saisissez vos données"
MonTitreEnCours = MaFenêtre..Titre
// Passage en paramètre :
AppelProcedure(MaFenêtre)
- Si le mot-clé MaFenêtre doit être converti en chaîne, c'est le résultat de la propriété Valeur qui est renvoyé. Pour une fenêtre, la propriété Valeur renvoie le titre de la fenêtre.
Trace(MaFenêtre) // Renvoie le titre de la fenêtre
Exemple à ne pas faire :
ExécuteTraitement(MaFenêtre, trtModification)
Il faut faire :
ExécuteTraitement(MaFenêtre..Nom, trtModification)
- Le mot-clé MaFenêtre peut être utilisé uniquement dans les traitements manipulant la fenêtre en cours (par exemple, dans les traitements associés à un champ, à une fenêtre, ...). Il n'est pas possible d'utiliser le mot-clé MaFenêtre dans un état. Pour désigner l'état en cours dans un état, utilisez le mot-clé MonEtat
- Le mot-clé MaFenêtre ne permet pas d'utiliser les variables globales déclarées dans la fenêtre.
- Pour manipuler un champ d'une fenêtre en utilisant le mot-clé MaFenêtre, il est possible d'utiliser la syntaxe suivante :
Info({MaFenêtre..Nom + ".Bouton2"}..Libellé)
Utilisation de MaFenêtre dans une procédure
Le mot-clé
MaFenêtre peut être utilisé dans une procédure (locale ou globale) uniquement si la procédure manipule la fenêtre en cours. Le mot-clé
MaFenêtre fait alors référence à la fenêtre en cours.
Dans le cas d'une procédure locale, le mot-clé MaFenêtre correspond à la fenêtre à laquelle appartient la procédure.
Fonctions du WLangage et fenêtre en cours
Pour désigner la fenêtre en cours dans les fonctions du WLangage acceptant un nom de fenêtre en paramètre, utilisez :
- soit une chaîne vide,
- soit directement le mot-clé MaFenêtre.
| |
Code où MaFenêtre est utilisé | MaFenêtre correspond |
fenêtre | fenêtre |
champ de fenêtre | fenêtre |
procédure de fenêtre, avec un appel direct depuis un code de la fenêtre | fenêtre |
procédure de fenêtre, avec un appel par <Fenêtre>.<Procédure> | fenêtre |
superchamp de fenêtre | fenêtre |
champ de superchamp de fenêtre | fenêtre |
procédure de superchamp de fenêtre avec un appel direct depuis un code du superchamp | fenêtre |
procédure de superchamp de fenêtre avec un appel par <Superchamp>.<Procédure> | fenêtre |
fenêtre interne | fenêtre |
champ de fenêtre interne | fenêtre |
procédure de fenêtre interne avec un appel direct depuis un code de la fenêtre interne | fenêtre |
procédure de fenêtre interne avec un appel par <FenêtreInterne>.<Procédure> | fenêtre |
superchamp de fenêtre interne | fenêtre |
champ de superchamp de fenêtre interne | fenêtre |
procédure de superchamp de fenêtre interne avec un appel direct depuis un code du superchamp | fenêtre |
procédure de superchamp de fenêtre interne avec un appel par <Superchamp>.<Procédure> | fenêtre |
Le mot-clé
MaFenêtre peut être utilisé uniquement depuis un traitement ou une procédure de la fenêtre.