DrawFrameControl

描述

DrawFrameControl函数绘制指定类型和样式的框架控件。

C++ 语法

BOOL DrawFrameControl(

__in HDC hdc,

__in LPRECT lprc,

__in UINT uType,

__in UINT uState

);

PowerBASIC 语法

FUNCTION DrawFrameControl ( _

BYVAL hdc AS DWORD, _

BYREF lprc AS RECT, _

BYVAL uType AS DWORD, _

BYVAL uState AS DWORD _

) AS LONG

参数

hdc

[in]处理要绘制控件的窗口的设备上下文。

lprc

[in]指向RECT结构的指针，其中包含框架控件的边界矩形的逻辑坐标。

uType

[in]指定要绘制的框架控件的类型。此参数可以是以下值之一。

值	含义
DFC_BUTTON	标准按钮
DFC_CAPTION	标题栏
DFC_MENU	菜单栏
DFC_POPUPMENU	Windows 98 / Me，Windows 2000 / XP / Vista / Windows 7：弹出菜单项。
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	关按钮
DFCS_CAPTIONHELP	帮帮我按钮
DFCS_CAPTIONMAX	最大化按钮
DFCS_CAPTIONMIN	最小化按钮
DFCS_CAPTIONRESTORE	恢复按钮

如果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 / Vista / Windows 7：按钮被热跟踪。
DFCS_INACTIVE	按钮无效（灰色）。
DFCS_MONO	按钮有单色边框。
DFCS_PUSHED	按钮被推
DFCS_TRANSPARENT	Windows 98 / Me，Windows 2000 / XP / Vista / Windows 7：背景保持不变。该标志只能与DFCS_MENUARROWUP或DFCS_MENUARROWDOWN组合。

返回值

如果函数成功，返回值不为零。

如果函数失败，返回值为零。

备注

如果UTYPE是DFC_MENU或DFC_BUTTON，并且uState不是DFCS_BUTTONPUSH，则帧控件是黑白色掩码（即，白色背景上的黑框控件）。在这种情况下，应用程序必须将句柄传递给位图存储设备控件。然后，应用程序可以使用关联的位图作为MaskBlt函数的hbmMask参数，或者可以使用ROC（如SRCAND和SRCINVERT）将设备上下文用作BitBlt函数的参数。

引用文件 #INCLUDE Once

WinUser.inc（包括Windows.inc）