CImage::PlgBlt
更新 : 2007 年 11 月
転送元デバイス コンテキストの四角形から、転送先デバイス コンテキストの平行四辺形にビット ブロック転送します。
BOOL PlgBlt(
HDC hDestDC,
const POINT* pPoints,
HBITMAP hbmMask = NULL
) const throw( );
BOOL PlgBlt(
HDC hDestDC,
const POINT* pPoints,
int xSrc,
int ySrc,
int nSrcWidth,
int nSrcHeight,
HBITMAP hbmMask = NULL,
int xMask = 0,
int yMask = 0
) const throw( );
BOOL PlgBlt(
HDC hDestDC,
const POINT* pPoints,
const RECT& rectSrc,
HBITMAP hbmMask = NULL,
const POINT& pointMask = CPoint(
0, 0 )
) const throw( );
パラメータ
hDestDC
転送先のデバイス コンテキストへのハンドル。pPoints
転送先の平行四辺形の 3 つの角を識別する、論理空間内の 3 つの点の配列へのポインタ。転送元四角形の左上隅が配列内の 1 番目の点、右上隅が 2 番目の点、左下隅が 3 番目の点にそれぞれ割り当てられます。転送元四角形の右下隅は、平行四角形の 4 番目の点に自動的に割り当てられます。hbmMask
転送元四角形の色をマスクするために使用される、省略可能なモノクロ ビットマップを識別するハンドル。xSrc
コピー元四角形の左上隅の x 座標 (論理単位)。ySrc
転送元四角形の左上隅の y 座標 (論理単位)。nSrcWidth
コピー元四角形の幅 (論理単位)。nSrcHeight
コピー元四角形の高さ (論理単位)。xMask
モノクロ ビットマップの左上隅の x 座標。yMask
モノクロ ビットマップの左上隅の y 座標。rectSrc
転送元四角形の各隅の座標を定義する RECT 構造体への参照。pointMask
マスク ビットマップの左上隅を示す POINT 構造体。
戻り値
正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。
解説
hbmMask で指定されるモノクロ ビットマップが有効である場合、PlgBit は、このモノクロ ビットマップを使用して、転送元四角形から取得したカラー データにビット マスクを適用します。
このメソッドは Windows NT 4.0 以降だけに適用されます。詳細については、Windows SDK の「PlgBlt」、および「以前のオペレーティング システムにおける CImage の制限」を参照してください。
必要条件
ヘッダー : atlimage.h