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