MSGBOXPARAMSW-Struktur (winuser.h)

Artikel
08/28/2023

Enthält Informationen, die zum Anzeigen eines Meldungsfelds verwendet werden. Die MessageBoxIndirect-Funktion verwendet diese Struktur.

Syntax

typedef struct tagMSGBOXPARAMSW {
  UINT           cbSize;
  HWND           hwndOwner;
  HINSTANCE      hInstance;
  LPCWSTR        lpszText;
  LPCWSTR        lpszCaption;
  DWORD          dwStyle;
  LPCWSTR        lpszIcon;
  DWORD_PTR      dwContextHelpId;
  MSGBOXCALLBACK lpfnMsgBoxCallback;
  DWORD          dwLanguageId;
} MSGBOXPARAMSW, *PMSGBOXPARAMSW, *LPMSGBOXPARAMSW;

Member

cbSize

Typ: UINT

Die Strukturgröße in Bytes.

hwndOwner

Typ: HWND

Ein Handle für das Besitzerfenster. Dieses Element kann NULL sein.

hInstance

Typ: HINSTANCE

Ein Handle für das Modul, das die vom lpszIcon-Member identifizierte Symbolressource und die Zeichenfolgenressource enthält, die vom lpszText - oder lpszCaption-Member identifiziert wird.

lpszText

Typ: LPCTSTR

Eine NULL-Zeichenfolge oder der Bezeichner einer Zeichenfolgenressource, die die anzuzeigende Nachricht enthält.

lpszCaption

Typ: LPCTSTR

Eine NULL-Zeichenfolge oder der Bezeichner einer Zeichenfolgenressource, die den Titel des Meldungsfelds enthält. Wenn dieser Member NULL ist, wird der Standardtitel Error verwendet.

dwStyle

Art: DWORD

Inhalt und Verhalten des Dialogfelds. Dieses Element kann eine Kombination von Flags sein, die für den uType-Parameter der MessageBoxEx-Funktion beschrieben werden.

Darüber hinaus können Sie das MB_USERICON-Flag (0x00000080L) angeben, wenn im Meldungsfeld das vom lpszIcon-Element angegebene Symbol angezeigt werden soll.

lpszIcon

Typ: LPCTSTR

Identifiziert eine Symbolressource. Bei diesem Parameter kann es sich um eine null-beendete Zeichenfolge oder um einen ganzzahligen Ressourcenbezeichner handeln, der an das MAKEINTRESOURCE-Makro übergeben wird.

Um eines der standardmäßigen systemdefinierten Symbole zu laden, legen Sie den hInstance-Member auf NULL fest, und legen Sie lpszIcon auf einen der mit der LoadIcon-Funktion aufgeführten Werte fest.

Dieses Element wird ignoriert, wenn das dwStyle-Element das MB_USERICON-Flag nicht angibt.

dwContextHelpId

Typ: DWORD_PTR

Identifiziert einen Hilfekontext. Wenn ein Hilfeereignis auftritt, wird dieser Wert in der HELPINFO-Struktur angegeben, die das Meldungsfeld an das Besitzerfenster oder die Rückruffunktion sendet.

lpfnMsgBoxCallback

Typ: MSGBOXCALLBACK

Ein Zeiger auf die Rückruffunktion, die Hilfeereignisse für das Meldungsfeld verarbeitet. Die Rückruffunktion hat die folgende Form:

VOID CALLBACK MsgBoxCallback(LPHELPINFO lpHelpInfo);

Wenn dieser Member NULL ist, sendet das Meldungsfeld WM_HELP Nachrichten an das Besitzerfenster, wenn Hilfeereignisse auftreten.

dwLanguageId

Art: DWORD

Die Sprache, in der der text in den vordefinierten Schaltflächen enthaltene Text angezeigt werden soll. Dieser Wert muss in dem Vom MAKELANGID-Makro zurückgegebenen Format vorliegen.

Eine Liste der unterstützten Sprachbezeichner finden Sie unter Sprachbezeichner. Beachten Sie, dass jede lokalisierte Version von Windows normalerweise nur Ressourcen für einen begrenzten Satz von Sprachen enthält. So bietet beispielsweise die US-Version LANG_ENGLISH, die französische Version LANG_FRENCH, die deutsche Version LANG_GERMAN und die japanische Version LANG_JAPANESE. Jede Version bietet LANG_NEUTRAL. Dies schränkt den Wertsatz ein, der mit dem dwLanguageId-Parameter verwendet werden kann. Bevor Sie einen Sprachbezeichner angeben, sollten Sie die Gebietsschemas auflisten, die auf einem System installiert sind.

Hinweise

Hinweis

Der winuser.h-Header definiert MSGBOXPARAMS als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	winuser.h (einschließlich Windows.h)