TransparentBlt, fonction (wingdi.h)
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 |