Version 6.0 Geändert
Request (Fragetext{; Wert{; OKTitel{; AbbrechenTitel}}}) String
Parameter | Typ | Beschreibung | |
Fragetext | String | Text der Frage | |
Wert | String | Vorgeschlagener Wert im Dialogfeld | |
OKTitel | String | Titel für Schaltfläche OK | |
AbbrechenTitel | String | Titel für Schaltfläche Abbrechen | |
Funktionsergebnis | String | Vom Benutzer eingegebener Wert |
Beschreibung
Die Funktion Request ruft einen Dialog mit dem Text Fragetext auf. Der Dialog enthält ein eingebbares Feld mit dem optionalen Vorschlag Wert und die beiden Schaltflächen OK und Abbrechen. Sie können Text in den Eingabebereich des Dialogs eingeben oder mit dem optionalen Parameter Wert einen Standardtext festlegen. Klicken Sie auf die Schaltfläche OK oder drücken Sie die Zeilenschaltung bzw. Eingabetaste, nimmt die Systemvariable OK den Wert 1 an und Frage ergibt den Wert des eingebbaren Feldes. Klicken Sie auf Abbrechen, nimmt OK den Wert 0 an und Frage ergibt einen leeren Text ("").
Der Text Fragetext ist auf 255 Zeichen begrenzt. Da zwischen Anführungszeichen maximal 80 Zeichen stehen können, müssen Sie längere Texte mit den Pluszeichen zusammensetzen.
Fragetext muss ein alphanumerischer Ausdruck sein. Wollen Sie Zahlen- oder Datumswerte eingeben, benutzen Sie zum Umformen die Funktionen Num oder Date.
Die Schaltfläche OK hat standardmäßig den Titel "OK", die Schaltfläche Abbrechen den Titel "Abbrechen". Mit den optionalen Parametern OKTitel und AbbrechenTitel können Sie einen eigenen Titel festlegen. Die Schaltfläche wird bei Bedarf nach links erweitert.
Tipp: Rufen Sie Request nicht in Formular- oder Objektmethoden auf, die die Ereignisse On Activate oder On Deactivate verwalten; denn das verursacht eine Endlosschleife.
Tipp: Benötigen Sie vom Benutzer mehrere Teilinformationen, legen Sie ein Formular an, das Sie mit dem Befehl DIALOG aufrufen. Mit der Funktion Request bräuchten Sie hierfür mehrere Dialogfenster.
Beispiele
1. Die Zeile:
$vsPrompt := Request ("Geben Sie Ihren Namen ein:")
zeigt folgendes Dialogfenster auf dem Bildschirm:
2. Die Zeile:
vsPrompt := Request ("Name des Angestellten:";"";"Erstelle Datensatz";"Abbrechen") If (OK=1) ADD RECORD ([Employees]) ` Hinweis: vsPrompt wird dann in der Formularmethode während dem Ereignis ` On Load in das Datenfeld [Employees]Nachname kopiert End if
zeigt folgendes Dialogfenster auf dem Bildschirm:
3. Die Zeile:
$vdPrompt := Date (Request ("Gib neues Datum ein:";String (Current date)))
zeigt folgendes Dialogfenster auf dem Bildschirm:
Referenz