CDC::MaskBlt

BOOL MaskBlt ( int x, int y, int nWidth, int パラメーター nHeight, CDC ※ pSrcDC, int xSrc, int ySrc, CBitmapamp; maskBitmap, int xMask, int yMask, DWORD dwRop );(&A)

戻り値

関数が成功したそうでなければ 0。

パラメーター

x

転送先四角形の左上隅の論理 x 座標を指定します。

y

転送先四角形の左上隅の論理 y 座標を指定します。

nWidth

転送先四角形と転送元ビットマップの論理単位は、幅を指定します。

パラメーター nHeight

転送先四角形と転送元ビットマップの論理単位は、高さを指定します。

pSrcDC

ビットマップからコピーするデバイス コンテキストを識別します。DwRopパラメーターはソースを含まないラスター オペレーションを指定した場合は 0 をする必要があります。

現在の xSrc

ソース ビットマップの左上隅の論理 x 座標を指定します。

ySrc

ソース ビットマップの左上隅の論理 y 座標を指定します。

maskBitmap

元のデバイス コンテキストのカラー ビットマップを組み合わせて、モノクロ マスク ビットマップを識別します。

xMask

パラメーター maskBitmapで指定されるマスク ビットマップの水平方向のピクセル オフセットを指定します。

yMask

パラメーター maskBitmapで指定されるマスク ビットマップの垂直方向のピクセル オフセットを指定します。

dwRop

フォア グラウンドとバック グラウンドの両方三項ラスター操作関数を使用して、ソースと宛先データの組み合わせを制御するコードを指定します。バック グラウンドのラスター オペレーション コードは、この値の上位ワードの上位バイトに格納されます;フォア グラウンド ラスター オペレーション コードは、この値の上位ワードの下位バイトで格納されます;この値の下位ワードは無視され、0 にする必要があります。マクロMAKEROP4このような組み合わせのフォア グラウンドとバック グラウンド ラスター オペレーション コードを作成します。フォア グラウンドとバック グラウンドのこの関数のコンテキストでの解説を参照してください。BitBltメンバー関数一般的なラスター オペレーション コードの一覧を参照してください。

解説

指定されたマスクとラスター オペレーションを使用して、ソースとデスティネーション ビットマップのカラー データを組み合わせたものです。MaskBitmapで指定されたマスクで 1 の値は、 dwRopで指定したフォア グラウンド ラスター オペレーション コードがその位置で適用される必要があることを示します。マスクで 0 の値は、 dwRopで指定したバック グラウンド ラスター オペレーション コードがその位置で適用される必要があることを示します。ラスター オペレーションは、ソースが必要な場合は、マスク四角形、元の四角形をカバーする必要があります。されていない場合は、関数は失敗します。ラスター オペレーションは、ソースを必要としない場合は、マスク四角形が転送先四角形をカバーする必要があります。されていない場合は、関数は失敗します。

この関数が呼び出されたとき、回転または傾斜変換効果、元のデバイス コンテキストの場合は、エラーが発生します。ただし、他の種類の変換が可能です。

ソース、パターン、および転送先ビットマップの色形式が異なる場合は、この関数はパターン ソース形式、またはその両方は、宛先の形式を一致するように変換します。マスク ビットマップがモノクロ ビットマップではない場合は、エラーを発生します。拡張メタファイルを録音するときは、エラーが発生 (と、関数は 0 を返します) 場合は、元のデバイス コンテキストが拡張メタファイル デバイス コンテキストを識別します。すべてのデバイス maskblt を参照してください。アプリケーションは、デバイスがこの関数をサポートしているかどうかを確認するには、 getdevicecaps 関数を呼び出す必要があります。マスク ビットマップが指定されていない場合は、この関数はフォア グラウンド ラスター オペレーション コードを使用して正確BitBltのように、動作します。ピクセル マスク ビットマップ地図ポイント (0, 0) で元のデバイス コンテキストのビットマップのオフセットします。マスク ビットマップにマスクのセットが含まれている場合に便利です。アプリケーション簡単にそれらのいずれかマスクの転送タスクにピクセル オフセットとMaskBltに送信される四角形のサイズを調整することによって適用することができます。

CDC の概要|nbsp;クラス メンバー |階層図(&N)

参照特価;Cdc::bitbltCDC::GetDeviceCapsCDC::PlgBltCDC::StretchBlt :: MaskBlt(&N)

Index