通过

CDialogBar::Create

  • 项目

加载 lpszTemplateName 或 nIDTemplate指定对话框资源模板，创建对话栏窗口中，设置其样式，并将其与 CDialogBar 对象。

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

参数

  • pParentWnd
    对父 CWnd 对象的指针。

  • lpszTemplateName
    为 CDialogBar 对象的对话框资源模板的名称的指针。

  • nStyle
    工具栏样式。支持的其他工具栏样式是:

    • CBRS_TOP 控件条在框架窗口的顶部。

    • CBRS_BOTTOM 控制条在底部框架窗口。

    • 在父调整的大小时，CBRS_NOALIGN 控制条不会重新定位。

    • CBRS_TOOLTIPS 控制条显示工具提示。

    • CBRS_SIZE_DYNAMIC 控制条是动态的。

    • CBRS_SIZE_FIXED 控制条是固定的。

    • CBRS_FLOATING 控制条浮动。

    • CBRS_FLYBY 状态栏显示有关该按钮的信息。

    • CBRS_HIDE_INPLACE 控制条不会显示给用户。

  • nID
    对话栏的控件ID。

  • nIDTemplate
    CDialogBar 对象的对话框模板的资源ID。

返回值

非零，如果成功;否则为0。

备注

如果指定 CBRS_TOP 或 CBRS_BOTTOM 对齐样式，对话栏的宽度是框架窗口，并且其高度。nIDTemplate指定的实该资源。如果指定 CBRS_LEFT 或 CBRS_RIGHT 对齐样式，对话栏的高度是框架窗口，其宽度是 nIDTemplate指定的实该资源。

示例

int CMainFrame::OnCreate(LPCREATESTRUCT lpCreateStruct)
{
   if (CMDIFrameWnd::OnCreate(lpCreateStruct) == -1)
      return -1;

   EnableDocking(CBRS_ALIGN_ANY);

   // m_wndDlgBar is a CDialogBar member of CMainFrame
   // IDD_DIALOGBAR - Resource ID of the dialog 
   // template. This dialog template should be created 
   // with  the  style  WS_CHILD and no other style.
   // The template must not have the style WS_VISIBLE.
   if (!m_wndDlgBar.Create(this, IDD_DIALOGBAR,
      CBRS_LEFT|CBRS_TOOLTIPS|CBRS_FLYBY, IDD_DIALOGBAR))
   {
      TRACE0("Failed to create DlgBar\n");
      return -1;      // Fail to create.
   }

   return 0;
}

要求

Header: afxext.h

请参见

参考

CDialogBar选件类

层次结构图

CDialogBar::CDialogBar