Share via


CPaneDialog クラス

このクラスは CPaneDialog 、モードレスのドッキング可能なダイアログ ボックスをサポートします。

構文

class CPaneDialog : public CDockablePane

メンバー

パブリック コンストラクター

名前 説明
CPaneDialog::CPaneDialog 既定のコンストラクターです。
CPaneDialog::~CPaneDialog デストラクターです。

パブリック メソッド

名前 説明
CPaneDialog::Create ドッキング可能なダイアログ ボックスを作成し、オブジェクトに CPaneDialog アタッチします。
CPaneDialog::CreateObject このクラス型の動的インスタンスを作成するために、フレームワークで使用されます。
CPaneDialog::GetThisClass このクラス型に関連付けられている CRuntimeClass オブジェクトへのポインターを取得するためにフレームワークによって使用されます。
CPaneDialog::HandleInitDialog WM_INITDIALOG メッセージを処理します。 (再定義. CBasePane::HandleInitDialog)
CPaneDialog::OnEraseBkgnd WM_ERAStandard Edition BKGND メッセージを処理します。 (再定義 CWnd::OnEraseBkgnd.)
CPaneDialog::OnLButtonDblClk WM_LBUTTONDBLCLK メッセージを処理します。 (再定義 CWnd::OnLButtonDblClk.)
CPaneDialog::OnLButtonDown WM_LBUTTONDOWN メッセージを処理します。 (再定義 CWnd::OnLButtonDown.)
CPaneDialog::OnUpdateCmdUI ダイアログ ボックス ウィンドウを更新するためにフレームワークによって呼び出されます。 (オーバーライド CDockablePane::OnUpdateCmdUI.)
CPaneDialog::OnWindowPosChanging WM_WINDOWPOSCHANGING メッセージを処理します。 (再定義 CWnd::OnWindowPosChanging.)
CPaneDialog::SetOccDialogInfo OLE コントロール コンテナーであるダイアログ ボックスのテンプレートを指定します。

解説

2 つの手順でオブジェクトを CPaneDialog 構築します。 まず、コード内にオブジェクトを構築します。 次に、CPaneDialog::Create を呼び出します。 有効なリソース テンプレート名またはテンプレート ID を指定し、親ウィンドウへのポインターを渡す必要があります。 それ以外の場合、作成プロセスは失敗します。 ダイアログ ボックスでは、WS_CHILDとWS_VISIBLEスタイルを指定する必要があります。 WS_CLIPCHILDRENスタイルとWS_CLIPSIBLINGSスタイルも指定することをお勧めします。 詳細については、「ウィンドウ スタイル」を参照してください。

継承階層

CObject

CCmdTarget

CWnd

CBasePane

Cpane

CDockablePane

CPaneDialog

必要条件

ヘッダー: afxpanedialog.h

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);

パラメーター

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

pParentWnd
[in]親ウィンドウをポイントします。

bHasGripper
[in]キャプション (グリッパー) でドッキング ダイアログ ボックスを作成する場合は TRUE。それ以外の場合は FAL Standard Edition。

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

nStyle
[in]Windows スタイル。

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

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

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

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

戻り値

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

解説

次の例では、クラスでメソッドを使用する Create 方法を CPaneDialog 示します。 この例は、Set Pane Size サンプル一部です。

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
}

CPaneDialog::HandleInitDialog

WM_INITDIALOG メッセージを処理します。

afx_msg LRESULT HandleInitDialog(
    WPARAM wParam,
    LPARAM lParam);

パラメーター

wParam
[in]既定のキーボード フォーカスを受け取るコントロールを処理します。

lParam
[in]追加の初期化データを指定します。

戻り値

このメソッドが成功した場合は TRUE。それ以外の場合は FAL Standard Edition。 さらに、TRUE は、キーボード フォーカスを wParam パラメーターで指定されたコントロールに設定します。FAL Standard Edition では、既定のキーボード フォーカスを設定できなくなります。

解説

フレームワークでは、このメソッドを使用して、コントロールとダイアログ ボックスの外観を初期化します。 フレームワークは、ダイアログ ボックスを表示する前に、このメソッドを呼び出します。

CPaneDialog::SetOccDialogInfo

OLE コントロール コンテナーであるダイアログ ボックスのテンプレートを指定します。

virtual BOOL SetOccDialogInfo(_AFX_OCC_DIALOG_INFO* pOccDialogInfo);

パラメーター

pOccDialogInfo
[in]ダイアログ ボックス オブジェクトの作成に使用されるダイアログ ボックス テンプレートへのポインター。 このパラメーターの値は、その後 COccManager::CreateDlgControls メソッドに渡されます。

戻り値

常に TRUE。

解説

このメソッドは、OLE コントロール サイトと ActiveX コントロールを管理する COccManager クラスをサポートしています。 _AFX_OCC_DIALOG_INFO構造体は、afxocc.h ヘッダー ファイルで定義されます。

関連項目

階層図
クラス
CDockablePane クラス
ウィンドウ スタイル