CPaneDialog 类

项目
10/18/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。必须指定有效的资源模板名称或模板 ID，并传递指向父窗口的指针。否则，创建过程会失败。对话框必须指定 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] Ture，使用标题 (手柄) 创建可停靠对话框；否则为 FALSE。

lpszTemplateName
[in] 资源对话框模板的名称。

nStyle
[in] Windows 样式。

nID
[in] 控件 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 方法。此示例是设置窗格大小示例的一部分。

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 类
 窗口样式

Share via