Fonction BufferedPaintSetAlpha (uxtheme.h)

Définit l’alpha sur une valeur spécifiée dans un rectangle donné. L’alpha contrôle la quantité de transparence appliquée lors de la fusion avec la mémoire tampon sur le contexte de l’appareil cible de destination (DC).

Syntaxe

HRESULT BufferedPaintSetAlpha(
       HPAINTBUFFER hBufferedPaint,
  [in] const RECT   *prc,
       BYTE         alpha
);

Paramètres

hBufferedPaint

Type : HPAINTBUFFER

Handle du contexte de peinture mis en mémoire tampon, obtenu via BeginBufferedPaint.

[in] prc

Type : const RECT*

Pointeur vers une structure RECT qui spécifie le rectangle dans lequel définir l’alpha. Définissez ce paramètre sur NULL pour spécifier la mémoire tampon entière.

alpha

Type : BYTE

Valeur alpha à définir. La valeur alpha peut aller de zéro (entièrement transparent) à 255 (entièrement opaque).

Valeur retournée

Type : HRESULT

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Cette fonction définit la valeur alpha pour chaque pixel dans le rectangle cible. Le passage d’une valeur alpha de 255 rend les pixels entièrement opaques. La macro BufferedPaintMakeOpaque , qui est définie dans uxtheme.h, définit les valeurs alpha sur 255. Il est généralement utilisé pour appeler GDI pour dessiner dans une mémoire tampon, puis pour la rendre opaque afin de la dessiner sur du verre.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	uxtheme.h
DLL	UxTheme.dll