Compartilhar via


Método IDCompositionEffectGroup::SetOpacity(IDCompositionAnimation*) (dcomp.h)

Anima o valor da propriedade Opacity.

Sintaxe

HRESULT SetOpacity(
  [in] IDCompositionAnimation *animation
);

Parâmetros

[in] animation

Tipo: IDCompositionAnimation*

Uma animação que representa como o valor da propriedade Opacity é alterado ao longo do tempo. Esse parâmetro não deve ser NULL.

Retornar valor

Tipo: HRESULT

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

Esse método faz uma cópia da animação especificada. Se o objeto referenciado pelo parâmetro de animação for alterado após chamar esse método, a alteração não afetará a propriedade Opacity, a menos que esse método seja chamado novamente. Se a propriedade Opacity tiver sido animada anteriormente, chamar esse método substituirá a animação anterior pela nova animação.

Esse método falhará se a animação for um ponteiro inválido ou se não tiver sido criada pela mesma interface IDCompositionDevice que o grupo de efeitos de composição afetado. A interface não pode ser uma implementação personalizada; somente interfaces criadas pelo Microsoft DirectComposition podem ser usadas com esse método.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho dcomp.h
Biblioteca Dcomp.lib
DLL Dcomp.dll

Confira também

IDCompositionEffectGroup