CDC::StretchBlt

BOOL StretchBlt ( int x, int y, int nWidth, int nHauteur, CDC * pSrcDC, int xSrc, int ySrc, int nSrcWidth, int nSrcHeight, DWORD dwRop );

Valeur de retour

Différent de zéro si la bitmap est dessinée ; sinon 0.

Paramètres

x

Spécifie la coordonnée x (en unités logiques) de l'angle supérieur gauche du rectangle de destination.

y

Spécifie la coordonnée y (en unités logiques) de l'angle supérieur gauche du rectangle de destination.

nLargeur

Spécifie la largeur (en unités logiques) du rectangle de destination.

nHauteur

Spécifie la hauteur (en unités logiques) du rectangle de destination.

pSrcDC

Spécifie le contexte de 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 la coordonnée x (en unités logiques) de l'angle supérieur gauche du rectangle source.

nSrcWidth

Spécifie la largeur (en unités logiques) du rectangle source.

nSrcHeight

Spécifie la hauteur (en unités logiques) du rectangle source.

dwRop

Spécifie l'opération raster à effectuer. Codes d'opération matricielles définissent comment GDI allie les couleurs dans les opérations qui impliquent un pinceau actuel, une image bitmap source possible et une image bitmap de destination. Ce paramètre peut être une des valeurs suivantes:

• 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.

Remarques

Copie une image bitmap d'un rectangle source dans un rectangle de destination, étirement ou compression de l'image bitmap si nécessaire pour ajuster les dimensions du rectangle de destination. La fonction utilise le mode d'étirement du contexte de périphérique de destination (défini par SetStretchBltMode) pour déterminer comment étirer ou compresser l'image bitmap.

La fonction StretchBlt déplace l'image bitmap du périphérique source donné par pSrcDC sur le périphérique de destination, représenté par l'objet de contexte de périphérique dont la fonction membre est appelée. Les paramètres xSrc, ySrc, nSrcWidthet nSrcHeight définissent le coin supérieur gauche et les dimensions du rectangle source. Les paramètres x, y, nLargeuret nHauteur donnent le coin supérieur gauche et les dimensions du rectangle de destination. L'opération de raster spécifiée par dwRop définit comment la bitmap source et les bits déjà sur le périphérique de destination sont combinées.

La fonction StretchBlt crée une image miroir d'un bitmap, si les signes des paramètres nSrcWidth et nWidth ou nSrcHeight et nHauteur diffèrent. Si nSrcWidth et nWidth ont des signes différents, la fonction crée une image miroir de l'image bitmap le long de l'axe des abscisses. Si nSrcHeight et nHeight ont des signes différents, la fonction crée une image miroir de l'image bitmap le long de l'axe des ordonnées.

La fonction StretchBlt s'étend ou compresse l'image bitmap source en mémoire et puis copie le résultat vers la destination. Si un modèle doit être fusionné avec le résultat, il n'est pas fusionné jusqu'à ce que la bitmap source étirée est copiée vers la destination. Si un pinceau est utilisé, c'est le pinceau sélectionné dans le contexte de périphérique de destination. 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 destination, la source et le modèle bitmaps n'ont pas le même format de couleur, StretchBlt convertit les bitmaps source et modèle pour correspondre à la bitmap de destination. Les couleurs d'avant-plan et d'arrière-plan du contexte de périphérique de destination sont utilisés dans la conversion.

Si StretchBlt doivent convertir un bitmap monochrome à la couleur, il définit bits blancs (1) de la couleur d'arrière-plan et les bits noirs (0) à la couleur de premier plan. Pour convertir les couleurs en monochrome, il affecte les pixels qui correspondent à la couleur d'arrière-plan de blanc (1) et tous les autres pixels noirs (0). Les couleurs au premier plan et d'arrière-plan du contexte de périphérique avec la couleur sont utilisés.

Pas tous les périphériques prennent en charge la fonction StretchBlt . Pour déterminer si un périphérique prend en charge StretchBlt, appelez la fonction membre de GetDeviceCaps avec l'index RASTERCAPS et vérifier la valeur de retour pour le drapeau RC_STRETCHBLT.

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

Voir aussinbsp ;CDC::BitBlt, CDC::GetDeviceCaps, CDC::SetStretchBltMode, :: StretchBlt