次の方法で共有


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

参照

参照

CImage クラス

CImage::BitBlt

CImage::MaskBlt

その他の技術情報

CImage のメンバ