AskString$

Aufgabe:

Hierüber können während der Laufzeit des Drucks Informationen vom Anwender abgefragt werden. Ein typisches Anwendungsbeispiel wäre das Projekt eines Überweisungsformulars. Feststehende Angaben wie Name und Bankverbindungen des Absenders lassen sich über festen Text oder Variablen direkt in das Projekt integrieren. Die zu überweisenden Beträge werden sich jedoch von Fall zu Fall unterscheiden und können daher schlecht im Projekt vorgegeben werden. Über die Funktion AskString$() kann jedoch eine solche Information während des Drucks vom Anwender erfragt werden.

Beim Druck erscheint dann eine Dialogabfrage, in der die gewünschte Information einzugeben ist.

Der Dialog erlaubt den eingegebenen Wert entweder zu übernehmen (Button OK) oder die Funktion abzubrechen (Button Abbrechen). Das Abbrechen der Funktion bedeutet, dass der Druckvorgang abgebrochen wird.

Über die Schaltfläche "Alles" können alle noch ausstehenden Benutzereingaben automatisch durch den aktuell eingegebenen Wert beantwortet werden. Dies ist hilfreich, wenn der Dialog für jeden einzelnen Datensatz erscheint, jedoch für alle Datensätze derselbe Wert eingegeben werden soll.

Parameter:

Zeichenkette   Text, der als Eingabeaufforderung in dem Dialog zur Benutzereingabe erscheinen soll. Dieser erste Parameter muss angegeben werden, die übrigen Parameter sind optional. Falls keine weiteren Parameter angegeben werden, ist der erste Parameter zugleich der Vorschlagswert für die Benutzereingabe.

Boolean       (optional) Gibt an, ob die Benutzerabfrage nur einmal zu Beginn des Drucks erscheinen soll (False, Voreinstellung), oder ob die Information für jeden Datensatz individuell abgefragt werden soll (True).

Zeichenkette    (optional) Der Vorschlagswert im Eingabefeld des Dialogs.

Zahl             (optional) Gibt die Anzahl der Stellen an, die als Benutzereingabe zulässig sein soll. Ein Wert von 8 beispielsweise bedeutet, dass der Benutzer maximal 8 Stellen eingeben kann.

Rückgabewert:

Zeichenkette

Beispiele:

AskString$("Betreff",True,"Ihre Anfrage von heute",50)

Öffnet eine Dialogbox mit dem Titel "Überweisungsbetrag", dem vorgeschlagenen Wert "50,00 EUR" und zulässigen Stellenanzahl von 8 Stellen für die Eingabe. Da der zweite Parameter True lautet, erscheint diese Abfrage für jeden Datensatz im Druck.