CDialogBar::Create

BOOL Create( CWnd* pParentWnd, LPCTSTR lpszTemplateName, UINT nStyle, UINT nID );

BOOL Create( CWnd* pParentWnd, UINT nIDTemplate, UINT nStyle, UINT nID );

Return Value

Nonzero if successful; otherwise 0.

Parameters

pParentWnd

A pointer to the parent CWnd object.

lpszTemplateName

A pointer to the name of the CDialogBar object’s dialog-box resource template.

nStyle

The alignment style of the dialog bar. The following styles are supported:

• CBRS_TOP   Control bar is at the top of the frame window.
  
  
• CBRS_BOTTOM   Control bar is at the bottom of the frame window.
  
  
• CBRS_NOALIGN   Control bar is not repositioned when the parent is resized.
  
  
• CBRS_LEFT   Control bar is at the left of the frame window.
  
  
• CBRS_RIGHT   Control bar is at the right of the frame window.

nID

The control ID of the dialog bar.

nIDTemplate

The resource ID of the CDialogBar object’s dialog-box template.

Remarks

Loads the dialog-box resource template specified by lpszTemplateName or nIDTemplate, creates the dialog-bar window, sets its style, and associates it with the CDialogBar object.

If you specify the CBRS_TOP or CBRS_BOTTOM alignment style, the dialog bar’s width is that of the frame window and its height is that of the resource specified by nIDTemplate. If you specify the CBRS_LEFT or CBRS_RIGHT alignment style, the dialog bar’s height is that of the frame window and its width is that of the resource specified by nIDTemplate.

CDialogBar Overview |  Class Members |  Hierarchy Chart

See Also   CDialogBar::CDialogBar