setBoundsRect 函式 (wingdi.h)

SetBoundsRect函式會控制指定裝置內容的周框資訊的累積。系統可以維護所有繪圖作業的周框。應用程式可以檢查並設定此矩形。繪圖界限有助於使點陣圖快取失效。

語法

UINT SetBoundsRect(
  [in] HDC        hdc,
  [in] const RECT *lprect,
  [in] UINT       flags
);

[in] hdc

要累積周框之裝置內容的控制碼。

[in] lprect

用來設定周框之 RECT 結構的指標。矩形維度位於邏輯座標中。此參數可以是 Null。

[in] flags

指定新矩形如何與累積矩形結合。此參數可以是下列其中一個值。

值	意義
DCB_ACCUMULATE	使用矩形聯集作業) ，將 lprcBounds 參數指定的矩形新增至周框 (。使用 DCB_RESET 和 DCB_ACCUMULATE會將周框設定為 lprcBounds 參數所指定的矩形。
DCB_DISABLE	關閉界限累積。
DCB_ENABLE	開啟界限累積，預設為停用。
DCB_RESET	清除周框。

如果函式成功，傳回值會指定周框的先前狀態。此狀態可以是下列值的組合。

值	意義
DCB_DISABLE	界限累積已關閉。
DCB_ENABLE	界限累積已開啟。 DCB_ENABLE和DCB_DISABLE互斥。
DCB_RESET	周框是空的。
DCB_SET	周框不是空的。 DCB_SET和DCB_RESET互斥。

如果此函式失敗，則傳回值為零。

DCB_SET值是位值的組合，DCB_ACCUMULATE和DCB_RESET。檢查DCB_RESET位的應用程式，以判斷周框是否為空的，也必須檢查DCB_ACCUMULATE位。只有當DCB_RESET位為 1 且DCB_ACCUMULATE位為 0 時，周框才會是空的。