Класс CMiniFrameWnd

  • Статья

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

Синтаксис

class CMiniFrameWnd : public CFrameWnd

Участники

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

Имя Описание
CMiniFrameWnd::CMiniFrameWnd Формирует объект CMiniFrameWnd.

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

Имя Описание
CMiniFrameWnd::Create CMiniFrameWnd Создает объект после построения.
CMiniFrameWnd::CreateEx CMiniFrameWnd Создает объект (с дополнительными параметрами) после построения.

Замечания

Эти окна мини-фрейма работают как обычные окна кадров, за исключением того, что они не имеют кнопок или меню свернуть или развернуть их, и вам нужно только один раз щелкнуть системное меню, чтобы закрыть их.

Чтобы использовать CMiniFrameWnd объект, сначала определите объект. Затем вызовите функцию создания элемента, чтобы отобразить окно мини-кадра.

Дополнительные сведения об использовании CMiniFrameWnd объектов см. в статье "Закрепление и плавающая панель инструментов".

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

CObject

CCmdTarget

CWnd

CFrameWnd

CMiniFrameWnd

Требования

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

CMiniFrameWnd::CMiniFrameWnd

CMiniFrameWnd Создает объект, но не создает окно.

CMiniFrameWnd();

Замечания

Чтобы создать окно, вызовите CMiniFrameWnd::Create.

CMiniFrameWnd::Create

Создает окно мини-кадра Windows и присоединяет его к объекту CMiniFrameWnd .

virtual BOOL Create(
    LPCTSTR lpClassName,
    LPCTSTR lpWindowName,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd = NULL,
    UINT nID = 0);

Параметры

lpClassName
Указывает на строку символов, завершающую значение NULL, которая называет класс Windows. Имя класса может быть любым именем, зарегистрированным в глобальной функции AfxRegisterWndClass . Если значение NULL, класс окна будет зарегистрирован платформой. MFC предоставляет класс по умолчанию следующим стилям и атрибутам:

  • Задает бит стиля CS_DBLCLKS, который отправляет сообщения дважды щелкните в процедуру окна, когда пользователь дважды щелкает мышь.

  • Задает биты стиля CS_HREDRAW и CS_VREDRAW, которые направляют содержимое клиентской области, которую необходимо перенаправить при изменении размера окна.

  • Задает курсор класса стандартной IDC_ARROW Windows.

  • Задает фоновую кисть класса значение NULL, поэтому окно не стирает его фон.

  • Задает значок класса на стандартный значок логотипа Windows с флагом waving.

  • Задает размер и позицию окна по умолчанию, как указано в Windows.

lpWindowName
Указывает на строку символов, завершающую значение NULL, содержащую имя окна.

dwStyle
Задает атрибуты стиля окна. Они могут включать стандартные стили окон и один или несколько из следующих специальных стилей:

  • MFS_MOVEFRAME Позволяет перемещать окно мини-кадра, щелкнув любой край окна, а не только подпись.

  • MFS_4THICKFRAME Отключает изменение размера окна мини-кадра.

  • MFS_SYNCACTIVE синхронизирует активацию мини-фрейма с активацией родительского окна.

  • MFS_THICKFRAME позволяет размеру окна мини-кадра как небольшого размера, так как содержимое клиентской области разрешено.

  • MFS_BLOCKSYSMENU Отключает доступ к системным меню и меню управления и преобразует их в часть подпись (строка заголовка).

См. раздел CWnd::Create для описания возможных значений стиля окна. Типичное сочетание, используемое для окон WS_POPUP|WS_CAPTION|WS_SYSMENUмини-фрейма.

rect
Структура RECT , указывающая требуемые размеры окна.

pParentWnd
Указывает на родительское окно. Используйте ЗНАЧЕНИЕ NULL для окон верхнего уровня.

Nid
Если окно мини-кадра создается в качестве дочернего окна, это идентификатор дочернего элемента управления; в противном случае — 0.

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

Имеет ненулевое значение в случае успешного выполнения, иначе — 0.

Замечания

Create инициализирует имя класса окна и имя окна и регистрирует значения по умолчанию для его стиля и родительского элемента.

CMiniFrameWnd::CreateEx

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

virtual BOOL CreateEx(
    DWORD dwExStyle,
    LPCTSTR lpClassName,
    LPCTSTR lpWindowName,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd = NULL,
    UINT nID = 0);

Параметры

dwExStyle
Задает расширенный стиль создаваемого CMiniFrameWnd объекта. Примените к окну любой из расширенных стилей окон.

lpClassName
Указывает на строку символов, завершающую значение NULL, которая называет класс Windows ( структура WNDCLASS ). Имя класса может быть любым именем, зарегистрированным в глобальной функции AfxRegisterWndClass или любым из предопределенных имен классов управления. Он не должен иметь значение NULL.

lpWindowName
Указывает на строку символов, завершающую значение NULL, содержащую имя окна.

dwStyle
Задает атрибуты стиля окна. См. статью "Стили окон" и "CWnd::Create " для описания возможных значений.

rect
Размер и положение окна в координатах клиента pParentWnd.

pParentWnd
Указывает на родительский объект окна.

Nid
Идентификатор дочернего окна.

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

Возвращает значение TRUE при успешном выполнении, false при сбое.

Замечания

Параметры CreateEx указывают начальную позицию и размер окна WNDCLASS, стиль окна и (необязательно). CreateEx также указывает родительский объект окна (если он есть) и идентификатор.

При CreateEx выполнении Windows отправляет WM_GETMINMAXINFO, WM_NCCREATE, WM_NCCALCSIZE и WM_CREATE сообщения в окно.

Чтобы расширить обработку сообщений по умолчанию, наследуйте класс, CMiniFrameWndдобавьте карту сообщений в новый класс и предоставьте функции-члены для указанных выше сообщений. Переопределите OnCreate, например, чтобы выполнить необходимую инициализацию для нового класса.

Переопределите дополнительные Onобработчики сообщений сообщений , чтобы добавить дополнительные функциональные возможности в производный класс.

Если задан стиль WS_VISIBLE, Windows отправляет окно всем сообщениям, необходимым для активации и отображения окна. Если стиль окна задает заголовок, в строке заголовка отображается заголовок окна, на который указывает параметр lpszWindowName .

Параметр dwStyle может быть любым сочетанием стилей окон.

Окна панели элементов палитры старого стиля больше не поддерживаются. Старый стиль, который не имеет кнопки "X" Close, был поддерживается при запуске приложения MFC в предыдущих версиях Windows, но больше не поддерживается в Visual C++.NET. Теперь поддерживается только новый стиль WS_EX_TOOLWINDOW; Описание этого стиля см. в разделе "Расширенные стили окон".

См. также

Класс CFrameWnd
Диаграмма иерархии
Класс CFrameWnd