CPaneDialog::Create

创建一个停靠对话框并将它附加到 CPaneDialog 对象。

BOOL Create(
   LPCTSTR lpszWindowName,
   CWnd* pParentWnd,
   BOOL bHasGripper,
   LPCTSTR lpszTemplateName,
   UINT nStyle,
   UINT nID,
   DWORD dwTabbedStyle= AFX_CBRS_REGULAR_TABS,
   DWORD dwControlBarStyle=AFX_DEFAULT_DOCKING_PANE_STYLE
);
BOOL Create(
   LPCTSTR lpszWindowName,
   CWnd* pParentWnd,
   BOOL bHasGripper,
   UINT nIDTemplate,
   UINT nStyle,
   UINT nID 
);
BOOL Create(
   CWnd* pParentWnd,
   LPCTSTR lpszTemplateName,
   UINT nStyle,
   UINT nID 
);
BOOL Create(
   CWnd* pParentWnd,
   UINT nIDTemplate,
   UINT nStyle,
   UINT nID 
);

参数

  • [in] lpszWindowName
    停靠对话框的名称。

  • [in] pParentWnd
    指向父窗口。

  • [in] bHasGripper
    创建一个停靠对话框的TRUE 用声明(手柄);否则,FALSE。

  • [in] lpszTemplateName
    资源对话框模板的名称。

  • [in] nStyle
    Windows样式。

  • [in] nID
    控件 ID。

  • [in] nIDTemplate
    对话框模板的资源ID。

  • [in] dwTabbedStyle
    当用户拖动该控件窗格的声明上,另一个控件窗格该选项卡式窗口的样式发生。默认值为 AFX_CBRS_REGULAR_TABS。有关更多信息,请参见 CBasePane::CreateEx 方法的"备注"节。

  • [in] dwControlBarStyle
    附加样式属性。默认值为 AFX_DEFAULT_DOCKING_PANE_STYLE。有关更多信息,请参见 CBasePane::CreateEx 方法的"备注"节。

返回值

如果此方法成功,则为 TRUE;否则为 FALSE。

示例

下面的示例在 CPaneDialog 选件类演示如何使用 Create 方法。此示例是 设置窗格大小示例的一部分。

    CPaneDialog     m_wndDlgBar;


...


    // The this pointer points to a CMainFrame class which extends the CFrameWnd class.
    if (!m_wndDlgBar.Create (_T("DialogBar"), this, TRUE, 
                             MAKEINTRESOURCE (IDD_DLG_BAR), 
                             WS_CHILD | WS_VISIBLE | WS_CLIPSIBLINGS | WS_CLIPCHILDREN | CBRS_LEFT | CBRS_FLOAT_MULTI, 
                             ID_VIEW_DLGBAR))
    {
        TRACE0("Failed to create Dialog Bar\n");
        return FALSE;      // fail to create
    }

要求

标头: afxpanedialog.h

请参见

参考

CPaneDialog选件类

层次结构图