BOOL PlgBlt ( POINT lpPoint, CDC * pSrcDC, int xSrc, int ySrc, int nWidth, int nH&auteur, CBitmapamp ; maskBitmap, int xMask, int yMask );
Valeur de retour
Différent de zéro si la fonction est réussie ; sinon 0.
Paramètres
lpPoint
Pointe vers un tableau de trois points dans l'espace logique qui identifie les trois coins du parallélogramme de destination. Le coin supérieur gauche du rectangle source est mappé sur le premier point dans ce tableau, le coin supérieur droit pour le deuxième point de ce tableau et le coin inférieur gauche au troisième point. Le coin inférieur droit du rectangle source est mappé sur le quatrième point implicite dans le parallélogramme.
pSrcDC
Identifie le contexte de périphérique source.
xSrc
Spécifie la coordonnée x, en unités logiques, du coin supérieur gauche du rectangle source.
ySrc
Spécifie la coordonnée y, en unités logiques, du coin supérieur gauche du rectangle source.
nLargeur
Spécifie la largeur, en unités logiques, du rectangle source.
nHauteur
Spécifie la hauteur, en unités logiques, du rectangle source.
maskBitmap
Identifie un bitmap monochrome facultative qui est utilisée pour masquer les couleurs du rectangle source.
xMask
Spécifie la coordonnée x du coin supérieur gauche de l'image bitmap monochrome.
yMask
Spécifie la coordonnée y du coin supérieur gauche de l'image bitmap monochrome.
Remarques
Effectue un transfert de bloc de bits des bits de données couleur du rectangle spécifié dans le contexte de périphérique source à parallélogramme spécifié dans le contexte de périphérique donné. Si le descripteur de masque de bits donné identifie un bitmap monochrome valide, la fonction utilise cette image bitmap pour masquer les bits de données dans le rectangle source de couleur.
Le quatrième sommet du parallélogramme (D) est défini en considérant les trois premiers points (A, B et C) comme vecteurs et calcul D = B + C - A.
Si le masque de bits existe, la valeur 1 dans le masque indique que la couleur du pixel source doit être copiée dans la destination. La valeur 0 dans le masque indique que la couleur de pixel de destination est ne pas d'être modifié.
Si le rectangle de masque est plus petit que les rectangles de source et de destination, la fonction reproduit le modèle de masque.
Les transformations d'échelle, la traduction et la réflexion sont autorisées dans le contexte de périphérique source ; Cependant, les transformations de rotation et cisaillement ne sont pas. Si la bitmap du masque n'est pas un bitmap monochrome, une erreur se produit. Le mode d'étirement pour le contexte de périphérique de destination est utilisé pour déterminer la façon d'étirer ou compresser les pixels, si c'est nécessaire. Quand un métafichier amélioré est enregistré, une erreur se produit si le contexte de périphérique source identifie un contexte de périphérique de métafichier amélioré.
Les coordonnées de destination sont transformées dans le contexte de périphérique de destination ; les coordonnées de la source sont transformées dans le contexte de périphérique source. Si la transformation de la source a une rotation ou cisaillement, une erreur est retournée. Si les rectangles source et destination n'ont pas le même format de couleur, PlgBlt convertit le rectangle source pour faire correspondre le rectangle de destination. Pas tous les dispositifs de soutiennent PlgBlt. Pour plus d'informations, consultez la description de la capacité de raster RC_BITBLT dans la fonction membre CDC::GetDeviceCaps.
Si les contextes de périphérique source et de destination représentent les dispositifs incompatibles, PlgBlt renvoie une erreur.
Aperçu de la CDC | ; Membres de la classe | Graphique de la hiérarchie
Voir aussinbsp ;CDC::BitBlt, CDC::GetDeviceCaps, CDC::MaskBlt, CDC::StretchBlt, :: SetStretchBltMode , :: PlgBlt