Função BufferedPaintSetAlpha (uxtheme.h)

Define o alfa como um valor especificado em um determinado retângulo. O alfa controla a quantidade de transparência aplicada ao mesclar com o buffer no DC (contexto do dispositivo de destino).

Sintaxe

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

Parâmetros

hBufferedPaint

Tipo: HPAINTBUFFER

O identificador do contexto de pintura em buffer, obtido por meio de BeginBufferedPaint.

[in] prc

Tipo: const RECT*

Um ponteiro para uma estrutura RECT que especifica o retângulo no qual definir o alfa. Defina esse parâmetro como NULL para especificar todo o buffer.

alpha

Tipo: BYTE

O valor alfa a ser definido. O valor alfa pode variar de zero (totalmente transparente) a 255 (totalmente opaco).

Retornar valor

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Essa função define o valor alfa para cada pixel no retângulo de destino. Passar um valor alfa de 255 torna os pixels totalmente opacos. A macro BufferedPaintMakeOpaque , que é definida em uxtheme.h, define valores alfa como 255. Normalmente, ele é usado para chamar gdi para desenhar em um buffer de memória e, em seguida, torná-lo opaco a fim de desenhá-lo em vidro.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	uxtheme.h
DLL	UxTheme.dll