CDC::PatBlt
更新 : 2007 年 11 月
指定されたデバイス上にビット パターンを作成します。
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 フラグをチェックしてください。
必要条件
ヘッダー : afxwin.h