4D v16.3

Demander

Accueil

 
4D v16.3
Demander

Demander 


 

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

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 désactivation 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.

La ligne de code :

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

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

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 :

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 :



Voir aussi  

ALERTE
CONFIRMER

 
PROPRIÉTÉS 

Produit : 4D
Thème : Messages
Numéro : 163
Nom intl. : Request

Cette commande modifie la variable système OKCommande(s) éligible(s) à l'exécution dans un process préemptif

 
HISTORIQUE 

Modifié : 4D v6

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v16)
4D - Langage ( 4D v16.1)
4D - Langage ( 4D v16.2)
4D - Langage ( 4D v16.3)