Share via


CreateStatusWindow

This function 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, 
LPSTR lpszText, 
HWND hwndParent, 
WORD 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
    Long pointer to a null-terminated string that contains 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

The handle for the status window indicates success. NULL indicates failure. 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

Runs on Versions Defined in Include Link to
Windows CE OS 1.0 and later Commctrl.h   Commctrl.lib

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

CreateWindow, GetLastError

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.