CDC::PlgBlt
Exécute un transfert par bloc de bits des bits des données couleur du rectangle spécifié dans le contexte du périphérique source au parallélogramme spécifié dans le contexte donné de périphérique.
BOOL PlgBlt(
LPPOINT lpPoint,
CDC* pSrcDC,
int xSrc,
int ySrc,
int nWidth,
int nHeight,
CBitmap& maskBitmap,
int xMask,
int yMask
);
Paramètres
lpPoint
Pointe vers un tableau de trois points dans l'espace logique qui identifie 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.pSrcDC
Identifie le contexte du périphérique source.xSrc
Spécifie la coordonnée x, en unités logiques, de l'angle supérieur gauche du rectangle source.ySrc
Spécifie l'ordonnée, en unités logiques, de l'angle supérieur gauche du rectangle source.nWidth
Spécifie la largeur, en unités logiques, le rectangle source.nHeight
Spécifie la hauteur, en unités logiques, le rectangle source.maskBitmap
Identifie une bitmap facultative de monochrome utilisée pour masquer les couleurs du rectangle source.xMask
Spécifie la coordonnée x du coin supérieur gauche de la bitmap monochrome.yMask
Spécifie l'ordonnée du coin supérieur gauche de la bitmap monochrome.
Valeur de retour
Une valeur différente de zéro si la fonction est réussie ; sinon 0.
Notes
Si le handle fourni de masque de bits identifie une bitmap valide de monochrome, la fonction utilise cette bitmap pour masquer les bits des données couleur du rectangle source.
Le quatrième vertex du parallélogramme (d) est défini en traitant les trois premiers points (A, B, et C) comme vecteurs et calculer D = + B C - A.
Si le masque de bits existe, une valeur de 1 dans le masque indique que la couleur du pixel de source doit être copiée vers la destination. Une valeur de 0 dans le masque indique que la couleur du pixel de destination ne doit pas être modifiée.
Si le rectangle de masque est plus petit que la source et les rectangles de destination, la fonction reproduit le modèle de caractère générique.
Il permet la mise à l'échelle, la traduction, et les transformations de réflexion dans le contexte du périphérique source ; toutefois, la rotation et les transformations d'inclinaison ne sont pas. Si la bitmap de masque n'est pas une bitmap monochrome, une erreur se produit. Le mode d'étirement pour le contexte de périphérique de destination est utilisé pour déterminer comment étirer ou compresser les pixels, si cela est nécessaire. Lorsqu'un métafichier amélioré est enregistré, une erreur se produit si le contexte du périphérique source identifie un contexte de périphérique de métafichier amélioré.
Les coordonnées de destination sont transformées en fonction de le contexte de périphérique de destination ; les coordonnées de source sont transformées en fonction de le contexte du périphérique source. Si la transformation de source comporte une rotation ou une inclinaison, une erreur est retournée. Si la destination et les rectangles sources n'ont pas le même format de couleur, PlgBlt convertit le rectangle source pour correspondre au rectangle de destination. Tous les appareils prennent en charge PlgBlt. Pour plus d'informations, consultez la description de la fonctionnalité de fr. de RC_BITBLT dans la fonction membre d' CDC::GetDeviceCaps .
Si les contextes de source et de périphérique de destination représentent les appareils incompatibles, PlgBlt retourne une erreur.
Configuration requise
Header: afxwin.h