CreateStatusWindowA function (commctrl.h)

Article
02/22/2024

Creates a status window, which is typically used to display the status of an application. The window generally appears at the bottom of the parent window, and it contains the specified text.

Note This function is obsolete. Use CreateWindow instead.

Syntax

HWND CreateStatusWindowA(
  LONG   style,
  LPCSTR lpszText,
  HWND   hwndParent,
  UINT   wID
);

Parameters

style

Type: LONG

Window styles for the status window. This parameter must include the WS_CHILD style and should also include the WS_VISIBLE style.

lpszText

Type: LPCTSTR

Pointer to a null-terminated string that specifies the status text for the first part.

hwndParent

Type: HWND

handle to the parent window.

wID

Type: UINT

Control identifier for the status window. The window procedure uses this value to identify messages it sends to the parent window.

Return value

Type: HWND

Returns the handle to the status window if successful, or NULL otherwise. To retrieve extended error information, call GetLastError.

Remarks

The CreateStatusWindow function calls the CreateWindow function to create the window. It passes the parameters to without modification and sets the position, width, and height parameters to CreateWindow default values.

Note

The commctrl.h header defines CreateStatusWindow as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	commctrl.h
Library	Comctl32.lib
DLL	Comctl32.dll

Share via