Класс CMFCDropDownFrame

Предоставляет функции раскрывающегося окна кадров для раскрывающихся панелей инструментов и кнопок раскрывающегося списка.

Синтаксис

class CMFCDropDownFrame : public CMiniFrameWnd

Участники

Открытые конструкторы

Имя	Описание
CMFCDropDownFrame::CMFCDropDownFrame	Конструктор по умолчанию.
CMFCDropDownFrame::~CMFCDropDownFrame	Деструктор.

Открытые методы

Имя	Описание
CMFCDropDownFrame::Create	Создает объект CMFCDropDownFrame.
CMFCDropDownFrame::CreateObject	Используется платформой для создания динамического экземпляра этого типа класса.
CMFCDropDownFrame::GetParentMenuBar	Извлекает родительскую строку меню раскрывающегося списка.
CMFCDropDownFrame::GetParentPopupMenu	Извлекает родительское всплывающее меню раскрывающегося списка.
CMFCDropDownFrame::GetThisClass	Используется платформой для получения указателя на объект CRuntimeClass , связанный с этим типом класса.
CMFCDropDownFrame::RecalcLayout	Переместит раскрывающийся кадр.
CMFCDropDownFrame::SetAutoDesk	Задает, уничтожается ли дочернее раскрывающееся окно панели инструментов автоматически.

Замечания

Этот класс не предназначен для использования непосредственно из кода.

Платформа использует этот класс для обеспечения поведения кадра CMFCDropDownToolbar для классов и CMFCDropDownToolbarButton классов. Дополнительные сведения об этих классах см. в разделе CMFCDropDownToolBar Class и CMFCDropDownToolbarButton Class.

Пример

В следующем примере показано, как получить указатель на CMFCDropDownFrame объект из CFrameWnd класса и как настроить автоматическое удаление дочернего раскрывающегося окна панели инструментов.

CFrameWnd *pTopFrame = AFXGetParentFrame(this);
if (pTopFrame == NULL)
{
   return FALSE;
}

CMFCDropDownFrame *pDropFrame = DYNAMIC_DOWNCAST(CMFCDropDownFrame, pTopFrame);
pDropFrame->SetAutoDestroy(true);

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

CObject

CCmdTarget

CWnd

CFrameWnd

CMiniFrameWnd

CMFCDropDownFrame

Требования

Заголовок: afxdropdowntoolbar.h

CMFCDropDownFrame::Create

Создает объект CMFCDropDownFrame.

virtual BOOL Create(
    CWnd* pWndParent,
    int x,
    int y,
    CMFCDropDownToolBar* pWndOriginToolbar);

Параметры

pWndParent
[in] Родительское окно раскрывающегося кадра.

x
[in] Горизонтальная координата экрана для расположения нижнего кадра.

г
[in] Координата вертикального экрана для расположения нижнего кадра.

pWndOriginToolbar
[in] Панель инструментов с раскрывающимися кнопками, которые этот метод использует для заполнения нового раскрывающегося объекта кадра.

Возвращаемое значение

ЗНАЧЕНИЕ TRUE, если раскрывающийся кадр был успешно создан; в противном случае ЗНАЧЕНИЕ FALSE.

Замечания

Этот метод вызывает базовый метод CMiniFrameWnd::CreateEx для создания раскрывающегося окна кадра с WS_POPUP стилем. Окно раскрывающегося окна отображается в указанных координатах экрана. Этот метод завершается ошибкой , если метод CMiniFrameWnd::CreateEx возвращает ЗНАЧЕНИЕ FALSE.

Класс CMFCDropDownFrame создает копию предоставленного CMFCDropDownToolBar параметра. Этот метод копирует изображения кнопки и состояния кнопки из pWndOriginToolbar параметра в m_pWndOriginToolbar элемент данных.

CMFCDropDownFrame::GetParentMenuBar

Извлекает родительскую строку меню раскрывающегося списка.

CMFCMenuBar* GetParentMenuBar() const;

Возвращаемое значение

Указатель на панель родительского меню раскрывающегося списка или NULL, если кадр не имеет родительского элемента.

Замечания

Этот метод извлекает панель родительского меню из родительской кнопки. Этот метод возвращает значение NULL, если раскрывающийся кадр не имеет родительской кнопки или у родительской кнопки нет родительской строки меню.

CMFCDropDownFrame::GetParentPopupMenu

Извлекает родительское всплывающее меню раскрывающегося списка.

CMFCDropDownFrame* GetParentPopupMenu() const;

Возвращаемое значение

Указатель на родительское раскрывающееся меню раскрывающегося списка или NULL, если у кадра нет родительского элемента.

Замечания

Этот метод извлекает родительское меню из родительской кнопки. Этот метод возвращает значение NULL, если раскрывающийся кадр не имеет родительской кнопки или родительская кнопка не имеет родительского меню.

CMFCDropDownFrame::RecalcLayout

Переместит раскрывающийся кадр.

virtual void RecalcLayout(BOOL bNotify = TRUE);

Параметры

bNotify
[in] Неиспользованный.

Замечания

Платформа вызывает этот метод при создании раскрывающегося кадра или изменении размера родительского окна. Этот метод вычисляет положение и размер раскрывающегося кадра с помощью позиции и размера родительского окна.

CMFCDropDownFrame::SetAutoDesk

Задает, уничтожается ли дочернее раскрывающееся окно панели инструментов автоматически.

void SetAutoDestroy(BOOL bAutoDestroy = TRUE);

Параметры

bAutoDesk
[in] ЗНАЧЕНИЕ TRUE для автоматического уничтожения связанного раскрывающегося окна панели инструментов; в противном случае — ЗНАЧЕНИЕ FALSE.

Замечания

Если bAutoDesk is TRUE, CMFCDropDownFrame деструктор уничтожает связанное окно панели инструментов раскрывающегося списка. Значение по умолчанию — TRUE.

См. также

Диаграмма иерархии
Классы
Класс CMFCDropDownToolBar
Класс CMFCDropDownToolbarButton