ShellMessageBoxW-Funktion (shellapi.h)

Artikel
03/01/2024

[ShellMessageBox ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]

ShellMessageBox ist eine spezielle instance von MessageBox, die die Möglichkeit bietet, den Titel des Besitzerfensters als Titel des Meldungsfelds zu verwenden.

Syntax

int ShellMessageBoxW(
  [in] HINSTANCE hAppInst,
  [in] HWND      hWnd,
  [in] LPCWSTR   lpcText,
  [in] LPCWSTR   lpcTitle,
  [in] UINT      fuStyle,
       ...       
);

Parameter

[in] hAppInst

Typ: HINSTANCE

Das Handle des Moduls, aus dem eine Zeichenfolgenressource mit dem Namen in pszTitle geladen werden soll. Wenn pszTitle keine Zeichenfolgenressource benennt, wird dieser Parameter ignoriert. Dieser Wert muss gültig sein, wenn pszMsg oder pszTitle eine Ressourcen-ID ist.

[in] hWnd

Typ: HWND

Ein Handle für das Besitzerfenster des zu erstellenden Meldungsfelds. Wenn diese Variable nicht NULL ist, wird der Titel des Besitzerfensters als Titel des Meldungsfelds verwendet.

[in] lpcText

Typ: LPCTSTR

Ein Zeiger auf eine null-beendete Zeichenfolge, die entweder die anzuzeigende Nachricht oder eine Ressourcen-ID enthält, von der angegeben wird, wo die Nachricht abgerufen werden soll.

[in] lpcTitle

Typ: LPCTSTR

Ein Zeiger auf eine NULL-Zeichenfolge, die den Dialogfeldtitel oder eine Ressourcen-ID enthält, die angibt, wo der Titel abgerufen werden soll. Wenn sowohl dieser Parameter als auch hWndNULL sind, wird kein Titel angezeigt. Wenn dieser Parameter auf eine mit dem MAKEINTRESOURCE-Makro gebildete ladebare Ressource verweist, überschreibt er hWnd als Titel.

[in] fuStyle

Typ: UINT

Gibt den Inhalt und das Verhalten des Dialogfelds an. Mögliche Werte finden Sie unter MessageBox.

...

Eine Variablenargumentliste, die mit pszMsg kombiniert wird, um den im Meldungsfeld angezeigten Volltext zu bilden.

Rückgabewert

Typ: int

Ein ganzzahliger Wert, der eine Schaltfläche angibt, die im Meldungsfeld gedrückt wurde. Bestimmte Werte finden Sie unter MessageBox.

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

Hinweise

Hinweis

Der Shellapi.h-Header definiert ShellMessageBox 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 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 XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shellapi.h
Bibliothek	Shlwapi.lib
DLL	Shlwapi.dll

Weitere Informationen

MAKEINTRESOURCE

Messagebox

Freigeben über