DIALOGUE

version 5

DIALOGUE ({table; }formulaire)

Paramètre	Type		Description
table	Table		Table à laquelle appartient le formulaire ou
			Table par défaut si ce paramètre est omis
formulaire	Formulaire		Formulaire à afficher comme dialogue

La commande DIALOGUE présente le formulaire à l'utilisateur. Cette commande est souvent utilisée pour récupérer dans des variables des données fournies par l'utilisateur, ou pour lui présenter différentes informations, comme un choix d'options pour effectuer une opération.

Il est courant d'afficher le formulaire dans une fenêtre modale créée à l'aide de la commande Creer fenetre.

Voici un exemple typique de boîte de dialogue pouvant être affichée avec la commande DIALOGUE :

Dans ce type de boîte de dialogue, la saisie de valeurs ne peut s'effectuer que par l'intermédiaire de variables. Des champs peuvent être affichés avec leurs valeurs courantes mais ils ne sont pas saisissables.

Astuce : Vous pouvez simuler l'affichage d'une boîte de dialogue avec la commande AJOUTER ENREGISTREMENT, si vous souhaitez bénéficier des possibilités issues de la saisie de données dans des champs. Dans ce cas, lorsque le formulaire est validé, un enregistrement est créé dans la table.

Astuce : A l'inverse, il est possible de créer ou de modifier des valeurs dans les enregistrements par l'intermédiaire de la commande DIALOGUE. Dans ce cas, c'est à vous de créer et de sauvegarder par programmation les enregistrements. DIALOGUE ne manipule pas les enregistrements.

Utilisez DIALOGUE plutôt que CONFIRMER, ALERTE ou Demander lorsque les informations à afficher ou à recueillir sont plus complexes que celles que peuvent gérer ces trois autres commandes.

A la différence d'AJOUTER ENREGISTREMENT et de MODIFIER ENREGISTREMENT, DIALOGUE n'utilise pas le formulaire entrée courant. Vous devez spécifier, dans le paramètre formulaire, le formulaire à utiliser. De même, aucun ensemble de boutons n'est placé par défaut s'ils sont omis dans le formulaire. Seuls des boutons OK et Annuler sont créés automatiquement. Ils sont supprimés si le formulaire contient des boutons personnalisés.

Le dialogue est validé si l'utilisateur clique sur le bouton de validation ou appuie sur la touche Entrée, ou si la commande VALIDER est exécutée.

Le dialogue est annulé si l'utilisateur clique sur le bouton d'annulation, appuie sur les touches d'annulation (Echap sous Windows, Esc sous MacOS), ou si la commande NE PAS VALIDER est exécutée.

Après un appel à DIALOGUE, la variable système OK prend la valeur 1 si le dialogue est validé, et 0 sinon.

L'exemple suivant illustre l'utilisation de la commande DIALOGUE pour spécifier des critères de recherche. Un formulaire personnalisé contenant les variables vNom et vPays permet à l'utilisateur de saisir ses critères :

   Creer fenetre (10; 40; 370; 220) ` Créer une fenêtre modale 
   DIALOGUE ([Société]; "Form Recherche") ` Afficher le dialogue de recherche 
   FERMER FENETRE ` Nous n'avons plus besoin de la fenêtre 
   Si (OK = 1) ` Si le dialogue est validé 
      CHERCHER ([Société]; [Société]Nom = vNom; *) 
      CHERCHER (& [Société]Payst = vPays) 
   Fin de si 

Si l'utilisateur valide le dialogue, la variable système OK prend la valeur 1, si le dialogue est annulé OK prend la valeur 0.

AJOUTER ENREGISTREMENT, Creer fenetre, NE PAS VALIDER, VALIDER.