Функция DrawFrameControl

Функция DrawFrameControl рисует рамку органа управления заданного типа и стиля.

Синтаксис

BOOL DrawFrameControl(
  HDC hdc,     // дескриптор контекста устройства
  LPRECT lprc, // ограничивающий прямоугольник
  UINT uType,  // тип рамки органа управления
  UINT uState  // состояние рамки органа управления
);

Параметры

hdc

[in] Дескриптор контекста устройства окна, в котором рисуется орган управления.

lprc

[in] Указатель на структуру RECT, которая содержит в себе логические координаты ограничивающего прямоугольника для рамки органа управления.

uType

[in] Определяет тип рамки рисуемого органа управления. Этот параметр может быть одним из ниже перечисленных значений.

Значение

Предназначение

DFC_BUTTON Стандартная кнопка
DFC_CAPTION Область заголовка
DFC_MENU Строка меню
DFC_POPUPMENU Windows 98/Me, Windows 2000/XP: Элемент всплывающего меню.
DFC_SCROLL Полоса прокрутки

uState

[in] Устанавливает начальное состояние рамки органа управления. Если uType - DFC_BUTTON, uState может быть одним из ниже перечисленных значений.

Значение

Предназначение

DFCS_BUTTON3STATE Кнопка с тремя состояниями
DFCS_BUTTONCHECK Кнопка-флажок
DFCS_BUTTONPUSH Командная кнопка
DFCS_BUTTONRADIO Радиокнопка
DFCS_BUTTONRADIOIMAGE Изображение радиокнопки (неквадратная форма нуждается в изображении)
DFCS_BUTTONRADIOMASK Маска для радиокнопки (неквадратная форма нуждается в маске),

Если uType - DFC_CAPTION, uState может быть одним из ниже перечисленных значений.

Значение

Предназначение

DFCS_CAPTIONCLOSE Кнопка Закрыть (Close)
DFCS_CAPTIONHELP Кнока Справка (Help)
DFCS_CAPTIONMAX Кнока Развернуть (Maximize)
DFCS_CAPTIONMIN Кнока Свернуть (Minimize)
DFCS_CAPTIONRESTORE Кнока Восстановить (Restore)

Если uType - DFC_MENU, uState может быть одним из ниже перечисленных значений.

Значение

Предназначение

DFCS_MENUARROW Указатель подменю
DFCS_MENUARROWRIGHT Указатель подменю показывается слева. Это используется для каскадных меню, развертываемых справа налево, которые используются с языками написания справа налево, такими как арабские и еврейский языки.
DFCS_MENUBULLET Маркер (Черная жирная точка, квадрат, звездочка и т. д.)
DFCS_MENUCHECK Галочка (Метка выбора внутри кнопки-флажка).

Если uType - DFC_SCROLL, uState может быть одним из ниже перечисленных значений.

Значение

Предназначение

DFCS_SCROLLCOMBOBOX Полоса прокрутки комбинированного окна (поля со списком)
DFCS_SCROLLDOWN Стрелка "Вниз" полосы прокрутки
DFCS_SCROLLLEFT Стрелка "Влево" полосы прокрутки
DFCS_SCROLLRIGHT Стрелка "Вправо" полосы прокрутки
DFCS_SCROLLSIZEGRIP Блок захвата для изменения размера окна в правом нижнем угле окна
DFCS_SCROLLSIZEGRIPRIGHT Блок захвата для изменения размера окна в левом нижнем угле окна. Это используется для к языков написания справа налево, таких как арабские и еврейский языки. 
DFCS_SCROLLUP Стрелка "Вверх" полосы прокрутки

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

Значение

Предназначение

DFCS_ADJUSTRECT Ограничивающий прямоугольник настраивается так, чтобы исключить окружающий край командной кнопки.

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

Значение

Предназначение

DFCS_CHECKED Кнопка отмечена галочкой.
DFCS_FLAT Кнопка имеет плоскую рамку.
DFCS_HOT Windows 98/Me, Windows 2000/XP: Кнопка - оперативно отслеживаемая кнопка.
DFCS_INACTIVE Кнопка неактивна (недоступна).
DFCS_MONO Кнопка имеет монохромную рамку.
DFCS_PUSHED Кнопка нажата.
DFCS_TRANSPARENT Windows 98/Me, Windows 2000/XP: Фон остается нетронутым. Этот флажок можно комбинировать только с флажками DFCS_MENUARROWUP или DFCS_MENUARROWDOWN.

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

Если функция завершается успешно, возвращаемое значение - не нуль.

Если функция завершается ошибкой, возвращаемое значение - нуль.

Windows NT/2000/XP: Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.

Замечания

Если параметр uType - или DFC_MENU или DFC_BUTTON, а параметр uState не DFCS_BUTTONPUSH, то рамка органа управления - черная маска на белом цвете (то есть, черная рамка органа управления на белом фоне. В таких случаях, приложение должно передать дескриптор в устройство управления памятью точечного рисунка. Тогда приложение может использовать ассоциированный точечный рисунок как параметр hbmMask в функции MaskBlt, или может использовать контекст устройства как параметр в функции BitBlt, используя ROPы такие как SRCAND и SRCINVERT.

Смотри также

Обзор Окрашивание и рисование, Функции окрашивания и рисованияRECT

Размещение и совместимость DrawFrameControl

К Windows Vista Да
л Windows XP Да
и Windows 2000 Professional Да
е Windows NT Workstation Да версии 3.51 и выше
н Windows Me Да
т Windows 98 Да
  Windows 95 Да
С Windows Server 2008 Да
е Windows Server 2003 Да
р Windows 2000 Server Да
в Windows NT Server Да версии 3.51 и выше
е
р
Используемая библиотека User32.lib
Используемая DLL -
Заголовочный файл
- объявлено в Winuser.h
- включено в Windows.h
Unicode -
Замечания по платформе Не имеется

Назад в оглавление
На главную страницу
В оглавление справки

Hosted by uCoz