3.53 DM_QueryBox
Mit Hilfe dieser Funktion kann eine entsprechend angegebene Messagebox geöffnet werden. Das Programm wartet bis der Benutzer diese Messagebox wieder geschlossen hat.
DM_Enum DML_default DM_EXPORT DM_QueryBox
(
DM_ID objectID,
DM_ID parentID,
DM_Options options
)
Parameter
-> DM_ID objectID
Dieser Parameter spezifiziert die Messagebox , 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 es erlaubt, wird die Messagebox über dem Vater-Fenster zentriert dargestellt. Andernfalls wird die Position vom Fenstersystem selbst festgelegt (z.B. Bildschirmmitte).
-> DM_Options options
Dieser Parameter wird zur Zeit noch nicht benutzt und muss daher mit 0 belegt sein.
Rückgabewert
Nummer des gedrückten Buttons. Dafür gibt es folgende Definitionen:
- MB
- MB
- MB
- MB
- MB
- MB
- MB
Bitte beachten Sie in Bezug auf die Anordnung eines Dialogfelds vor oder hinter anderen Fenstern und Dialogfeldern auf dem Bildschirm (Z-Ordnung) den Hinweis im Kapitel „Z-Ordnung von Fenstern und Dialogfeldern“ der „Objektreferenz“.
Beispiel
Von einer C-Funktion aus soll eine Messagebox geöffnet werden. Diese C-Funktion hat dann in etwa folgendes Aussehen:
DM_Boolean DML_default DM_ENTRY MESSBOX __1((DM_ID id))
{
DM_Value data;
/* Setzen des anzuzeigenden Textes */
data.type = DT_string;
data.value.string = "HALLO TEST";
DM_SetValue(id , AT_text , 0 , &data , DMF_ShipEvent );
/* Setzen des Titels der Messagebox */
data.type = DT_string;
data.value.string = "Testausgabe";
DM_SetValue(id , AT_title , 0 , &data , DMF_ShipEvent );
/*
** Öffnen der Messagebox und Return von TRUE, falls
** OK gedrückt wird
*/
return ((DM_QueryBox(id,0,0)== MB_ok) ? TRUE : FALSE);
}
Siehe auch
C-Funktion DM_OpenBox
Objekt messagebox
Eingebaute Funktion querybox() im Handbuch „Regelsprache“
Support