4D Doc Center : Demander

4D v14.3

Demander


Demander ( message {; réponseDéfaut {; titreBoutonOK {; titreBoutonAnn}}} ) -> Résultat

Paramètre	Type	Description
message	Chaîne	Message à afficher dans la boîte de dialogue
réponseDéfaut	Chaîne	Valeur par défaut dans la zone de saisie de texte
titreBoutonOK	Chaîne	Libellé du bouton OK
titreBoutonAnn	Chaîne	Libellé du bouton Annuler
Résultat	Chaîne	Valeur saisie par l'utilisateur

Description

La fonction Demander affiche une boîte de dialogue de demande d'informations composée d'un message, d'une zone de saisie de texte, d'un bouton OK et d'un bouton Annuler.

Vous passez le message à afficher dans le paramètre message. Si la taille du message excède les capacités de la zone d'affichage (aux alentours de 50 caractères, variant en fonction du Système et de la police utilisée), il peut apparaître tronqué.

Par défaut, le libellé du bouton OK est “OK” et celui du bouton Annuler est “Annuler”. Si vous voulez modifier ces libellés, passez d'autres valeurs dans les paramètres optionnels titreBoutonOK et titreBoutonAnn. Si nécessaire, les boutons sont agrandis vers la gauche, en fonction de la taille des libellés que vous avez saisis.

Le bouton OK est le bouton par défaut. L'utilisateur peut cliquer sur le bouton OK ou appuyer sur la touche Entrée pour valider la boîte de dialogue, mettant ainsi la variable système OK à 1. Il peut également cliquer sur le bouton Annuler pour annuler la boîte de dialogue, mettant ainsi la variable système OK à 0.

L'utilisateur peut taper des caractères dans la zone de saisie de texte. Pour définir une valeur par défaut, passez le texte par défaut dans le paramètre réponseDéfaut. Si l'utilisateur clique sur le bouton OK, Demander retourne le texte. Si l'utilisateur clique sur le bouton Annuler, Demander retourne une chaîne vide (""). Si la réponse doit être une valeur numérique ou une date, convertissez la chaîne retournée par Demander dans le type souhaité à l'aide des fonctions Num et Date.

Note : N'appelez pas la fonction Demander dans une méthode formulaire ou objet qui gère l'événement Sur activation ou Sur desactivation car cela provoquerait une boucle sans fin.

Conseil : Si vous voulez récupérer plusieurs informations de l'utilisateur, construisez un formulaire approprié et appelez-le avec la commande DIALOGUE, plutôt que d'afficher une succession de boîtes de dialogue du type Demander.

Exemple 1

La ligne de code :

$vsAffiche :=Demander("Veuillez saisir votre nom :")

... provoquera l'affichage de la boîte de dialogue suivante :

Exemple 2

Le code suivant :

 $vsAffiche:=Demander("Nom de l'employé :";"";"Créer un enregistrement";"Annuler")

 Si(OK=1)

    AJOUTER ENREGISTREMENT([Employés])

  ` Note : $vsAffiche est alors copiée dans le champ [Employés]Nom

  ` lors de l'événement formulaire Sur chargement de la méthode formulaire

 Fin de si

... provoquera l'affichage de la boîte de dialogue suivante :

Exemple 3

La ligne de code :

$vdAffiche:=Date(Demander("Veuillez saisir la nouvelle date :";Chaine(Date du jour)))

... provoquera l'affichage de la boîte de dialogue suivante :