CreateStatusWindowA-Funktion (commctrl.h)

Artikel
02/26/2024

Erstellt ein status Fenster, das in der Regel zum Anzeigen der status einer Anwendung verwendet wird. Das Fenster wird in der Regel am unteren Rand des übergeordneten Fensters angezeigt und enthält den angegebenen Text.

Hinweis Diese Funktion ist veraltet. Verwenden Sie stattdessen CreateWindow .

Syntax

HWND CreateStatusWindowA(
  LONG   style,
  LPCSTR 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-Formatvorlage enthalten.

lpszText

Typ: LPCTSTR

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

hwndParent

Typ: HWND

handle zum ü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 dies 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. Es übergibt die Parameter ohne Änderung an und legt die Parameter position, width und height 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 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
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

Share via