CreateStatusWindow


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.

HWND CreateStatusWindow(
    LONG style, 
    LPCTSTR lpszText, 
    HWND hwndParent, 
    UINT wID
);

Parameters

style
Window styles for the status window. This parameter must include the WS_CHILD style and should also include the WS_VISIBLE style.
lpszText
Address of a null-terminated string that specifies the status text for the first part.
hwndParent
Handle to the parent window.
wID
Control identifier for the status window. The window procedure uses this value to identify messages it sends to the parent window.

Return Values

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

Remarks

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

Requirements

  Windows NT/2000: Requires Windows NT 3.51 or later
  Windows 95/98: Requires Windows 95 or later
  Header: Declared in commctrl.h.
  Import Library: comctl32.lib.

© 2000 Microsoft Corporation. All rights reserved. Terms of use.