CDC::MaskBlt
Combine des données couleur de la source et les bitmaps de destination à l'aide de le masque et l'opération raster donnés.
BOOL MaskBlt(
int x,
int y,
int nWidth,
int nHeight,
CDC* pSrcDC,
int xSrc,
int ySrc,
CBitmap& maskBitmap,
int xMask,
int yMask,
DWORD dwRop
);
Paramètres
x
Spécifie la coordonnée x logique du coin supérieur gauche du rectangle de destination.y
Spécifie l'ordonnée logique du coin supérieur gauche du rectangle de destination.nWidth
Spécifie la largeur, en unités logiques, du rectangle de destination et de bitmap source.nHeight
Spécifie la hauteur, en unités logiques, du rectangle de destination et de bitmap source.pSrcDC
Identifie le contexte de périphérique dont la bitmap doit être copiée. Elle doit être égal à zéro si le paramètre de dwRop spécifie une opération raster qui n'inclut pas une source.xSrc
Spécifie la coordonnée x logique de l'angle supérieur gauche de bitmap source.ySrc
Spécifie l'ordonnée logique de l'angle supérieur gauche de bitmap source.maskBitmap
Identifie la bitmap monochrome de masque combinée avec la bitmap de couleur dans le contexte du périphérique source.xMask
Spécifie l'offset horizontale de pixel de la bitmap de masque spécifié par le paramètre d' maskBitmap .yMask
Spécifie le décalage vertical de pixel de la bitmap de masque spécifié par le paramètre d' maskBitmap .dwRop
Spécifie les codes d'opération ternaires raster de premier plan et d'arrière-plan, que la fonction utilise pour contrôler la combinaison de la source et des données de destination. L'opcode raster d'arrière-plan est stocké dans l'octet le plus élevé du mot élevé de cette valeur ; l'opcode raster de premier plan est stocké dans le bas octet du mot élevé de cette valeur ; le bas mot de cette valeur est ignoré, et doit être égal à zéro. Le MAKEROP4 crée de ces combinaisons de codes d'opération raster de premier plan et d'arrière-plan. Consultez la section Notes d'une révision de premier plan et d'arrière-plan dans le contexte de cette fonction. Consultez la fonction membre d' BitBlt pour obtenir une liste de codes courants d'opération raster.
Valeur de retour
Une valeur différente de zéro si la fonction est réussie ; sinon 0.
Notes
Une valeur de 1 dans le masque spécifié par maskBitmap indique que le code d'opération raster de premier plan spécifié par le dwRop doit être appliqué à cet emplacement. Une valeur de 0 dans le masque indique que le code d'opération raster d'arrière-plan spécifié par le dwRop doit être appliqué à cet emplacement. Si les opérations rasters requièrent une source, le rectangle de masque doit couvrir le rectangle source. Dans le cas contraire, la fonction échoue. Si les opérations rasters ne requièrent pas de source, le rectangle de masque doit couvrir le rectangle de destination. Dans le cas contraire, la fonction échoue.
Si une rotation ou une transformation d'inclinaison est appliqué pour le contexte du périphérique source lorsque cette fonction est appelée, une erreur se produit. Toutefois, il permet d'autres types de transformations.
Si les formats de couleur de la source, le modèle, et les bitmaps de destination diffèrent, convertit cette fonction de le format de modèle ou de source, ou les deux, pour correspondre au format de destination. Si la bitmap de masque n'est pas une bitmap monochrome, une erreur se produit. Lorsqu'un métafichier amélioré est enregistré, une erreur se produit (et la fonction retourne 0) si le contexte du périphérique source identifie un contexte de périphérique de métafichier amélioré. Tous les appareils prennent en charge MaskBlt. Une application doit appeler GetDeviceCaps pour déterminer si les prend en charge des appareils cette fonction. Si aucune bitmap de masque n'est fournie, cette fonction se comporte exactement comme BitBlt, à l'aide de l'opcode raster de premier plan. Les offsets de pixel dans le mappage de bitmap de masque au point (0,0) dans la bitmap du contexte de périphérique source. Ceci est utile pour les cas où une bitmap de masque contient un jeu de caractères ; une application peut facilement appliquer des tout d'entre eux à une tâche de masque- fusion en ajustant les offsets de pixel et la taille du rectangle envoyés à MaskBlt.
Configuration requise
Header: afxwin.h