CLIPOBJ_cEnumStart函数 (winddi.h)

CLIPOBJ_cEnumStart 函数设置用于枚举指定剪辑区域中的矩形的参数。

语法

ENGAPI ULONG CLIPOBJ_cEnumStart(
  [in] CLIPOBJ *pco,
  [in] BOOL    bAll,
  [in] ULONG   iType,
  [in] ULONG   iDirection,
  [in] ULONG   cLimit
);

参数

[in] pco

指向 CLIPOBJ 结构的指针，该结构定义要枚举的剪辑区域。

[in] bAll

指定是否应枚举整个区域。 如果应枚举整个区域，则此参数为 TRUE 。 如果仅应枚举与当前绘图操作相关的部分，则为 FALSE 。

缓存剪辑区域的驱动程序必须枚举整个区域。

[in] iType

指定要由 CLIPOBJ_bEnum写入的数据结构。 此参数当前必须CT_RECTANGLES，表示要枚举为矩形列表的区域。

[in] iDirection

确定枚举矩形的顺序。 如果 DrvBitBlt 操作在同一图面上同时执行，则此顺序可能至关重要。 如果顺序与设备驱动程序无关，则应为复杂区域指定CD_ANY，以便 GDI 优化枚举。 此值可以为下列值之一：

值	含义
CD_ANY	任何方便 GDI 的订单。
CD_LEFTDOWN	从右到左，从上到下。
CD_LEFTUP	从右到左，从下到上。
CD_RIGHTDOWN	从左到右，从上到下。
CD_RIGHTUP	从左到右，从下到上。

[in] cLimit

指定要枚举的最大矩形数。 如果此参数为零，则省略计数。

返回值

返回值是枚举矩形的计数。 如果计数超过 cLimit，则返回值为0xFFFFFFFF。

备注

无论是否调用此函数，都可以枚举区域。 默认情况下，驱动程序仅枚举从左上角开始的相关矩形。

驱动程序可以通过再次调用此函数来重启枚举。

要求

最低受支持的客户端	适用于 Windows 2000 及更高版本的 Windows 操作系统。
目标平台	通用
标头	winddi.h (包括 Winddi.h)
Library	Win32k.lib
DLL	Win32k.sys

另请参阅

CLIPOBJ

CLIPOBJ_bEnum

DrvBitBlt