Класс CPaneDialog

Замечание

Библиотека классов Microsoft Foundation (MFC) продолжает поддерживаться. Однако мы больше не добавляем функции или обновляем документацию.

Класс 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. Дополнительные сведения см. в разделе "Стили окон".

Иерархия наследования

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] ЗНАЧЕНИЕ 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
Стили окна