CreateStatusWindowW-Funktion (commctrl.h)

  • Artikel

Erstellt ein status Fenster, das in der Regel zum Anzeigen der status einer Anwendung verwendet wird. Das Fenster wird in der Regel unten im übergeordneten Fenster angezeigt und enthält den angegebenen Text.

Hinweis Diese Funktion ist veraltet. Verwenden Sie stattdessen CreateWindow .
 

Syntax

HWND CreateStatusWindowW(
  LONG    style,
  LPCWSTR lpszText,
  HWND    hwndParent,
  UINT    wID
);

Parameter

style

Typ: LONG

Fensterstile für das status Fenster. Dieser Parameter muss die WS_CHILD-Formatvorlage enthalten und sollte auch die WS_VISIBLE-Format enthalten.

lpszText

Typ: LPCTSTR

Zeiger auf eine NULL-Zeichenfolge, die den status Text für den ersten Teil angibt.

hwndParent

Typ: HWND

handle mit dem übergeordneten Fenster.

wID

Typ: UINT

Steuerungsbezeichner für das status-Fenster. Die Fensterprozedur verwendet diesen Wert, um Nachrichten zu identifizieren, die an das übergeordnete Fenster gesendet werden.

Rückgabewert

Typ: HWND

Gibt das Handle an das status-Fenster zurück, wenn der Vorgang erfolgreich war, oder andernfalls NULL. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen abzurufen.

Hinweise

Die CreateStatusWindow-Funktion ruft die CreateWindow-Funktion auf, um das Fenster zu erstellen. Sie übergibt die Parameter ohne Änderung an und legt die Parameter für Position, Breite und Höhe auf CreateWindow-Standardwerte fest.

Hinweis

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 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 Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile commctrl.h
Bibliothek Comctl32.lib
DLL Comctl32.dll