MessageBox-Funktion (winuser.h)

Zeigt ein modales Dialogfeld an, das ein Systemsymbol, eine Reihe von Schaltflächen und eine kurze anwendungsspezifische Meldung enthält, z. B. status- oder Fehlerinformationen. Das Meldungsfeld gibt einen ganzzahligen Wert zurück, der angibt, auf welche Schaltfläche der Benutzer geklickt hat.

Syntax

int MessageBox(
  [in, optional] HWND    hWnd,
  [in, optional] LPCTSTR lpText,
  [in, optional] LPCTSTR lpCaption,
  [in]           UINT    uType
);

Parameter

[in, optional] hWnd

Typ: HWND

Ein Handle für das Besitzerfenster des zu erstellenden Meldungsfelds. Wenn dieser Parameter NULL ist, hat das Meldungsfeld kein Besitzerfenster.

[in, optional] lpText

Typ: LPCTSTR

Die anzuzeigende Nachricht. Wenn die Zeichenfolge aus mehr als einer Zeile besteht, können Sie die Zeilen mit einem Wagenrücklauf- und/oder Zeilenvorschubzeichen zwischen jeder Zeile trennen.

[in, optional] lpCaption

Typ: LPCTSTR

Der Titel des Dialogfelds. Wenn dieser Parameter NULL ist, lautet der Standardtitel Fehler.

[in] uType

Typ: UINT

Inhalt und Verhalten des Dialogfelds. Dieser Parameter kann eine Kombination von Flags aus den folgenden Flaggruppen sein.

Geben Sie einen der folgenden Werte an, um die im Meldungsfeld angezeigten Schaltflächen anzugeben.

Geben Sie einen der folgenden Werte an, um ein Symbol im Meldungsfeld anzuzeigen.

Um die Standardschaltfläche anzugeben, geben Sie einen der folgenden Werte an.

Geben Sie einen der folgenden Werte an, um die Modalität des Dialogfelds anzugeben.

Um weitere Optionen anzugeben, verwenden Sie mindestens einen der folgenden Werte.

Rückgabewert

Typ: int

Wenn ein Meldungsfeld über die Schaltfläche Abbrechen verfügt, gibt die Funktion den IDCANCEL-Wert zurück, wenn entweder die ESC-Taste gedrückt oder die Schaltfläche Abbrechen ausgewählt ist. Wenn im Meldungsfeld keine Schaltfläche Abbrechen vorhanden ist, wirkt sich das Drücken von ESC nicht aus, es sei denn, es ist eine MB_OK-Schaltfläche vorhanden. Wenn eine MB_OK-Schaltfläche angezeigt wird und der Benutzer ESC drückt, lautet der Rückgabewert IDOK.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Wenn die Funktion erfolgreich ist, ist der Rückgabewert einer der folgenden Menüelementwerte.

Hinweise

Die folgenden Systemsymbole können in einem Meldungsfeld verwendet werden, indem Sie den uType-Parameter auf den entsprechenden Flagwert festlegen.

Symbol	Flagwerte
	MB_ICONHAND, MB_ICONSTOP oder MB_ICONERROR
	MB_ICONQUESTION
	MB_ICONEXCLAMATION oder MB_ICONWARNING
	MB_ICONASTERISK oder MB_ICONINFORMATION

Das Hinzufügen von zwei Rechts-nach-Links-Markierungen (RLMs), dargestellt durch das Unicode-Formatierungszeichen U+200F, am Anfang einer MessageBox-Anzeigezeichenfolge wird vom MessageBox-Renderingmodul interpretiert, sodass die Lesereihenfolge der MessageBox als RTL gerendert wird.

Wenn Sie ein systemmodales Meldungsfeld verwenden, um anzugeben, dass das System wenig Arbeitsspeicher hat, sollten die Zeichenfolgen, auf die die Parameter lpText und lpCaption verweisen, nicht aus einer Ressourcendatei entnommen werden, da ein Versuch, die Ressource zu laden, möglicherweise fehlschlägt.

Wenn Sie ein Meldungsfeld erstellen, während ein Dialogfeld vorhanden ist, verwenden Sie ein Handle für das Dialogfeld als hWnd-Parameter . Der hWnd-Parameter sollte kein untergeordnetes Fenster identifizieren, z. B. ein Steuerelement in einem Dialogfeld.

Beispiele

Im folgenden Beispiel zeigt die Anwendung ein Meldungsfeld an, das den Benutzer zur Eingabe einer Aktion auffordert, nachdem eine Fehlerbedingung aufgetreten ist. Im Meldungsfeld wird die Meldung angezeigt, die die Fehlerbedingung und deren Behebung beschreibt. Der MB_CANCELTRYCONTINUE-Stil weist MessageBox an, drei Schaltflächen bereitzustellen, mit denen der Benutzer auswählen kann, wie er vorgehen soll. Die MB_DEFBUTTON2-Formatvorlage legt den Standardfokus auf die zweite Schaltfläche des Meldungsfelds fest, in diesem Fall die Schaltfläche Erneut versuchen .

int DisplayResourceNAMessageBox()
{
    int msgboxID = MessageBox(
        NULL,
        (LPCWSTR)L"Resource not available\nDo you want to try again?",
        (LPCWSTR)L"Account Details",
        MB_ICONWARNING | MB_CANCELTRYCONTINUE | MB_DEFBUTTON2
    );

    switch (msgboxID)
    {
    case IDCANCEL:
        // TODO: add code
        break;
    case IDTRYAGAIN:
        // TODO: add code
        break;
    case IDCONTINUE:
        // TODO: add code
        break;
    }

    return msgboxID;
}

Die folgende Abbildung zeigt die Ausgabe aus dem vorherigen Codebeispiel:

Ein weiteres Meldungsfeldbeispiel finden Sie unter Anzeigen eines Meldungsfelds.

Anforderungen

Siehe auch

Konzept

Dialogfelder

FlashWindow

MessageBeep

MessageBoxEx

MessageBoxIndirect

Andere Ressourcen

Referenz

SetForegroundWindow