DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions de gestion des champs
  • Prise de focus
  • Fonctions EcranPremier, DonneFocus et DonneFocusEtRetourUtilisateur
  • Fonction DonneFocus sur une colonne (champ Table)
  • Fonction DonneFocus sur le champ en cours
  • Fonction DonneFocus sur le dernier champ en cours
  • Traitements exécutés lors de l'utilisation de la fonction DonneFocus
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Donne le focus :
  • à un champ (d'une fenêtre, d'une page ou d'un frameset).
  • à une fenêtre.
Exemple
// Donne le focus au champ SAI_Saisie1
DonneFocus(SAI_Saisie1)
// Donne le focus au champ SAI_Saisie1 de
// la page/fenêtre "Inscription"
DonneFocus(Inscription.SAI_Saisie1)
// Donne le focus au champ MonChamp
// présent dans le champ Zone répétée ZR_Client.
// Sélection de la seconde répétition
ZR_Client = 2
DonneFocus(ZR_Client.MonChamp)
Syntaxe

Donner le focus à un champ de la fenêtre ou de la page en cours Masquer les détails

DonneFocus([<Nom du champ>])
<Nom du champ> : Nom de champ optionnel
Nom du champ (ou de la colonne) auquel le focus doit être donné (voir "Remarques"). Si ce paramètre n'est pas spécifié, le focus est donné au champ en cours.
Si <Nom du champ> ne correspond pas à un champ existant dans la fenêtre ou la page en cours, une erreur du WLangage est affichée.
AndroidJava Il n'est pas possible de donner le focus à un champ Image.
WEBDEV - Code Navigateur Nom du champ auquel le focus doit être donné (voir "Remarques"). Si ce paramètre n'est pas spécifié, une erreur de compilation apparaît. Si ce paramètre est une chaîne construite (par exemple : "Champ" + sNumChamp), aucune vérification de l'existence du champ n'est effectuée (si le champ spécifié n'existe pas, une erreur Javascript apparaîtra dans le navigateur).
WEBDEV - Code Navigateur

Donner le focus à un champ d'une page du frameset en cours (Internet Explorer uniquement) Masquer les détails

DonneFocus([<Champ de la page>])
<Champ de la page> : Chaîne de caractères
Nom du champ de la page auquel le focus doit être donné. Ce paramètre est de la forme :
<Nom de page>.<Nom de champ>
où :
  • <Nom de page> correspond au nom de la page contenant le champ auquel le focus doit être donné.
  • <Nom de champ> correspond au nom du champ auquel le focus doit être donné. Si ce paramètre est une chaîne construite (par exemple : "Champ" + sNumChamp), aucune vérification de l'existence du champ n'est effectuée (si le champ spécifié n'existe pas, une erreur Javascript apparaîtra dans le navigateur).
WINDEVEtats et RequêtesAndroidiPhone/iPadWidget IOSMac CatalystJavaCode Utilisateur (MCU)

Donner le focus à une fenêtre Masquer les détails

DonneFocus([<Fenêtre>])
<Fenêtre> : Nom de fenêtre optionnel
Nom de la fenêtre auquel le focus doit être donné. Cette fenêtre sera activée et 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).
Si ce paramètre n'est pas spécifié, le focus est donné au champ en cours.
Remarques

Prise de focus

La possession du "focus" est matérialisée de différentes manières :
  • Curseur clignotant (ou "Caret") pour les champs de saisie.
  • Rectangle pointillé pour les autres types de champs (boutons, listes, sélecteurs, ...).
Attention : Tous les types de champs ne peuvent pas prendre le focus (champs de type "libellé" par exemple).

Fonctions EcranPremier, DonneFocus et DonneFocusEtRetourUtilisateur

Ces fonctions ont un comportement très différent :
  • La fonction DonneFocusEtRetourUtilisateur arrête le traitement en cours pour forcer la reprise de la saisie dans le champ indiqué.
  • La fonction EcranPremier décrit quel sera le prochain champ ayant la saisie (lorsque le code en cours s'arrêtera et que la saisie reprendra).
  • La fonction DonneFocus arrête le traitement en cours, décrit quel sera le prochain champ ayant la saisie et reprend le traitement en cours.
WINDEVEtats et RequêtesJavaCode Utilisateur (MCU)

Fonction DonneFocus sur une colonne (champ Table)

La fonction DonneFocus 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.
WINDEVEtats et RequêtesAndroidiPhone/iPadWidget IOSMac CatalystJavaCode Utilisateur (MCU)

Fonction DonneFocus sur le champ en cours

La fonction DonneFocus 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.
Windows

Fonction DonneFocus sur le dernier champ en cours

La fonction DonneFocus 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.
Le champ doit être de type :
  • champ de saisie.
  • champ Interrupteur.
  • champ Sélecteur.
  • champ Liste.
  • champ Combo.
  • champ Zone de cliquage.
WINDEVEtats et RequêtesAndroidiPhone/iPadWidget IOSMac CatalystJavaCode Utilisateur (MCU)

Traitements exécutés lors de l'utilisation de la fonction DonneFocus

En règle générale, les traitements de sortie (du champ ou de la fenêtre en cours) et d'entrée (dans le champ ou la fenêtre spécifié) sont exécutés lors de l'appel de la fonction DonneFocus.
Exceptions :
  • Aucun code n'est exécuté si <Nom du champ> est le champ en cours.
  • Le code de sortie du champ en cours n'est pas exécuté si la fonction DonneFocus est utilisée dans un des événements WLangage associés à ce champ.
Classification Métier / UI : Code UI
Composante : wd290obj.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale