Freigeben über


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.

Hinweis Diese Funktion ist veraltet. Verwenden Sie stattdessen CreateWindow-.
 

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