Computer & Technik
Betriebssysteme
Windows
WINDOWS-Funktion MessageBox
Funktion MessageBox(hWndP, lpText, lpCaption, wType)
Zweck Diese Funktion erzeugt ein einfaches mit einem Titel und einer Meldung
versehenes Dialogfeld.
HWND hWnd enthält die Handle des übergeordneten Fensters
LPSTR lpText ist ein Long-Zeiger auf die Zeichenkette, die den Meldungstext enthält
LPSTR lpCaption ist ein Long-Zeiger auf die Zeichenkette, die den Titeltext enthält
WORD wType enthält eine der folgenden Optionen oder deren Kombination
Schaltflächen:
MB_OK Okay
MB_YESNO Ja/Nein
MB_OKCANCEL Okay/Abbrechen
MB_YESNOCANCEL Ja/Nein/Abbrechen
MB_RETRYCANCEL Wiederholen/Abbrechen
MB_ABORTRETRYIGNORE Abbrechen/Wiederholen/Ignorieren
Sinnbilder:
MB_ICONQUESTION das Fragezeichen
MB_ICONEXCLAMATION das Ausrufezeichen
MB_ICONASTERISK das Sternchen
MB_ICONHAND die Hand
Standard-Schaltfläche:
MB_DEFBUTTON1 Schaltfläche 1
MB_DEFBUTTON2 Schaltfläche 2
MB_DEFBUTTON3 Schaltfläche 3
Fenstertyp:
MB_APPLMODAL anwendungsmodal
MB_SYSTEMMODAL systemmodal
Rückgabe Die Funktion MessageBox() liefert den Wert der ausgewählten Schaltfläche
zurück, wobei folgende Schaltflächen vordefiniert sind:
0 Fehler: Nicht genug Speicher für Funktion
IDABORT Abbrechen
IDCANCEL Abbrechen
IDIGNORE Ignorieren
IDOK Okay
IDNO Nein
IDRETRY Wiederholen
IDYES Ja
Kommentar Wenn wType mit MBICONHAND und MB_SYSTEMMODAL gekennzeichnet
wird, stellt MessageBox() nur eine Textzeile dar. Diese Kombination sollte
ohnehin nur in äußersten Notfällen verwendet werden.
Wird MessageBox() verwendet, um dem Anwender mitzuteilen, daß nicht
genügend Speicherplatz vorhanden ist, daß der dazu notwendige Meldungstext
nicht der Ressourcentext entnommen werden, weil für den Kopiervorgang
möglicherweise auch kein Speicher mehr vorhanden ist.
