Partager via


BufferedPaintSetAlpha, fonction (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 d’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 l’intégralité de la mémoire tampon.

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. La transmission d’une valeur alpha de 255 rend les pixels entièrement opaques. La macro BufferedPaintMakeOpaque , 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 mémoire, puis pour le rendre opaque afin de le dessiner sur le verre.

Spécifications

Requirement Valeur
Client minimum requis Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
plateforme cible Fenêtres
Header uxtheme.h
Library Uxtheme.lib
DLL UxTheme.dll