4D Doc Center : Request

Home

4D v14.3

Request


Request ( Meldung {; Standardantwort {; OKTitel {; AbbrechenTitel}}} ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
Meldung	String	Meldung zum Anzeigen im Dialogfenster der Anfrage
Standardantwort	String	Standarddaten für eingebbaren Textbereich
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 zeigt einen Anfragedialog mit einer Meldung, einem Eingabebereich für Text und die beiden Schaltflächen OK und Abbrechen.

Im Parameter Meldung übergeben Sie die anzuzeigende Meldung. Passt sie nicht in den Anzeigebereich (in der Regel ca. 50 Zeichen je nach Betriebssystem und verwendeter Schrift), wird sie abgeschnitten.
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.

Die Schaltfläche OK ist die Standardschaltfläche. Klicken Sie auf die Schaltfläche OK oder drücken die Eingabetaste, um den Dialog zu bestätigen, wird die Systemvariable OK auf 1 gesetzt. Klicken Sie auf die Schaltfläche Abbrechen, um den Dialog zu annullieren, wird die Systemvariable OK auf 0 gesetzt

Der Benutzer kann Text in den Eingabebereich des Dialogs eingeben oder mit dem optionalen Parameter Standardantwort einen Standardtext festlegen. Klickt er auf die Schaltfläche OK, gibt Request den Text zurück. Klickt er auf Abbrechen, gibt Request einen leeren String ("") zurück. Soll die Antwort ein Zahlen- oder Datumswert sein, benutzen Sie zum Umformen die Funktionen Num oder Date.

Tipp: Rufen Sie Request nicht in Formular- oder Objektmethoden auf, die die Formularereignisse 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.

Beispiel 1

Die Zeile:

$vsPrompt :=Request("Geben Sie Ihren Namen ein:")

zeigt folgendes Dialogfenster auf dem Bildschirm:

Beispiel 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:

Beispiel 3

Die Zeile:

$vdPrompt:=Date(Request("Gib neues Datum ein:";String(Current date)))

zeigt folgendes Dialogfenster auf dem Bildschirm: