<< Retour au sommaire

 

La fonction DLGSelectItemInList

 

 

 

Table des matières

  1. Présentation ;
  2. Un exemple.

 

Présentation

 

Vous pouvez personnaliser l’affichage d’une liste à l’intérieure d’une fenêtre qui permettra à l’utilisateur de réaliser un choix.

Dans le script ou dans la fonction contenant la définition de la liste, vous devrez écrire les traitements associés à chacun des items de la liste.

 

La syntaxe :

Let MonIndex = DLGSelectItemInList (Les_Items,Le_Titre,Sens,Item_Défaut)

 

Description de la donnée retournée par la fonction DLGSelectItemInListe :

La structure conditionnelle If Then fera très bien l’affaire !

MonIndex peut prendre les valeurs entières suivantes :

2, c’est que l’utilisateur à choisi l’item numéro 2 ;

3, c’est que l’utilisateur à choisi l’item numéro 3, ETC

 

Descriptions des 4 paramètres de la fonction

  1. Le premier paramètre, Les_Items :

Ce premier paramètre est de type chaîne de caractères.

Il contient la liste des Item qui sera contenue dans la boîte de dialogue.

On commence la liste par un guillemet, on sépare les items de la liste par une barre verticale, et on ferme la liste par un guillemet.

La barre verticale est obtenue par le raccourci clavier :

ALT GR +6 du pavé alphanumérique.

Pour les puristes, ce caractère est dit le signe de concaténation.

Par exemple :"Choix 1|Choix 2|Choix 3"

  1. Le deuxième paramètre, Titre_Liste :

Il s’agit d’une chaîne de caractères qui correspond au titre de la boîte de dialogue, c’est donc la barre de titre.

  1. Le troisième paramètre, Sens :

Ici, nous pourrons utiliser les constantes True et False.

False pour « faux », la liste sera affichée dans le sens chronologique de la saisie des items dans le premier paramètre.

True pour « vrai », l’ordre d’affichage des items sera inversé.

 

Remarque :

Vous devez insérer le fichier de déclarations des constantes intégrées au début du fichier source, et ce, par l’intermédiaire de la fonction « Inclue ».

Include "HJCONST.JSH"

 

  1. Le quatrième paramètre, Item_défaut :

Ce paramètre est un entier et il est facultatif.

Il permet de choisir l’item qui sera sélectionné dès l’ouverture de la liste. Pour que la liste sélectionne le troisième item dès l’ouverture de la boîte de dialogue, la valeur du paramètre devra être 3.

 


Un exemple

 

Nous allons écrire le script « AssistantSaisie » et l’assigner au raccourci clavier F12.

 

Dans notre logiciel de messagerie électronique, ce script affichera une fenêtre contenant la liste suivante :

  1. Insérer le bloc coordonnées expéditeur,
  2. Insérer la signature.

 

Et bien sûr après le « DLGSelectItemInList », selon le choix de l’utilisateur, il faudra se mettre au boulot !

En clair, nous allons manipuler la fonction « TypeString »…

 

Voici le code :

Script AssistantSaisie ()

 

; Déclaration de la variable qui contiendra le choix de l'utilisateur

Var Int choix

; Ouverture de la fenêtre

Let choix = DLGSelectItemInList ("Insérer le bloc adresse expéditeur|Insérer la signature","Assistant de saisie",FALSE,2)

; Traitement du choix

If choix==0 Then

 ; L'opération a été annulée

 SayString ("Fermeture de l'assistant de saisie")

ElIf choix==1 Then

 ; Il faut saisir le bloc coordonnées de l'expéditeur

 TypeString ("Mes coordonnées :\n")

 TypeString ("Monsieur Patrick ROLAND\n\n21 Rue du Vieux Moulin\n60000 CHERBOURG.\nTél. 02.21.21.21.21.")

 TypeString ("\nE-Mail : p.roland@asperge.fr")

 SayString ("Insertion du bloc adresse réalisée")

Else

 ; Il faut traiter l'insertion de la signature

 TypeString ("Bien amicalement,\nMonsieur Patrick ROLAND")

 TypeString ("\nE-Mail : p.roland@asperge.fr")

 SayString ("Insertion de la signature réalisée")

EndIf

EndScript

 

Philippe BOULANGER