Функция DrawFrameControl рисует рамку органа управления заданного типа и стиля.
BOOL DrawFrameControl( HDC hdc, // дескриптор контекста устройства LPRECT lprc, // ограничивающий прямоугольник UINT uType, // тип рамки органа управления UINT uState // состояние рамки органа управления ); |
[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 | - | |
| Замечания по платформе | Не имеется | |