Método IDCompositionVisual2::SetOpacityMode (dcomp.h)
Define o modo de opacidade para este visual.
Sintaxe
HRESULT SetOpacityMode(
[in] DCOMPOSITION_OPACITY_MODE mode
);
Parâmetros
[in] mode
O modo de opacidade a ser usado ao redigir o visual na tela.
Retornar valor
Se a função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT. Confira Códigos de erro do DirectComposition para obter uma lista de códigos de erro.
Comentários
O modo de opacidade afeta como a propriedade Opacity de um objeto de grupo de efeitos afeta a composição de uma subárvore visual. O DirectComposition dá suporte a dois modos de opacidade: Camada e Multiplicação. No modo Camada, cada subárvore visual pode ser visualizada logicamente como um bitmap que contém a rasterização opaca dessa subárvore inteira, à qual o valor de opacidade é aplicado. Dessa forma, superfícies opacas sobrepostas se misturam com o plano de fundo da subárvore, mas não entre si. Por outro lado, no modo Multiplicação, a opacidade é aplicada individualmente a cada superfície conforme ela é composta, portanto, as superfícies se misturam entre si. O modo de multiplicação é mais rápido que o modo camada e sempre preferencial se a árvore visual contiver conteúdo totalmente não sobreposto. No entanto, o modo Multiplicar pode produzir resultados visuais indesejados para elementos sobrepostos.
Por padrão, um visual herda o modo de opacidade de seu visual pai, que pode herdar o modo de opacidade de seu visual pai e assim por diante. Um visual usará o modo DCOMPOSITION_OPACITY_MODE_LAYER se esse método nunca for chamado para o visual ou se esse método for chamado com DCOMPOSITION_OPACITY_MODE_INHERIT. Se nenhum visual definir o modo de opacidade, o padrão para toda a árvore visual será DCOMPOSITION_OPACITY_MODE_LAYER.
Se o parâmetro opacityMode for algo diferente de DCOMPOSITION_OPACITY_MODE_INHERIT, as superfícies desse visual serão compostas com o modo de opacidade especificado. Além disso, esse modo de opacidade se torna o novo padrão para os filhos do visual atual. Ou seja, se o modo de opacidade dos filhos desse visual estiver inalterado ou explicitamente definido como DCOMPOSITION_OPACITY_MODE_INHERIT, as superfícies dos visuais filho serão compostas usando o modo de opacidade desse visual.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8.1 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2012 R2 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | dcomp.h |
| Biblioteca | Dcomp.lib |
| DLL | Dcomp.dll |