DialogValueEntry (Funktion)

Zeigt ein Zahlentastaturfeld auf dem Bildschirm an, über das der Bediener den Wert einer Binär-, Integer- oder Real-Variablen ändern kann.

Kategorie

Sonstige

Syntax

[Ergebnis=]DialogValueEntry(WertVariable_Text, Untergrenze, Obergrenze, Eingabeaufforderung);

Parameter

WertVariable_Text

Der Name der zu ändernden Binär-, Integer- oder Real-Variablen. Der Name muss als Zeichenfolge übergeben werden. Schreiben Sie den Variablennamen in Anführungszeichen, oder verwenden Sie da Punktfeld ohne Anführungszeichen. Sie können in diesem Ausdruck auch eine Binärvariable verwenden.

Untergrenze

Der niedrigste Variablenwert. (Dieser sollte entsprechend der Variablendefinition = der Werte Min. Wert, Min. Ext bzw. Min. EU sein.)

Obergrenze

Der höchste Variablenwert. (Dieser sollte entsprechend der Variablendefinition = der Werte Max. Wert, Max. Ext bzw. Max. EU sein.)

Eingabeaufforderung

Die Meldung, die dem Bediener im oberen Teil der Tastatur angezeigt wird.

Rückgabewert

Gibt einen der folgenden Integer-Werte zurück:

0 = Abbrechen wurde aktiviert.

1 = OK wurde aktiviert.

-1 = Obergrenze<=Untergrenze

-2 = Konnte nicht initialisiert werden.

-3 = Variable nicht definiert.

-4 = Variable ist nicht vom Typ "Binär", "Integer" oder "Real".

-5 = Konnte nicht geschrieben werden.

Anmerkungen

Diese Funktion wird vorwiegend in Touchscreen-Projekten verwendet.

Beispiel(e)

FehlerMldg=DialogValueEntry(MeineIntegerVariable.Name, MeineIntegerVariable.MinEU, MeineIntegerVariable.MaxEU, "Neuen Wert eingeben...");

FehlerMldg=DialogValueEntry("MeineIntegerVariable", -100, 100, "Neuen Wert eingeben...");

Mit dem nachstehenden Skript wird eine Zahlentastatur aufgerufen, mit der Sie die Variable MeineIntegerVariable mit den Mindest- und Höchstwerten -100 bzw. 100 ändern können, während die Meldung "Neuen Wert eingeben..." über der Tastatur angezeigt wird.

VariableX="MeineIntegerVariable"; {Zeichenfolge "MeineIntegerVariable" (die zu ändernde Variable) der Meldungsvariablen VariableX zuweisen}

Min=-100; {zulässigen Mindestwert der Integer-Variablen "Min" zuweisen}

Max=100; {zulässigen Höchstwert der Integer-Variablen "Max" zuweisen}

Eingabeaufforderung="Neuen Wert eingeben..."; {die neue Meldungszeichenfolge der Meldungsvariablen "Eingabeaufforderung" zuweisen}

FehlerMldg=DialogValueEntry(VariableX, Min, Max, MeldungAnzeige); {Anführungszeichen sind nicht erforderlich, da VariableX als Meldungsvariable definiert wurde. Durch Zuweisung einer Variablen vom Typ "Binär", "Integer" oder "Real" zu VariableX ändert die Funktion diese zugewiesene Variable }

Siehe auch

DialogStringEntry()