CDC::BitBlt 

BOOL BitBlt( int x, int y, int nWidth, int nHeight, CDC* pSrcDC, int xSrc, int ySrc, 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

Pointeur vers un objet CDC qui identifie le contexte de périphérique qui sera copié l'image bitmap. Il doit être NULL si 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.

dwRop

Spécifie l'opération raster à effectuer. Codes Raster-opération définissent comment le GDI allie les couleurs dans les opérations qui impliquent un pinceau actuel, une image bitmap source possible et une image bitmap de destination. Les codes suivants de raster-opération des listes pour les dwRop et leurs descriptions:

• BLACK&NESSnbsp ;  Transforme toute la sortie noire.
  
  
• DSTI&NVERTnbsp ;  Inverse l'image bitmap de destination.
  
  
• MERGECOPY  ;  Combine le modèle et la bitmap source à l'aide de l'opérateur booléen et.
  
  
• MERGEPAI&NTnbsp ;  Combine la bitmap source inversé avec la bitmap de destination à l'aide de l'opérateur booléen ou.
  
  
• &NOTSRCCOPYnbsp ;  Copie de la bitmap source inversée vers la destination.
  
  
• &NOTSRCERASEnbsp ;  Inverse le résultat de la combinaison de la bitmap source et destination en utilisant l'opérateur booléen ou.
  
  
• PATCOPY  ;  Copie du modèle dans la bitmap de destination.
  
  
• PATI&NVERTnbsp ;  Combine la bitmap de destination avec le modèle à l'aide de l'opérateur booléen XOR.
  
  
• PATPAI&NTnbsp ;  Combine la bitmap source inversée sur le modèle à l'aide de l'opérateur booléen ou. Combine le résultat de cette opération avec l'image bitmap de destination à l'aide de l'opérateur booléen ou.
  
  
• SRC et  ;  Combine les pixels de la bitmap source et destination en utilisant l'opérateur booléen et.
  
  
• SRCCOPY  ;  Copie de la bitmap source dans la bitmap de destination.
  
  
• SRCERASE  ;  Inverse l'image bitmap de destination et combine le résultat de la bitmap source à l'aide de l'opérateur booléen et.
  
  
• SRCI&NVERTnbsp ;  Combine les pixels de la bitmap source et destination en utilisant l'opérateur booléen XOR.
  
  
• SRCPAI&NTnbsp ;  Combine les pixels de la bitmap source et destination en utilisant l'opérateur booléen ou.
  
  
• Bla&ncheurnbsp ;  Transforme toute la sortie blanche.

Pour une liste complète des codes d'opération matricielles, voir sur les Codes d'opération Raster dans la section annexes de la référence du programmeur Win32 SDK.

Remarques

Copie une image bitmap dans le contexte de périphérique source dans l'actuel contexte de périphérique.

L'application peut aligner la windows ou des zones de client sur les limites de l'octet pour s'assurer que les opérations de BitBlt se déroulent sur les rectangles alignés octets. (Définir les drapeaux CS_BYTEALIGNWINDOW ou CS_BYTEALIGNCLIENT lorsque vous devez inscrire les classes de fenêtre).

BitBlt opérations sur les rectangles alignés octets sont beaucoup plus rapidement que les opérations de BitBlt sur les rectangles qui ne sont pas alignés sur des octets. Si vous souhaitez spécifier des styles de classe comme octets-alignement de votre propre contexte de périphérique, vous devrez vous inscrire à une classe de fenêtre plutôt que de compter sur les classes Microsoft Foundation de le faire pour vous. Utilisez la fonction globale AfxRegisterWndClass.

GDI transforme nLargeur et nHauteur, une fois à l'aide du contexte de périphérique de destination et une fois à l'aide du contexte de périphérique source. Si les extensions qui ne correspondent pas, GDI utilise la fonction Windows StretchBlt pour compresser ou d'étirer la bitmap source si nécessaire.

Si le patron des bitmaps, source et destination n'ont pas le même format de couleur, la fonction BitBlt convertit la bitmap source et modèle pour correspondre à la destination. Les couleurs de premier plan et d'arrière-plan de l'image bitmap de destination sont utilisés dans la conversion.

Lorsque la fonction BitBlt convertit une image bitmap monochrome de couleur, il définit bits blancs (1) de la couleur d'arrière-plan et les bits noirs (0) à la couleur de premier plan. Les couleurs d'avant-plan et d'arrière-plan du contexte de périphérique de destination sont utilisés. Pour convertir les couleurs en monochrome, BitBlt affecte pixels qui correspondent à la couleur de fond blanc et tous les autres pixels noir. BitBlt utilise les couleurs d'avant-plan et d'arrière-plan du contexte de périphérique de couleur pour convertir les couleurs en monochrome.

Notez que pas tous les contextes de périphérique ne supportent BitBlt. Pour vérifier si un contexte de périphérique donné prend en charge BitBlt, utilisez la fonction de membre GetDeviceCaps et spécifier l'index RASTERCAPS.

Aperçu de la CDC |  ; Membres de la classe | Graphique de la hiérarchie

Voir aussinbsp ;CDC::GetDeviceCaps, CDC::PatBlt, CDC::SetTextColor, CDC::StretchBlt, :: StretchDIBits, :: BitBlt