Fonction DonneFocusEtRetourUtilisateur sur une fenêtre

Si le paramètre <Elément à manipuler> correspond à un nom de fenêtre, la fenêtre est activée. Le champ prenant le focus dans cette fenêtre correspondra :

• soit au dernier champ précédemment en saisie dans cette fenêtre,
• soit au premier champ pouvant prendre le focus dans cette fenêtre (si aucune saisie n'a été effectuée précédemment dans cette fenêtre).

Fonction DonneFocusEtRetourUtilisateur sur une colonne d'un champ Table

La fonction DonneFocusEtRetourUtilisateur donne le focus à la colonne spécifiée. Si le champ Table n'est pas en cours de saisie, le champ Table passe en saisie.

Fonction DonneFocusEtRetourUtilisateur sur le champ en cours

La fonction DonneFocusEtRetourUtilisateur utilisée sans paramètre permet de donner le focus au champ en cours. Cette fonction, utilisée par exemple dans le code de sortie d'un champ de saisie, permet de forcer la saisie dans le champ en cours si les informations saisies ne correspondent pas aux informations attendues.

Fonction DonneFocusEtRetourUtilisateur sur le dernier champ en cours

La fonction DonneFocusEtRetourUtilisateur utilisée sans paramètre permet de donner le focus au dernier champ en cours. Cette fonction, utilisée par exemple dans le code de sortie d'un champ de saisie, permet de forcer la saisie dans le champ en cours si les informations saisies ne correspondent pas aux informations attendues.

• Champ de saisie.
• Champ Interrupteur.
• Champ Sélecteur.
• Champ Liste.
• Champ Combo.
• Champ Image de type "Zone de cliquage".

• sous l'éditeur de code, utilisez la combinaison de touches Maj + F1.
• par programmation, utilisez la propriété Alias.

Evénements/traitements exécutés lors de l'utilisation de la fonction DonneFocusEtRetourUtilisateur

Le code WLangage qui suit l'appel à la fonction DonneFocusEtRetourUtilisateur n'est pas exécuté et l'utilisateur reprend la main.

• si l'appel de la fonction DonneFocusEtRetourUtilisateur est fait dans un code appelé par la fonction Exécute, ExécuteCode ou ExécuteTraitement, le code appelé par la fonction Exécute, ExécuteCode ou ExécuteTraitement est interrompu. L'exécution reprend après l'appel de la fonction Exécute, ExécuteCode ou ExécuteTraitement.
• si l'appel de la fonction DonneFocusEtRetourUtilisateur est fait dans le code d'une fonction d'une autre fenêtre que la fenêtre courante, le code de cette fonction est interrompu et l'exécution reprend après son l'appel.
• si l'appel de la fonction DonneFocusEtRetourUtilisateur est fait dans un code d'un composant (procédure ou méthode), le code du composant est interrompu et l'exécution reprend après l'appel de la procédure ou de la méthode du composant.
• si l'appel de la fonction DonneFocusEtRetourUtilisateur est fait dans un code d'une procédure de fenêtre interne, le code de la procédure de la fenêtre interne est interrompu et l'exécution reprend après l'appel de la procédure de la fenêtre interne.
• si l'appel de la fonction DonneFocusEtRetourUtilisateur est fait dans le code d'une option de menu, le code de l'option de menu est interrompu et l'exécution reprend après l'appel de l'option de menu.
• si l'appel de la fonction DonneFocusEtRetourUtilisateur est fait dans une procédure de fenêtre appelée depuis un superchamp, le code de la procédure est interrompu et l'exécution reprend après l'appel de la procédure dans le superchamp.
• si l'appel de la fonction DonneFocusEtRetourUtilisateur est fait dans une procédure d'un superchamp ou d'un modèle de champs, le code de la procédure est interrompu et l'exécution reprend après l'appel de la procédure du superchamp ou du modèle de champs.

• Aucun code n'est exécuté si <Elément à manipuler> est le champ en cours.
• Le code de sortie du champ en cours n'est pas exécuté si la fonction DonneFocusEtRetourUtilisateur est utilisée dans un des événements de ce champ.

Fonction DonneFocusEtRetourUtilisateur et FIN:

Après un appel à la fonction DonneFocusEtRetourUtilisateur, le code suivant l'instruction "FIN:" n'est pas exécuté. La fonction DonneFocusEtRetourUtilisateur peut être remplacée par l'appel à la fonction EcranPremier suivie de RETOUR ou RENVOYER.