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 作業系統。 |
目標平台 | Universal |
標頭 | winddi.h (包含 Winddi.h) |
程式庫 | Win32k.lib |
Dll | Win32k.sys |