Partager via


CImage::PlgBlt

Exécute un transfert par bloc de bits d'un rectangle dans un contexte du périphérique source dans un parallélogramme dans un contexte de périphérique de destination.

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

Paramètres

  • hDestDC
    Un handle au contexte de périphérique de destination.

  • pPoints
    Pointeur vers un tableau de trois points dans l'espace logique qui identifient trois angles du parallélogramme de destination.Le coin supérieur gauche du rectangle source est mappé au premier point dans ce tableau, à l'angle supérieur droit sur le deuxième point dans ce tableau, et à l'angle inférieur gauche au troisième point.L'angle inférieur droit du rectangle source est mappé au quatrième point implicite au parallélogramme.

  • hbmMask
    Un handle à une bitmap facultative de monochrome utilisée pour masquer les couleurs du rectangle source.

  • xSrc
    Coordonnée x, en unités logiques, de l'angle supérieur gauche du rectangle source.

  • ySrc
    Coordonnée y, en unités logiques, de l'angle supérieur gauche du rectangle source.

  • nSrcWidth
    La largeur, en unités logiques, le rectangle source.

  • nSrcHeight
    La hauteur, en unités logiques, le rectangle source.

  • xMask
    Coordonnée x du coin supérieur gauche de la bitmap monochrome.

  • yMask
    Coordonnée y du coin supérieur gauche de la bitmap monochrome.

  • rectSrc
    Une référence à une structure de RECT spécifiant les coordonnées du rectangle source.

  • pointMask
    Une structure de POINT indiquant le coin supérieur gauche de la bitmap de masque.

Valeur de retour

Une valeur différente de zéro si l'opération a réussi, sinon 0.

Notes

Si hbmMask identifie une bitmap valide de monochrome, PlgBit utilise cette bitmap pour masquer les bits des données couleur du rectangle source.

Cette méthode s'applique aux Windows NT, les versions 4,0 et ultérieures uniquement.Voir PlgBlt dans Kit de développement logiciel Windows et le Limitations de CImage aux systèmes d'exploitation antérieurs pour plus d'informations détaillées.

Configuration requise

Header: atlimage.h

Voir aussi

Référence

Classe de CImage

CImage::BitBlt

CImage::MaskBlt