CPaneDialog 類別

發行項
10/12/2023

類別 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 控制項容器之對話方塊的範本。

備註

CPaneDialog在兩個步驟中建構物件。首先，在程式碼中建構物件。其次，呼叫 CPaneDialog：：Create 。您必須指定有效的資源範本名稱或範本識別碼，並將指標傳遞至父視窗。否則，建立程式會失敗。對話方塊必須指定WS_CHILD和WS_VISIBLE樣式。建議您也指定WS_CLIPCHILDREN和WS_CLIPSIBLINGS樣式。如需詳細資訊，請參閱視窗樣式。

繼承階層架構

需求

標頭： 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
[in]控制項識別碼。

nIDTemplate
[in]對話方塊範本的資源識別碼。

dwTabbedStyle
[in]當使用者將另一個控制項窗格拖曳至此控制項窗格的標題時，所產生之索引標籤視窗的樣式。預設值為 AFX_CBRS_REGULAR_TABS。如需詳細資訊，請參閱 CBasePane：：CreateEx 方法的一節。

dwControlBarStyle
[in]其他樣式屬性。預設值為 AFX_DEFAULT_DOCKING_PANE_STYLE。如需詳細資訊，請參閱 CBasePane：：CreateEx 方法的一節。

傳回值

如果此方法成功，則為 TRUE;否則為 FALSE。

備註

範例

下列範例示範如何在類別中使用 CreateCPaneDialog 方法。此範例是設定窗格大小範例的一部分。

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。

備註

此方法支援 COccManager 類別，可管理 OLE 控制項月臺和 ActiveX 控制項。 _AFX_OCC_DIALOG_INFO 結構定義于 afxocc.h 標頭檔中。

另請參閱

階層架構圖表
 類別
 CDockablePane 類別
 視窗樣式

共用方式為