CreateStatusWindowW-Funktion (commctrl.h)
Erstellt ein Statusfenster, das in der Regel verwendet wird, um den Status einer Anwendung anzuzeigen. Das Fenster wird im Allgemeinen unten im übergeordneten Fenster angezeigt und enthält den angegebenen Text.
Syntax
HWND CreateStatusWindowW(
LONG style,
LPCWSTR lpszText,
HWND hwndParent,
UINT wID
);
Parameter
style
Typ: LONG
Fensterformatvorlagen für das Statusfenster. Dieser Parameter muss die WS_CHILD Formatvorlage enthalten und auch die WS_VISIBLE Formatvorlage enthalten.
lpszText
Typ: LPCTSTR-
Zeigen Sie auf eine mit Null beendete Zeichenfolge, die den Statustext für den ersten Teil angibt.
hwndParent
Typ: HWND-
handle to the parent window.
wID
Typ: UINT-
Steuerelementbezeichner für das Statusfenster. Die Fensterprozedur verwendet diesen Wert, um Nachrichten zu identifizieren, die sie an das übergeordnete Fenster sendet.
Rückgabewert
Typ: HWND-
Gibt das Handle an das Statusfenster zurück, falls erfolgreich, oder NULL- andernfalls. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen abzurufen.
Bemerkungen
Die CreateStatusWindow--Funktion ruft die CreateWindow--Funktion auf, um das Fenster zu erstellen. Sie übergibt die Parameter ohne Änderung und legt die Parameter für Position, Breite und Höhe auf CreateWindow Standardwerte fest.
Anmerkung
Der commctrl.h-Header definiert CreateStatusWindow 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 Vista [nur Desktop-Apps] |
mindestens unterstützte Server- | Windows Server 2003 [Nur Desktop-Apps] |
Zielplattform- | Fenster |
Header- | commctrl.h |
Library | Comctl32.lib |
DLL- | Comctl32.dll |