DialogStringEntry (Funktion)

Zeigt eine alphanumerische Tastatur auf dem Bildschirm an, mit der der Bediener den aktuellen Wert einer Meldungsvariablen ändern kann.

Kategorie

Sonstige

Syntax

[Ergebnis=]DialogStringEntry(Meldungsvar_Text, Eingabeaufforderung);

Parameter

Meldungsvar_Text

Der Name der zu ändernden Meldungsvariablen. 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.

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 = Interner Fehler.

-2 = Konnte nicht initialisiert werden.

-3 = Variable nicht definiert.

-4 = Variable ist nicht vom Typ "Meldung".

-5 = Kann nicht geschrieben werden.

Anmerkungen

Diese Funktion wird vorwiegend in Touchscreen-Projekten verwendet.

Beispiel

FehlerMldg=DialogStringEntry(MeineMeldungsVariable.Name, "Neue Zeichenfolge eingeben...");

FehlerMldg=DialogStringEntry("MeineMeldungsVariable","Neue Zeichenfolge eingeben...");

Mit dem nachstehenden Skript wird eine alphanumerische Tastatur aufgerufen, mit der Sie die Variable "MeineMeldungsVariable" ändern können, während die Meldung "Neuen Text eingeben..." über der Tastatur angezeigt wird.

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

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

FehlerMldg=DialogStringEntry(MeldungsVariableX, Eingabeaufforderung); {Anführungszeichen sind nicht erforderlich, da MeldungsVariableX als Meldungsvariable definiert wurde}

Siehe auch

DialogValueEntry()