CPaneDialog::Create

更新 : 2007 年 11 月

ドッキング ダイアログ ボックスを作成し、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 
);

パラメータ

  • [入力] lpszWindowName
    ドッキング ダイアログ ボックスの名前。

  • [入力] pParentWnd
    親ウィンドウへのポインタ。

  • [入力] bHasGripper
    キャプション (グリッパ) 付きのドッキング ダイアログ ボックスを作成する場合は TRUE。それ以外の場合は FALSE。

  • [入力] lpszTemplateName
    リソース ダイアログ テンプレートの名前。

  • [入力] nStyle
    ウィンドウ スタイル。

  • [入力] nID
    コントロール ID。

  • [入力] nIDTemplate
    ダイアログ テンプレートのリソース ID。

  • [入力] dwTabbedStyle
    ユーザーが別のコントロール ペインをこのコントロール ペインのキャプションにドラッグしたときに作成されるタブ付きウィンドウのスタイル。既定値は AFX_CBRS_REGULAR_TABS です。詳細については、「CBasePane::CreateEx」メソッドの「解説」を参照してください。

  • [入力] dwControlBarStyle
    追加のスタイル属性。既定値は AFX_DEFAULT_DOCKING_PANE_STYLE です。詳細については、「CBasePane::CreateEx」メソッドの「解説」を参照してください。

戻り値

このメソッドが成功した場合は TRUE。それ以外の場合は FALSE。

使用例

CPaneDialog クラスの Create メソッドの使用方法を次の例に示します。この例は、「SetPaneSize サンプル : アプリケーションのドッキング ペイン サイズの設定」の一部です。

  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

参照

概念

MFC 階層図

参照

CPaneDialog クラス