Export (0) Print
Expand All

CStatic::Create 

Creates the Windows static control and attaches it to the CStatic object.


virtual BOOL Create(
   LPCTSTR lpszText,
   DWORD dwStyle,
   const RECT& rect,
   CWnd* pParentWnd,
   UINT nID = 0xffff 
);

Parameters

lpszText

Specifies the text to place in the control. If NULL, no text will be visible.

dwStyle

Specifies the static control's window style. Apply any combination of static control styles to the control.

rect

Specifies the position and size of the static control. It can be either a RECT structure or a CRect object.

pParentWnd

Specifies the CStatic parent window, usually a CDialog object. It must not be NULL.

nID

Specifies the static control's control ID.

Nonzero if successful; otherwise 0.

Construct a CStatic object in two steps. First, call the constructor CStatic, and then call Create, which creates the Windows static control and attaches it to the CStatic object.

Apply the following window styles to a static control:

  • WS_CHILD   Always

  • WS_VISIBLE   Usually

  • WS_DISABLED   Rarely

If you're going to display a bitmap, cursor, icon, or metafile in the static control, you'll need to apply one of the following static styles:

  • SS_BITMAP   Use this style for bitmaps.

  • SS_ICON   Use this style for cursors and icons.

  • SS_ENHMETAFILE   Use this style for enhanced metafiles.

For cursors, bitmaps, or icons, you may also want to use the following style:

  • SS_CENTERIMAGE   Use to center the image in the static control.

CStatic myStatic;

// Create a child static control that centers its text horizontally.
myStatic.Create(_T("my static"), WS_CHILD|WS_VISIBLE|SS_CENTER, 
   CRect(10,10,150,50), pParentWnd);

Community Additions

ADD
Show:
© 2014 Microsoft