|
|
|
|
|
|
|
|
|
|
- Caractéristiques de la boîte de dialogue et du champ de saisie
- Saisie de texte multiligne
- Saisie par l'intermédiaire d'une case à cocher
- Base de messages
- Limites
- Exemple de saisie complète
Saisie (Fonction) En anglais : Input Affiche un message en permettant à l'utilisateur de saisir une information.
Remarque : Plusieurs syntaxes sont disponibles pour cette fonction : - Syntaxe simplifiée, saisie directement sous l'éditeur de code.
- Syntaxe complète avec saisie de la question grâce à un assistant. L'éditeur de code propose un assistant complet (option "<Assistant>" proposée par la saisie assistée). Cet assistant permet de définir les différents éléments apparaissant dans le message, et génère automatiquement le code correspondant. Le libellé des boutons est automatiquement proposé en fonction du texte de la question.
- Syntaxe directe, saisie directement sous l'éditeur de code.
NbExemplaire est un entier
RetourValeur est un entier
RetourValeur = Saisie("Combien d'exemplaires voulez-vous imprimer ?", NbExemplaire)
SELON RetourValeur
CAS 0 : Info("Vous avez annulé. Le nombre par défaut est de 1.")
CAS 1 : Info("Vous avez demandé " + NbExemplaire)
FIN
NumTel est une chaîne
Saisie.MasqueSaisie = maskTelFrance
SELON Saisie("Quel est votre numéro de téléphone ?", NumTel)
CAS 1 : SAI_NumTel = NumTel
CAS 0 : SAI_NumTel = "Pas de téléphone"
FIN
Commentaires est une chaîne
Commentaires = Répète(RC, 10)
Saisie.MasqueSaisie = "regexp:.{0,140}"
SELON Saisie("Saisissez vos commentaires.", Commentaires)
CAS 1 : SAI_Comment = Commentaires
CAS 0 : SAI_Comment = "Pas de commentaire"
FIN
AfficherInfo est un booléen = Faux
Saisie.LibelléOptionnel = "Ne plus afficher cette fenêtre"
SI AfficherInfo = Faux ALORS
SELON Saisie("Voulez-vous fermer l'application ?", AfficherInfo)
CAS 1 : Ferme()
FIN
FIN
NumTel est une chaîne
SI Saisie("Quel est votre numéro de téléphone?", NumTel, ...
["Valider", "Pas de téléphone", "Annuler"], 3, 3, dlgIcôneQuestion) = 1 ALORS
Info(NumTel)
FIN
Syntaxe
Syntaxe simplifiée (sans utiliser l'assistant) Masquer les détails
<Résultat> = Saisie(<Question> , <Variable à  saisir>)
<Résultat> : Entier Identifie la réponse sélectionnée par l'utilisateur : - 0 : l'utilisateur a cliqué sur le bouton "Annuler".
- 1 : l'utilisateur a cliqué sur le bouton "OK".
<Question> : Chaîne de caractères Question à poser à l'utilisateur. Cette question peut utiliser la fonction ChaîneConstruit. <Variable à saisir> : Tout type Variable dans laquelle l'utilisateur doit saisir sa réponse. - Cette variable doit avoir été déclarée avant l'appel de la fonction Saisie.
- Le type de la variable définit le type du champ dans lequel l'utilisateur saisit sa réponse. Pour les variables de type Heure ou Date, le masque de saisie est automatiquement déduit de la variable.
- Si la variable est initialisée avec une valeur, cette valeur correspond à la valeur proposée par défaut.
- Après l'utilisation de la fonction Saisie, cette variable contient la réponse de l'utilisateur (quel que soit le bouton utilisé).
Syntaxe complète avec saisie de la question avec l'assistant Masquer les détails
<Résultat> = Saisie(<Question> , <Variable à  saisir> [, <Paramètre 1> [... [, <Paramètre N>]]])
<Résultat> : Entier Identifie la réponse sélectionnée par l'utilisateur (valeur de 1 à le nombre de boutons dans la fenêtre de saisie). Cette réponse dépend du nombre de boutons présents dans la fenêtre de description de la question. Les différentes valeurs correspondant aux différentes réponses sont automatiquement intégrées en commentaires dans l'éditeur de code lors de la sélection du message. <Question> : Chaîne de caractères Question à poser à l'utilisateur. Cette question peut contenir des paramètres identifiés par %1, %2, ... <Variable à saisir> : Tout type Variable dans laquelle l'utilisateur doit saisir sa réponse. - Cette variable doit avoir été déclarée avant l'appel de la fonction Saisie.
- Le type de la variable définit le type du champ dans lequel l'utilisateur saisit sa réponse. Pour les variables de type Heure ou Date, le masque de saisie est automatiquement déduit de la variable.
- Si la variable est initialisée avec une valeur, cette valeur correspond à la valeur proposée par défaut.
- Après l'utilisation de la fonction Saisie, cette variable contient la réponse de l'utilisateur (quel que soit le bouton utilisé).
<Paramètre 1> : Chaîne de caractères Si la question contient des éléments paramétrables (identifiés par %1, %2, ...), ce paramètre permet de donner la valeur voulue. Ainsi <Paramètre 1> remplacera %1. <Paramètre N> : Chaîne de caractères Si le message choisi contient des éléments paramétrables (identifiés par %1, %2, ...), ce paramètre permet de donner la valeur voulue. Ainsi <Paramètre 2> remplacera %2.
Syntaxe directe Masquer les détails
<Résultat> = Saisie(<Question> , <Variable à  saisir> , <Libellés des boutons> [, <Bouton par défaut> [, <Bouton d'annulation> [, <Icône>]]])
<Résultat> : Entier Identifie la réponse sélectionnée par l'utilisateur. Cette réponse dépend du message choisi. <Question> : Chaîne de caractères Question posée à l'utilisateur. <Variable à saisir> : Tout type Variable dans laquelle l'utilisateur doit saisir sa réponse. - Cette variable doit avoir été déclarée avant l'appel de la fonction Saisie.
- Le type de la variable définit le type du champ dans lequel l'utilisateur saisit sa réponse. Pour les variables de type Heure ou Date, le masque de saisie est automatiquement déduit de la variable.
- Si la variable est initialisée avec une valeur, cette valeur correspond à la valeur proposée par défaut.
- Après l'utilisation de la fonction Saisie, cette variable contient la réponse de l'utilisateur (quel que soit le bouton utilisé).
<Libellés des boutons> : Tableau Nom de la variable de type Tableau contenant les libellés des boutons. <Bouton par défaut> : Entier Indice du bouton sélectionné par défaut. Par défaut, ce paramètre vaut 1. <Bouton d'annulation> : Entier Indice du bouton d'annulation. Par défaut, ce paramètre correspond à l'indice du dernier bouton. <Icône> : Chaîne de caractères ou constante de type Entier Icône affichée. Ce paramètre peut correspondre : - au chemin du fichier correspondant à l'icône affichée.
- Ã une des constantes suivantes :
| | | dlgIcôneErreur | Icône représentant une erreur. | | dlgIcôneInfo | Icône représentant une information. | dlgIcôneQuestion
(Valeur par défaut) | Icône représentant une question. |
Remarques Caractéristiques de la boîte de dialogue et du champ de saisie - Le titre de la boîte de dialogue correspond au titre de la fenêtre (ou page) en cours.
- Pour modifier ou définir le titre de la boîte de dialogue, utilisez la fonction TitreSuivant.
- Le gabarit du projet en cours est automatiquement appliqué à la boîte de dialogue.
Saisie de texte multiligne Si le paramètre <Variable à saisir> est initialisé avec une chaîne de caractères contenant des RC, alors la saisie dans le champ associé sera multiligne. Saisie par l'intermédiaire d'une case à cocher Si la variable est de type booléen, dans ce cas, la saisie est réalisée dans une case à cocher. Le libellé de la case à cocher est déterminé grâce à la variable Saisie.LibelléOptionnel. Base de messages Lors de la création d'un message, ce message est automatiquement ajouté à la base de messages. Par défaut, la base de messages est présente dans le répertoire "Personal\Message" de WINDEV, WEBDEV et WINDEV Mobile. Ce répertoire peut être modifié dans les options de WINDEV/WEBDEV/WINDEV Mobile : - Sous le volet "Accueil", dans le groupe "Environnement", déroulez "Options" et sélectionnez "Options générales de WINDEV/WEBDEV/WINDEV Mobile".
- Affichez l'onglet "Répertoire".
Exemple de saisie complète - Saisie de la question sous l'éditeur :
- Code généré automatiquement (seule la variable "Destinataire" a été saisie sous l'éditeur de code) :
Destinataire est une chaîne
SELON Saisie("Vous devez indiquer un destinataire.", Destinataire)
CAS 1
CAS 2
CAS 3
FIN
Classification Métier / UI : Code UI Composante : wd300obj.dll
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|