MSGBOXPARAMSA-Struktur (winuser.h)

Artikel
11/20/2024

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

Syntax

typedef struct tagMSGBOXPARAMSA {
  UINT           cbSize;
  HWND           hwndOwner;
  HINSTANCE      hInstance;
  LPCSTR         lpszText;
  LPCSTR         lpszCaption;
  DWORD          dwStyle;
  LPCSTR         lpszIcon;
  DWORD_PTR      dwContextHelpId;
  MSGBOXCALLBACK lpfnMsgBoxCallback;
  DWORD          dwLanguageId;
} MSGBOXPARAMSA, *PMSGBOXPARAMSA, *LPMSGBOXPARAMSA;

Angehörige

cbSize

Typ: UINT-

Die Strukturgröße in Byte.

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 element lpszIcon identifizierte Symbolressource enthält, und die Zeichenfolgenressource, die durch das lpszText-element oder lpszCaption Member identifiziert wird.

lpszText

Typ: LPCTSTR-

Eine mit Null beendete Zeichenfolge oder der Bezeichner einer Zeichenfolgenressource, die die anzuzeigende Nachricht enthält.

lpszCaption

Typ: LPCTSTR-

Eine mit Null beendete Zeichenfolge oder der Bezeichner einer Zeichenfolgenressource, die den Titel des Meldungsfelds enthält. Wenn dieses Element NULL-ist, wird der Standardtitel Fehler- verwendet.

dwStyle

Typ: 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 das Meldungsfeld das durch das lpszIcon Member angegebene Symbol anzeigen soll.

lpszIcon

Typ: LPCTSTR-

Identifiziert eine Symbolressource. Dieser Parameter kann entweder eine Zeichenfolge mit Null-Beendigung oder ein ganzzahliger Ressourcenbezeichner sein, der an das MAKEINTRESOURCE Makro übergeben wird.

Um eines der standardmäßigen systemdefinierten Symbole zu laden, legen Sie das hInstance-element auf NULL- fest, und legen Sie lpszIcon auf einen der Werte fest, die mit der LoadIcon--Funktion aufgeführt sind.

Dieses Element wird ignoriert, wenn das dwStyle Member 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 weist das folgende Formular auf:

VOID CALLBACK MsgBoxCallback(LPHELPINFO lpHelpInfo);

Wenn dieses Mitglied NULL-ist, sendet das Meldungsfeld WM_HELP Nachrichten an das Besitzerfenster, wenn Hilfeereignisse auftreten.

dwLanguageId

Typ: DWORD-

Die Sprache, in der der Text in den vordefinierten Pushtasten angezeigt werden soll. Dieser Wert muss sich im Formular befinden, das vom MAKELANGID Makro zurückgegeben wird.

Eine Liste der unterstützten Sprachbezeichner finden Sie unter Sprach-IDs. Beachten Sie, dass jede lokalisierte Version von Windows in der Regel Ressourcen nur für einen begrenzten Satz von Sprachen enthält. So bietet beispielsweise die US-Version LANG_ENGLISH, die französische Version bietet LANG_FRENCH, die deutsche Version bietet LANG_GERMAN, und die japanische Version bietet LANG_JAPANESE. Jede Version bietet LANG_NEUTRAL. Dadurch wird der Satz von Werten begrenzt, die mit dem dwLanguageId Parameter verwendet werden können. Bevor Sie einen Sprachbezeichner angeben, sollten Sie die Gebietsschemas aufzählen, die auf einem System installiert sind.

Bemerkungen

Anmerkung

Der winuser.h-Header definiert MSGBOXPARAMS als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, 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
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Header-	winuser.h (enthalten Windows.h)