CImage::PlgBlt

Artikel
06/09/2015

Führt einen Bitblocktransfer aus einem Rechteck in einem Quellgerätekontext in ein Parallelogramm in einem Zielgerätekontext aus.

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( );

Parameter

hDestDC
Ein Handle für Zielgerätekontext.
pPoints
Ein Zeiger auf ein Array mit drei Punkten im logischen Leerzeichen, die drei Ecken des Ziel-Parallelogrammes identifizieren. Die linke obere Ecke des Quellrechtecks wird dem ersten Punkt in diesem Array, zur rechten oberen Ecke auf den zweiten Punkt in diesem Array und die linke untere Ecke auf das dritte Punkt zugeordnet. Die rechte untere Ecke des Quellrechtecks wird zum impliziten vierten Punkt im Parallelogramm zugeordnet.
hbmMask
Ein Handle einer optionalen monochromen Bitmap, die verwendet wird, um die Farben des Quellrechtecks zu maskieren.
xSrc
Die x-Koordinate, in logischen Einheiten, der linken oberen Ecke des Quellrechtecks.
ySrc
Die y-Koordinate, in logischen Einheiten, der linken oberen Ecke des Quellrechtecks.
nSrcWidth
Die Breite, in logischen Einheiten, des Quellrechtecks.
nSrcHeight
Die Höhe, in logischen Einheiten, des Quellrechtecks.
xMask
Die X-Koordinate der oberen linken Ecke der monochromen Bitmaps.
yMask
Die Y-Koordinate der oberen linken Ecke der monochromen Bitmaps.
rectSrc
Ein Verweis auf eine RECT-Struktur, die die Koordinaten des Quellrechtecks angibt.
pointMask
Eine PUNKT-Struktur, die die linke obere Ecke der Maskenbitmaps angibt.

Rückgabewert

Ungleich 0 (null), wenn erfolgreich; andernfalls 0.

Hinweise

Wenn hbmMask eine gültige monochrome Bitmap identifiziert, verwendet PlgBit diese Bitmap, um die Bits von Farbdaten vom Quellrechteck zu maskieren.

Diese Methode gilt für Windows NT, Version 4.0 und höher nur zu. Siehe PlgBlt in Windows SDK und CImage-Einschränkungen mit älteren Betriebssystemen für ausführlichere Informationen.

Anforderungen

Header: atlimage.h

Siehe auch

Referenz

CImage Class

CImage::BitBlt

CImage::MaskBlt

Freigeben über