PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Votre version : XXA150056M

  • Prise de focus
  • EcranPremier, DonneFocus et RepriseSaisie
  • DonneFocus sur une colonne (champ Table)
  • DonneFocus sur le champ en cours
  • Traitements exécutés lors de l'utilisation de la fonction DonneFocus
WinDevWebDev - Code ServeurWebDev - Code NavigateurWinDev MobileEtats et RequêtesWindowsLinuxWindows MobileWindows PhoneWindows Store appsAndroidWidget AndroidiPhone/iPadJavaPHPAjaxCode Utilisateur (MCU)Langage ExterneHFSQLHFSQL Client/ServeurProcédures stockéesHyper File 5.5OLE DBODBCAccès Natifs
DonneFocus (Fonction)
En anglais : SetFocus

Donne le focus :
  • à un champ (d'une fenêtre, d'une page ou d'un frameset).
  • à une fenêtre.
Versions 15 et supérieures
WinDev MobileAndroid Cette fonction est désormais disponible pour les applications Android.
Nouveauté 15
WinDev MobileAndroid Cette fonction est désormais disponible pour les applications Android.
WinDev MobileAndroid Cette fonction est désormais disponible pour les applications Android.
Versions 16 et supérieures
WinDev MobileWindows Phone Cette fonction est désormais disponible pour les applications Windows Phone.
Nouveauté 16
WinDev MobileWindows Phone Cette fonction est désormais disponible pour les applications Windows Phone.
WinDev MobileWindows Phone Cette fonction est désormais disponible pour les applications Windows Phone.
Versions 17 et supérieures
WinDev MobileiPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 17
WinDev MobileiPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
WinDev MobileiPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
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 la zone répétée ZR_Client.
// Sélection de la 2° 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> : Chaîne de caractères optionnelle (avec ou sans guillemets)
Nom du champ (ou de la colonne) auquel le focus doit être donné (voir Notes). 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.

Android Il n'est pas possible de donner le focus à un champ Image.

WinDev MobileWindows MobileWindows PhoneAndroidiPhone/iPad

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

DonneFocus([<Nom de la fenêtre>])
<Nom de la fenêtre> : Chaîne de caractères optionnelle (avec ou sans guillemets)
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).

EcranPremier, DonneFocus et RepriseSaisie

Ces fonctions ont un comportement très différent :
  • La fonction RepriseSaisie 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.
WinDev MobileWindows Mobile

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.
WinDev MobileWindows MobileWindows PhoneAndroidiPhone/iPad

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.
WinDev MobileWindows MobileWindows PhoneAndroidiPhone/iPad

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 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 traitements de ce champ.

Composantes
Windows Mobile wp200obj.dll
Android wd200android.jar
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire