PatBlt 函式 (wingdi.h)

PatBlt函式會使用目前選取至指定裝置內容的筆刷繪製指定的矩形。筆刷色彩和表面色彩或色彩會使用指定的點陣作業來結合。

語法

BOOL PatBlt(
  [in] HDC   hdc,
  [in] int   x,
  [in] int   y,
  [in] int   w,
  [in] int   h,
  [in] DWORD rop
);

[in] hdc

裝置內容的控制碼。

[in] x

要填滿之矩形左上角的 x 座標，以邏輯單位表示。

[in] y

要填滿之矩形左上角的 Y 座標，以邏輯單位表示。

[in] w

矩形的寬度，以邏輯單位表示。

[in] h

矩形的高度，以邏輯單位表示。

[in] rop

點陣作業程式碼。此程式碼可以是下列其中一個值。

值	意義
PATCOPY	將指定的模式複製到目的地點陣圖中。
PATINVERT	使用布林 XOR 運算子，結合指定之圖樣的色彩與目的地矩形的色彩。
DSTINVERT	反轉目的地矩形。
黑暗	使用實體調色盤中索引 0 相關聯的色彩填滿目的地矩形。 (在預設實體調色盤中，此色彩為黑色)。
白	使用實體調色盤中索引 1 相關聯的色彩填滿目的地矩形。 (此色彩為預設實體調色盤的白色)。

如果函式成功，則傳回非零的值。

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

此函式 的 dwRop 參數值是完整 256 個三元運算代碼的有限子集;特別是，無法使用參考來源矩形的作業程式碼。

並非所有裝置都支援 PatBlt 函式。如需詳細資訊，請參閱 GetDeviceCaps 函式中RC_BITBLT功能的描述。

For an example, see "Example of Menu-Item Bitmaps" in Using Menus.