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 に関連付けられた色を使用して、コピー先の四角形を塗りつぶします。この色は、既定の物理パレットの場合は白です。

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。

この関数の dwRop パラメーターの値は、完全な 256 三項ラスター演算コードの限定されたサブセットです。特に、ソース四角形を参照する操作コードは使用できません。

すべてのデバイスが PatBlt 機能をサポートしているわけではありません。詳細については、 GetDeviceCaps 関数のRC_BITBLT機能の説明を参照してください。

例については、「メニューの使用」の「Menu-Item ビットマップの例」を参照してください。


サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	wingdi.h (Windows.h を含む)
Library	Gdi32.lib
[DLL]	Gdi32.dll