Partilhar via


UIElement.Opacity Propriedade

Definição

Obtém ou define o fator de opacidade aplicado ao todo UIElement quando ele é renderizado na interface do usuário (interface do usuário). É uma propriedade de dependência.

public:
 property double Opacity { double get(); void set(double value); };
[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
public double Opacity { get; set; }
[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
member this.Opacity : double with get, set
Public Property Opacity As Double

Valor da propriedade

Double

O fator de opacidade. A opacidade padrão é 1.0. Os valores esperados estão entre 0.0 e 1.0.

Atributos

Comentários

O valor padrão 1.0 é o padrão fornecido pelos metadados iniciais dessa propriedade de dependência na UIElement classe. Outras classes derivadas podem potencialmente alterar esse valor padrão substituindo os metadados de dentro do construtor de classe.

O valor de Opacity não será aplicado ao layout real, a menos que o elemento também esteja visível (IsVisible é true).

Opacity é aplicado de elementos pai na árvore de elementos para baixo em elementos filho, mas os efeitos visíveis das configurações de opacidade aninhadas não são indicados no valor da propriedade de elementos filho individuais. Por exemplo, se uma lista tiver uma opacidade de 50% (0,5) e um de seus itens de lista tiver sua própria opacidade definida como 20% (0,2), a opacidade visível líquida desse item de lista será renderizada como se fosse 10% (0,1), mas o valor da propriedade de item Opacity de lista ainda seria 0,2 quando consultado.

Mesmo que a opacidade declarada ou avaliada seja 0, um elemento ainda participará de eventos e comandos de entrada e é potencialmente focalizável. Esse aspecto pode ser útil, por exemplo, você pode usar um objeto opacity-zero (como uma forma) para mascarar objetos subjacentes com elementos transparentes. O objeto opacity-zero pode manipular todo o processamento de eventos de entrada para uma área subjacente. No entanto, o Background ou Fill do objeto ou forma deve ser definido como um valor, mesmo que seja Transparent, caso contrário, o teste de ocorrência não está habilitado e nenhum evento é recebido.

Informações da propriedade de dependência

Campo Identificador OpacityProperty
Propriedades de metadados definidas como true Nenhum

Aplica-se a

Confira também