Funzione BufferedPaintSetAlpha (uxtheme.h)

Imposta l'alfa su un valore specificato in un determinato rettangolo. L'alfa controlla la quantità di trasparenza applicata durante la fusione con il buffer nel contesto del dispositivo di destinazione (DC).

Sintassi

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

Parametri

hBufferedPaint

Tipo: HPAINTBUFFER

Handle del contesto di disegno con buffer ottenuto tramite BeginBufferedPaint.

[in] prc

Tipo: const RECT*

Puntatore a una struttura RECT che specifica il rettangolo in cui impostare l'alfa. Impostare questo parametro su NULL per specificare l'intero buffer.

alpha

Tipo: BYTE

Valore alfa da impostare. Il valore alfa può variare da zero (completamente trasparente) a 255 (completamente opaco).

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Questa funzione imposta il valore alfa per ogni pixel nel rettangolo di destinazione. Passando un valore alfa pari a 255 pixel rende completamente opaco i pixel. La macro BufferedPaintMakeOpaque , definita in uxtheme.h, imposta i valori alfa su 255. In genere viene usato per chiamare GDI per disegnare in un buffer di memoria e quindi per renderlo opaco per disegnare su vetro.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	uxtheme.h
DLL	UxTheme.dll