CListCtrl::CreateEx

Creates a control (a child window) and associates it with the CListCtrl object.

virtual BOOL CreateEx(
   DWORD dwExStyle,
   DWORD dwStyle,
   const RECT& rect,
   CWnd* pParentWnd,
   UINT nID 
);

Parameters

  • dwExStyle
    Specifies the extended style of the control being created. For a list of extended Windows styles, see the dwExStyle parameter for CreateWindowEx in the Windows SDK.

  • dwStyle
    Specifies the list control's style. Apply any combination of list control styles to the control. For a complete list of these styles, see List view window styles in the Windows SDK.

  • rect
    A reference to a RECT structure describing the size and position of the window to be created, in client coordinates of pParentWnd.

  • pParentWnd
    A pointer to the window that is the control's parent.

  • nID
    The control's child-window ID.

Return Value

Nonzero if successful; otherwise 0.

Remarks

Use CreateEx instead of Create to apply extended Windows styles, specified by the Windows extended style preface WS_EX_.

CreateEx creates the control with the extended Windows styles specified by dwExStyle. To set extended styles specific to a control, call SetExtendedStyle. For example, use CreateEx to set such styles as WS_EX_CONTEXTHELP, but use SetExtendedStyle to set such styles as LVS_EX_FULLROWSELECT. For more information, see the styles described in the topic Extended List View Styles in the Windows SDK.

Requirements

Header: afxcmn.h

See Also

Concepts

CListCtrl Class

CListCtrl Members

Hierarchy Chart

CListCtrl::CListCtrl