DialogValueEntry()

Affiche à l'écran un pavé numérique permettant à l'utilisateur de modifier la valeur actuelle d'une variable de type discret, entier ou réel.

Catégorie

autres

Syntaxe

[Result=] DialogValueEntry(ValueTag_Text, LowLimit, HighLimit, UserPrompt_Text);

Paramètres

ValueTag_Text

Nom de la variable de type discret, entier ou réel à modifier. Ceci est une chaîne. Spécifiez le nom de la variable entre guillemets, ou utilisez le<:hs>.champ<:hs>.Name sans les guillemets. Vous pouvez aussi utiliser une variable de type message comme pointeur.

LowLimit

La valeur minimale de la variable. (Doit être supérieure ou égale à la définition de Valeur minimale, Valeur brute minimale ou Minimum UM de la variable, selon les cas).

HighLimit

La valeur maximale de la variable. (Doit être inférieure ou égale à la définition de Valeur maximale, Valeur brute maximale ou Maximum UM de la variable, selon les cas).

UserPrompt_Text

Message utilisateur affiché au-dessus du clavier.

Valeur retour

Renvoie l'une des valeurs entières suivantes<:hs>:

0 = Annuler a été sélectionné.

1 = OK a été sélectionné.

-1 = Valeur maximum<:hs><=<:hs>Valeur minimum.

-2 = Exécution impossible.

-3 = Variable non définie.

-4<:hs>= La variable n'est pas de type discret, entier ou réel.

-5<:hs>= Erreur d'écriture.

Remarques

Cette fonction est principalement utilisée dans les applications comportant des écrans tactiles.

Exemple(s)

Errmsg=DialogValueEntry(MyIntegerTag.Name, MyIntegerTag.MinEU, MyIntegerTag.MaxEU, "Enter a new value...");

Errmsg=DialogValueEntry("MyIntegerTag", -100, 100, "Entrer une nouvelle valeur...");

Par exemple, le script suivant affiche un pavé numérique, permettant de modifier MyIntegerTag en utilisant des limites minimum et maximum égales à -100 et 100 respectivement, tandis que le message «<:hs>Entrer une nouvelle valeur... » apparaît au-dessus du clavier<:hs>:

TagnameX="MyIntegerTag"; {assigner la chaîne MyIntegerTag (qui est en fait la variable à modifier) à la variable de message mémoire TagnameX}

Min=-100; {assigner la valeur minimale autorisée pour la variable à la variable mémoire réel/entier Min}

Max=100; {assigner la valeur minimale autorisée pour la variable à la variable mémoire réel/entier Max}

MessageDisplay="Entrer une nouvelle valeur..."; {assigner la nouvelle chaîne de message à la variable de message mémoire MessageDisplay}

Errmsg=DialogValueEntry(TagnameX, Min, Max, MessageDisplay); {les guillemets ne sont pas nécessaires puisque MessageTagX a été défini en tant que variable Message. Lors de l'assignation d'une variable Discrete, Integer ou Real à TagnameX, la fonction modifie cette variable assignée}

Voir aussi

DialogStringEntry()