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 控件容器的对话框的模板。

备注

分两步构造 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] 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 类
窗口样式