IOyesNo2

Generiert eine "Ja-/Nein"-Frage und liefert Eingabe zurück.

Diese Funktion erzeugt aus der übergebenen Meldungsnummer und Meldungsnamen und der Vorgabe für die positive Antwort (GLOBAL 1) und für die negative Antwort (GLOBAL 2) eine Frage, die durch eine dieser beiden Möglichkeiten zu beantworten ist. Dabei genügt es, die ersten signifikanten Zeichen einzugeben. Ist die Eingabe nicht eindeutig oder nicht eine der beiden Vorgaben, so erscheint ein entsprechender Hinweis (GLOBAL 4) und die Frage wird erneut gestellt.

Um eine Antwort mit dem Digitalisiercursor zu erlauben, wird #L als Nein und #P als Ja verstanden.

Bei entsprechender Konfiguration werden die Abfragen als Dialog formuliert.

Parameter

root (PROOT)                                             [IN]

Handle auf die geöffnete Datenbank.

proc (const char *)                                      [IN]

Name der Meldung aus der Meldungsdatei, die als Frage ausgegeben werden soll.

num (int)                                                       [IN]

Nummer der Meldung aus der Meldungsdatei, die verwendet werden soll.

dflt (int)                                                         [IN]

Dieser Wert spezifiziert die Defaultantwort. Antwortet der Anwender nur durch Drücken der <RETURN>-Taste so wird dieser Wert zurückgeliefert. Dieser Wert sollte aus dem Datenbereich der Rückgabewerte { 0, 1} sein, kann aber auch einen anderen Wert haben (z.B. 2), da er nicht durch die Funktion überprüft wird.

helpID (const char *)                                   [IN]

Name des zugehörigen Hilfethemas in der Moskitohilfe, wenn das Thema nicht in user.hlp steht, dann wird als Syntax "Datei|Thema" verwendet. Hier kann NULL eingetragen werden, wenn keine Hilfe verwendet werden soll.

Ergebnis

(int)                                                           [OUT]

1     positive Antwort ("ja") gewählt

0     negative Antwort ("nein") gewählt

Bemerkungen

Wenn mit setEcho(), bzw. „Echo /DIALOGS“, auf dialogbasierendes Benutzerinterface geschaltet wird erscheinen die Abfragen als Messageboxen.

Deklaration

#include "system.h"

int DLLENTRY IOyesNo2 (

     PROOT       root,

     char *         proc,

     int            num,

     int            dflt,

     const char *   helpID

);

Beispiel

status = IOyesNo2 (root, "STRAESSLE kompatibel ?", 1, NULL)

Der Variablen "status" wird der Return-Wert der Funktion IOyesNo2 zugewiesen, die fragt ob eine bestimmte Funktion kompatibel zum GRADIS der Firma STRAESSLE ablaufen soll. Wird diese Frage nur durch drücken der <RETURN>-Taste beantwortet, so liefert die Funktion den Wert "1" zurück, was der negativen Antwort entspricht.

Bemerkungen

• Die Datei MELDUNG.DAT beinhaltet u.a. folgende Zeilen, die bei Bedarf angepaßt werden können:

--- GLOBAL 1

Ja

--- GLOBAL 2

Nein

--- GLOBAL 9

Yes

--- GLOBAL 10

No

--- GLOBAL 3

Abbruch