IConsole::MessageBox-Methode (mmc.h)
Zeigt ein Meldungsfenster an.
Syntax
HRESULT MessageBox(
[in] LPCWSTR lpszText,
[in] LPCWSTR lpszTitle,
[in] UINT fuStyle,
[out] int *piRetval
);
Parameter
[in] lpszText
Ein Zeiger auf eine NULL-endende Zeichenfolge, die die anzuzeigende Meldung enthält.
[in] lpszTitle
Ein Zeiger auf eine NULL-endende Zeichenfolge, die für den Nachrichtenfeldtitel verwendet wird. Wenn dieser Parameter NULL ist, wird der Standardtitel "Error" verwendet.
[in] fuStyle
Ein -Wert, der eine Reihe von Bitflags angibt, die den Inhalt und das Verhalten des Meldungsfelds bestimmen. Dieser Parameter kann eine Kombination von Flags aus den folgenden Flaggruppen sein, die aus der Dokumentation für das Windows-API-MessageBox stammen.
Geben Sie eines der folgenden Flags an, um anzugeben, welche Schaltflächen im Meldungsfeld angezeigt werden.
MB_ABORTRETRYIGNORE
Das Meldungsfeld enthält drei Schaltflächen: Abbrechen, Wiederholen und Ignorieren.
MB_OK
Das Meldungsfeld enthält eine Schaltfläche: OK. Dies ist die Standardoption.
MB_OKCANCEL
Das Meldungsfeld enthält zwei Schaltflächen: OK und Abbrechen.
MB_RETRYCANCEL
Das Meldungsfeld enthält zwei Schaltflächen: Wiederholen und Abbrechen.
MB_YESNO
Das Meldungsfeld enthält zwei Schaltflächen: Ja und Nein.
MB_YESNOCANCEL
Das Meldungsfeld enthält drei Schaltflächen: Ja, Nein und Abbrechen.
Geben Sie eines der folgenden Flags an, um anzugeben, welches Symbol im Meldungsfeld angezeigt wird:
MB_ICONEXCLAMATION, MB_ICONWARNING
Im Meldungsfeld wird ein Ausrufezeichensymbol angezeigt.
MB_ICONINFORMATION, MB_ICONASTERISK
Ein Symbol, das aus einem "I" in einem Kreis besteht, wird im Meldungsfeld angezeigt.
MB_ICONQUESTION
Im Meldungsfeld wird ein Fragezeichensymbol angezeigt.
MB_ICONSTOP,
MB_ICONERROR, MB_ICONHAND
Im Meldungsfeld wird ein Stoppzeichensymbol angezeigt.
Geben Sie eines der folgenden Flags an, um die Standardschaltfläche anzugeben:
MB_DEFBUTTON1
Die erste Schaltfläche ist die Standardschaltfläche, es sei denn, eines der anderen Flags in dieser Gruppe ist als Standard angegeben.
MB_DEFBUTTON2
Die zweite Schaltfläche ist die Standardschaltfläche.
MB_DEFBUTTON3
Die dritte Schaltfläche ist die Standardschaltfläche.
MB_DEFBUTTON4
Die vierte Schaltfläche ist die Standardschaltfläche.
Geben Sie eines der folgenden Flags an, um die Modalität des Dialogfelds anzugeben:
MB_APPLMODAL
Der Benutzer muss auf das Meldungsfeld antworten, bevor die Arbeit im aktuellen Fenster fortgesetzt wird. Der Benutzer kann jedoch zu den Fenstern anderer Anwendungen wechseln und in diesen Fenstern arbeiten. Der Standardwert ist MB_APPLMODAL , wenn weder MB_SYSTEMMODAL noch MB_TASKMODAL angegeben ist.
MB_SYSTEMMODAL
Alle Anwendungen werden angehalten, bis der Benutzer auf das Meldungsfeld antwortet. Systemmodale Meldungsfelder werden verwendet, um den Benutzer über schwerwiegende, potenziell schädliche Fehler zu benachrichtigen, die sofortige Aufmerksamkeit erfordern und sparsam verwendet werden sollten.
MB_TASKMODAL
Ähnlich wie MB_APPLMODAL, aber nicht nützlich in einer MFC-Anwendung (Microsoft Foundation Classes). Dieses Flag ist für eine aufrufende Anwendung oder Bibliothek reserviert, für die kein Fensterhandle verfügbar ist.
Darüber hinaus können Sie die folgenden Flags angeben:
MB_DEFAULT_DESKTOP_ONLY
Der Desktop, der derzeit Eingaben empfängt, muss ein Standarddesktop sein. Andernfalls schlägt die Funktion fehl. Ein Standarddesktop ist ein Desktop, auf dem eine Anwendung ausgeführt wird, nachdem sich der Benutzer angemeldet hat.
MB_HELP
Fügt dem Meldungsfeld eine Hilfeschaltfläche hinzu. Wenn Sie die Schaltfläche Hilfe auswählen oder F1 drücken, wird ein Hilfeereignis generiert.
MB_RIGHT
Der Text ist rechtsbündige.
MB_RTLREADING
Zeigt Nachrichten und Untertitel Text mithilfe der Leserichtung von rechts nach links für hebräische und arabische Systeme an.
MB_SETFOREGROUND
Das Meldungsfeld wird zum Vordergrundfenster. Intern ruft das Betriebssystem die SetForegroundWindow-Funktion für das Meldungsfeld auf.
MB_TOPMOST
Das Meldungsfeld wird mit dem WS_EX_TOPMOST Fensterstil erstellt.
MB_SERVICE_NOTIFICATION
Der Aufrufer ist ein Dienst, der den Benutzer über ein Ereignis benachrichtigt. Die Funktion zeigt ein Meldungsfeld auf dem aktuell aktiven Desktop an, auch wenn kein Benutzer am Computer angemeldet ist.
Weitere Informationen zur Verwendung dieses Flags finden Sie in der MessageBox-Funktion .
MB_SERVICE_NOTIFICATION_NT3x
Dieser Wert entspricht dem Wert, der für MB_SERVICE_NOTIFICATION für frühere Versionen von Windows definiert wurde.
[out] piRetval
Ein Zeiger auf den Rückgabewert.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
Hinweise
MessageBox sollte nicht verwendet werden, um Fehler anzuzeigen, die auftreten, wenn das Snap-In nicht den Fokus hat. Allgemein
MessageBox sollte nur verwendet werden, wenn der Fehler die Aufmerksamkeit des Benutzers erfordert und der Ergebnisbereich trotz des Fehlers nützliche Informationen enthält.
In den meisten Fällen ist das OCX-Steuerelement für mmc-Nachrichten eine geeignetere Methode, um Fehlermeldungen anzuzeigen. Weitere Informationen finden Sie unter Verwenden des OCX-Steuerelements für MMC-Nachrichten.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | mmc.h |
| DLL | Mmcndmgr.dll |