Share via


CStatusBar::CreateEx

Call this function to create a status bar (a child window) and associate it with the CStatusBar object.

virtual BOOL CreateEx( 
   CWnd* pParentWnd, 
   DWORD dwCtrlStyle = 0 , 
   DWORD dwStyle = WS_CHILD | WS_VISIBLE | CBRS_BOTTOM, 
   UINT nID = AFX_IDW_STATUS_BAR );

Parameters

  • pParentWnd
    Pointer to the CWnd object whose Windows window is the parent of the status bar.

  • dwCtrlStyle
    Additional styles for the creation of the embedded CStatusBarCtrl object. The default specifies a status bar without a sizing grip or tooltip support. Status bar styles supported are:

    • SBARS_SIZEGRIP   The status bar control includes a sizing grip at the right end of the status bar. A sizing grip is similar to a sizing border; it is a rectangular area that the user can click and drag to resize the parent window.

    • SBT_TOOLTIPS   The status bar supports tooltips.

    For details on these styles, see Settings for the CStatusBarCtrl.

  • dwStyle
    The status bar style. The default specifies that a visible status bar be created at the bottom of the frame window. Apply any combination of status bar control styles listed in Window Styles and CDialogBar::Create. However, this parameter should always include the WS_CHILD and WS_VISIBLE styles.

  • nID
    The status bar's child-window ID.

Return Value

Nonzero if successful; otherwise 0.

Remarks

This function also sets the initial font and sets the status bar's height to a default value.

Use CreateEx, instead of Create, when certain styles need to be present during the creation of the embedded status bar control. For example, set dwCtrlStyle to SBT_TOOLTIPS to display tooltips in a status bar object.

Requirements

Header: afxext.h

See Also

Reference

CStatusBar Class

Hierarchy Chart