AmbientAttributes.alphaBlendTo

  • Artigo

[O recurso associado a esta página, Reprodutor Multimídia do Windows SDK, é um recurso herdado. Foi substituído pelo MediaPlayer. O MediaPlayer foi otimizado para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use o MediaPlayer em vez de Reprodutor Multimídia do Windows SDK, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O método alphaBlendTo ajusta a propriedade alphaBlend durante um período de tempo.

        elementID.alphaBlendTo(newVal, alphaTime)

Parâmetros

newVal

Número (longo) que especifica o novo valor de opacidade. Varia de 0 (sem opacidade) a 255 (opacidade total).

alphaTime

Número (longo) que especifica o tempo, em milissegundos, que leva o elemento para alterar a opacidade.

Valor Retornado

Esse método não retorna um valor.

Comentários

Esse método é útil para fazer com que os elementos apareçam ou desapareçam gradualmente.

Quando você usa alphaBlendTo com um elemento TEXT que não tem o backgroundColor especificado, uma cor da tela de fundo preta será usada. Se a cor de primeiro plano também for preta (que é o valor padrão para TEXT.foregroundColor), seu texto pode se tornar ilegível. Para evitar isso, sempre especifique o atributo backgroundColor ou defina foregroundColor como uma cor diferente de preto.

Observação

Não há suporte para esse atributo no Windows 98.

Requisitos

Requisito Valor
Versão
 série Reprodutor Multimídia do Windows 9 ou posterior

Confira também

Atributos de ambiente

AmbientAttributes.alphaBlend

Elemento TEXT

TEXT.backgroundColor

TEXT.foregroundColor