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_ERASEBKGND メッセージを処理します。 ( を再定義します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スタイルも指定することをお勧めします。 詳細については、「ウィンドウ スタイル」を参照してください。
継承階層
要件
Header: 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。それ以外の場合は FALSE。
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。それ以外の場合は FALSE。
解説
例
次の例では、CPaneDialog クラスで Create メソッドを使用する方法を示します。 この例は、 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。それ以外の場合は FALSE。 さらに、TRUE は、 wParam パラメーターで指定されたコントロールにキーボード フォーカスを設定します。FALSE を指定すると、既定のキーボード フォーカスが設定できなくなります。
解説
フレームワークでは、このメソッドを使用して、コントロールとダイアログ ボックスの外観を初期化します。 フレームワークは、ダイアログ ボックスを表示する前に、このメソッドを呼び出します。
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 ヘッダー ファイルで定義されます。