Freigeben über


CImage::PlgBlt

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-Klasse

CImage::BitBlt

CImage::MaskBlt