CPaneDialog 類別

發行項
08/04/2024

類別 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。

備註

範例

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

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 類別
 視窗樣式

共用方式為