3.47 DM_OpenBox

Mit Hilfe dieser Funktion kann eine entsprechend angegebene Messagebox oder Dialogbox (Fenster mit gesetztem Attribut .dialogbox = true) geöffnet werden. Das Programm wartet bis der Benutzer diese Messagebox bzw. Dialogbox wieder geschlossen hat.

Hinweis

Bei Verwendung in Funktionen, welche Records als Parameter enthalten, beachten Sie bitte die Hinweise im Kapitel „Behandlung von String-Parametern“ und das Kapitel „Hinweis bei Verwendung von DM-Funktionen“ im Handbuch „C-Schnittstelle - Grundlagen“.

DM_Boolean DM_OpenBox
(
  DM_ID       objectID,
  DM_ID       parentID,
  DM_Value   *retval,
  DM_Options  options
)

Parameter

-> DM_ID objectID

Dieser Parameter spezifiziert die Messagebox bzw. Dialogbox, die geöffnet werden soll.

-> DM_ID parentID

Dieser Parameter spezifiziert das Fenster, in dem die Messagebox erscheinen soll. Der Parameter kann ignoriert werden. Falls dieser Parameter angegeben ist, muss ein Fenster oder NULL angegeben werden.

Falls das Fenstersystem dies unterstützt, wird die Messagebox über dem Vater-Fenster zentriert dargestellt. Andernfalls wird die Position vom Fenstersystem selbst festgelegt (z.B. Bildschirmmitte).

-> DM_Value *retval

Enthält nach Schließen der Messagebox bzw. Dialogbox den Rückgabewert des jeweiligen Objekts:

  • Bei Messageboxen die Nummer des gedrückten Buttons. Dafür gibt es folgende Definitionen:

    • MB_abort
    • MB_cancel
    • MB_ignore
    • MB_no
    • MB_ok
    • MB_retry
    • MB_yes
  • Bei Dialogboxen den in der Funktion closequery() definierten Wert.

-> DM_Options options

Dieser Parameter wird zur Zeit noch nicht benutzt und muss daher mit 0 belegt sein.

Rückgabewert

Der Rückgabewert sagt aus, ob die Messagebox bzw. Dialogbox geöffnet werden konnte.

Siehe auch

C-Funktion DM_QueryBox

Objekt messagebox

Eingebaute Funktion querybox() im Handbuch „Regelsprache“