Metodo IDCompositionVisual2::SetOpacityMode (dcomp.h)

Imposta la modalità di opacità per questo oggetto visivo.

Sintassi

HRESULT SetOpacityMode(
  [in] DCOMPOSITION_OPACITY_MODE mode
);

Parametri

[in] mode

Modalità di opacità da utilizzare per la composizione dell'oggetto visivo sullo schermo.

Valore restituito

Se la funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT . Per un elenco di codici di errore, vedere Codici di errore directComposition .

Commenti

La modalità di opacità influisce sul modo in cui la proprietà Opacity di un oggetto gruppo di effetti influisce sulla composizione di un sottoalbero visivo. DirectComposition supporta due modalità di opacità: Layer e Multiply. In modalità Livello ogni sottoalbero visivo può essere visualizzato logicamente come bitmap che contiene la rasterizzazione opaca dell'intero sottoalbero, a cui viene quindi applicato il valore di opacità. In questo modo, le superfici opache sovrapposte si fondono con lo sfondo della sottoalbero, ma non tra loro. Al contrario, in modalità Moltiplicazione l'opacità viene applicata singolarmente a ogni superficie così com'è composta, quindi le superfici si fondono tra loro. La modalità di moltiplicazione è più veloce rispetto alla modalità Livello e sempre consigliata se la struttura ad albero visuale contiene contenuti completamente non sovrapposti. Tuttavia, la modalità Multiply può produrre risultati visivi indesiderati per gli elementi sovrapposti.

Per impostazione predefinita, un oggetto visivo eredita la modalità di opacità dell'oggetto visivo padre, che può ereditare la modalità di opacità dell'oggetto visivo padre e così via. Un oggetto visivo usa la modalità DCOMPOSITION_OPACITY_MODE_LAYER se questo metodo non viene mai chiamato per l'oggetto visivo o se questo metodo viene chiamato con DCOMPOSITION_OPACITY_MODE_INHERIT. Se nessun oggetto visivo imposta la modalità di opacità, l'impostazione predefinita per l'intera struttura ad albero visuale è DCOMPOSITION_OPACITY_MODE_LAYER.

Se il parametro opacityMode è diverso da DCOMPOSITION_OPACITY_MODE_INHERIT, le superfici dell'oggetto visivo vengono composte con la modalità di opacità specificata. Inoltre, questa modalità di opacità diventa il nuovo valore predefinito per gli elementi figlio dell'oggetto visivo corrente. Ovvero, se la modalità di opacità degli elementi figlio di questo oggetto visivo è invariata o impostata in modo esplicito su DCOMPOSITION_OPACITY_MODE_INHERIT, le superfici degli oggetti visivi figlio vengono composte usando la modalità di opacità di questo oggetto visivo.

Requisiti

Vedi anche

IDCompositionEffectGroup::SetOpacity

IDCompositionVisual2