TransparentBlt, fonction (wingdi.h)

Article
03/13/2024

La fonction TransparentBlt effectue un transfert de bloc de bits des données de couleur correspondant à un rectangle de pixels du contexte d’appareil source spécifié vers un contexte d’appareil de destination.

Syntaxe

BOOL TransparentBlt(
  [in] HDC  hdcDest,
  [in] int  xoriginDest,
  [in] int  yoriginDest,
  [in] int  wDest,
  [in] int  hDest,
  [in] HDC  hdcSrc,
  [in] int  xoriginSrc,
  [in] int  yoriginSrc,
  [in] int  wSrc,
  [in] int  hSrc,
  [in] UINT crTransparent
);

Paramètres

[in] hdcDest

Handle du contexte de l’appareil de destination.

[in] xoriginDest

Coordonnée x, en unités logiques, du coin supérieur gauche du rectangle de destination.

[in] yoriginDest

Coordonnée y, en unités logiques, du coin supérieur gauche du rectangle de destination.

[in] wDest

Largeur, en unités logiques, du rectangle de destination.

[in] hDest

Hauteur, en unités logiques, du rectangle de destination.

[in] hdcSrc

Handle pour le contexte de l’appareil source.

[in] xoriginSrc

Coordonnée x, en unités logiques, du rectangle source.

[in] yoriginSrc

Coordonnée y, en unités logiques, du rectangle source.

[in] wSrc

Largeur, en unités logiques, du rectangle source.

[in] hSrc

Hauteur, en unités logiques, du rectangle source.

[in] crTransparent

Couleur RVB dans la bitmap source à traiter comme transparente.

Valeur retournée

Si la fonction réussit, la valeur de retour est TRUE.

Si la fonction échoue, la valeur de retour est FALSE.

Remarques

La fonction TransparentBlt fonctionne avec des bitmaps compatibles (DDB).

La fonction TransparentBlt prend en charge tous les formats de bitmaps sources. Toutefois, pour les bitmaps 32 bpp, il suffit de copier la valeur alpha sur. Utilisez AlphaBlend pour spécifier des bitmaps de 32 bits par pixel avec transparence.

Si les rectangles source et de destination ne sont pas de la même taille, la bitmap source est étirée pour correspondre au rectangle de destination. Lorsque la fonction SetStretchBltMode est utilisée, les modes iStretchMode de BLACKONWHITE et WHITEONBLACK sont convertis en COLORONCOLOR pour la fonction TransparentBlt .

Le contexte de l’appareil de destination spécifie le type de transformation pour les coordonnées de destination. Le contexte de l’appareil source spécifie le type de transformation pour les coordonnées sources.

TransparentBlt ne miroir pas une bitmap si la largeur ou la hauteur de la source ou de la destination est négative.

Lorsqu’ils sont utilisés dans un système à plusieurs moniteurs, hdcSrc et hdcDest doivent faire référence au même appareil, sinon la fonction échoue. Pour transférer des données entre contrôleurs de domaine pour différents appareils, convertissez la bitmap de mémoire en DIB en appelant GetDIBits. Pour afficher la DIB sur le deuxième appareil, appelez SetDIBits ou StretchDIBits.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wingdi.h (inclure Windows.h)
Bibliothèque	Msimg32.lib
DLL	Msimg32.dll