指定されたデバイス上にビット パターンを作成します。
BOOL PatBlt( int x, int y, int nWidth, int nHeight, DWORDdwRop );
パラメータ
- x
-
パターンを受け取る四角形の左上隅の論理 x 座標を指定します。
- y
-
パターンを受け取る四角形の左上隅の論理 y 座標を指定します。
- nWidth
-
パターンを受け取る四角形の幅を指定します (論理単位)。
- nHeight
-
パターンを受け取る四角形の高さを指定します (論理単位)。
- dwRop
-
ラスタ オペレーション コードを指定します。ラスタ オペレーション コード (ROP) は、現在のブラシ、可能な転送元のビットマップ、転送先のビットマップが関係する出力操作において、GDI がどのようにそれぞれの色を組み合わせるかを定義します。このパラメータは、次のいずれかの値になります。
-
PATCOPY パターンを転送先のビットマップにコピーします。
-
PATINVERT 論理 XOR 演算子を使ってパターンを転送先ビットマップと組み合わせます。
-
DSTINVERT 転送先のビットマップを反転します。
-
BLACKNESS すべての出力を黒にします。
-
WHITENESS すべての出力を白にします。
-
正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。
パターンは、選択されたブラシと既にデバイス上にあるパターンを組み合わせたものです。dwRop で指定されたラスタ オペレーション コードは、どのようにパターンを組み合わせるかを定義します。この関数で一覧したラスタ オペレーションは、256 の三項ラスタ オペレーション コードの制限付きサブセットです。特に、転送元を参照するオペレーション コードは使用できません。
すべてのデバイス コンテキストが PatBlt 関数をサポートするわけではありません。デバイス コンテキストが PatBlt 関数をサポートするかどうかを調べるには、RASTERCAPS インデックスを指定して GetDeviceCaps メンバ関数を呼び出し、戻り値の RC_BITBLT フラグをチェックしてください。
関連項目
CDC クラス階層図
CDC::GetDeviceCaps
PatBlt