BOOL M&askBlt ( int x, int y, int nWidth, int nHauteur, CDC * pSrcDC, int xSrc, int ySrc, CBitmapamp ; maskBitmap, int xMask, int yMask, DWORD dwRop );
Valeur de retour
Différent de zéro si la fonction est réussie ; sinon 0.
Paramètres
x
Spécifie la logique coordonnée x du coin supérieur gauche du rectangle de destination.
y
Spécifie la logique coordonnée y du coin supérieur gauche du rectangle de destination.
nLargeur
Spécifie la largeur, en unités logiques, de la bitmap source et le rectangle de destination.
nHauteur
Spécifie la hauteur, en unités logiques, de la bitmap source et le rectangle de destination.
pSrcDC
Identifie le contexte de périphérique dont l'image bitmap doit être copié. Il doit être de zéro si le paramètre dwRop spécifie une opération raster qui n'inclut pas une source.
xSrc
Spécifie la logique coordonnée x du coin supérieur gauche de la bitmap source.
ySrc
Spécifie la logique coordonnée y du coin supérieur gauche de la bitmap source.
maskBitmap
Identifie la bitmap monochrome masque combinée avec le bitmap de couleur dans le contexte de périphérique source.
xMask
Spécifie le décalage horizontal pixel de la bitmap de masque spécifié par le paramètre maskBitmap.
yMask
Spécifie l'offset vertical pixel de la bitmap de masque spécifiée par le paramètre maskBitmap.
dwRop
Spécifie le premier plan et arrière-plan raster ternaire codes opération, dont la fonction utilise pour contrôler la combinaison de données source et de destination. Le code d'opération arrière-plan raster est stocké dans l'octet haut du mot haut de cette valeur ; le code d'opération raster au premier plan est stocké dans l'octet bas du mot haut de cette valeur ; le mot faible de cette valeur est ignoré et devrait être zéro. La macro MAKEROP4 crée des combinaisons de premier plan et d'arrière-plan raster codes d'opération. Consultez la section Remarques pour une discussion de premier plan et d'arrière-plan dans le cadre de cette fonction. Consultez la fonction membre BitBlt pour obtenir la liste des codes d'opération raster communs.
Remarques
Combine les données de couleur pour les bitmaps de source et de destination en utilisant le masque donné et l'exploitation de raster. La valeur 1 dans le masque spécifié par maskBitmap indique que le code d'opération raster au premier plan spécifié par dwRop devrait s'appliquer à cet endroit. La valeur 0 dans le masque indique que le code d'opération raster arrière-plan spécifié par dwRop devrait s'appliquer à cet endroit. Si les opérations matricielles exigent une source, le rectangle masque doit couvrir le rectangle source. Si elle ne le fait pas, la fonction échouera. Si les opérations matricielles ne nécessitent pas une source, le rectangle masque doit couvrir le rectangle de destination. Si elle ne le fait pas, la fonction échouera.
Si une transformation de rotation ou de cisaillement est en vigueur pour le contexte de périphérique source lorsque cette fonction est appelée, une erreur se produit. Toutefois, les autres types de transformations sont autorisés.
Si les formats de couleur de la source, le patron et le bitmap de destination diffèrent, cette fonction convertit le patron ou format source ou les deux, pour faire correspondre le format de destination. Si la bitmap du masque n'est pas un bitmap monochrome, une erreur se produit. Quand un métafichier amélioré est enregistré, une erreur se produit (et la fonction renvoie la valeur 0) si le contexte de périphérique source identifie un contexte de périphérique de métafichier amélioré. Pas tous les dispositifs de soutiennent MaskBlt. Une application doit appeler GetDeviceCaps pour déterminer si un périphérique prend en charge cette fonction. Si aucune image bitmap du masque n'est fourni, cette fonction se comporte exactement comme BitBlt, en utilisant le code d'opération raster au premier plan. Le pixel compense dans la masque bitmap carte au point (0,0) de bitmap du contexte de périphérique de la source. Ceci est utile pour les cas dans lesquels une bitmap de masque contient un ensemble de masques ; une application peut facilement appliquer aucun d'entre eux à une tâche de masque-fusion par décalages de pixels et la taille du rectangle envoyée à MaskBlt.
Aperçu de la CDC | ; Membres de la classe | Graphique de la hiérarchie
Voir aussinbsp ;CDC::BitBlt, CDC::GetDeviceCaps, CDC::PlgBlt, CDC::StretchBlt, :: MaskBlt