共用方式為


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

另請參閱

CLIPOBJ

CLIPOBJ_bEnum

DrvBitBlt