UIElement.Opacity UIElement.Opacity UIElement.Opacity UIElement.Opacity Property

Определение

Получает или задает коэффициент непрозрачности, применяемый ко всему элементу UIElement при его отрисовке в пользовательский интерфейсuser interface (UI).Gets or sets the opacity factor applied to the entire UIElement when it is rendered in the пользовательский интерфейсuser interface (UI). Это свойство зависимостей.This is a dependency property.

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; }
member this.Opacity : double with get, set
Public Property Opacity As Double

Значение свойства

Коэффициент непрозрачности.The opacity factor. По умолчанию непрозрачность равна 1,0.Default opacity is 1.0. Ожидаемые значения должны находиться в диапазоне от 0,0 до 1,0.Expected values are between 0.0 and 1.0.

Комментарии

Значение по умолчанию 1,0 является значением по умолчанию, предоставленным исходными метаданными этого UIElement свойства зависимостей в классе.The 1.0 default value is the default provided by the initial metadata of this dependency property on the UIElement class. Другие производные классы потенциально могут изменить это значение по умолчанию, переопределив метаданные в своем конструкторе класса.Other derived classes may potentially change this default value by overriding the metadata from within their class constructor.

Значение параметра Opacity не будет применяться к фактическому макету, если элемент также не являетсяIsVisible видимым true(значение).The value of Opacity won't be applied to actual layout unless the element is also visible (IsVisible is true).

Opacityприменяется из родительских элементов в дереве элементов вниз к дочерним элементам, но видимые эффекты вложенных параметров непрозрачности не указываются в значении свойства отдельных дочерних элементов.Opacity is applied from parent elements on down the element tree to child elements, but the visible effects of the nested opacity settings aren't indicated in the property value of individual child elements. Например, если список имеет непрозрачность 50% (0,5), а один из его элементов списка имеет собственную прозрачность, равную 20% (0,2), то непрозрачность, видимая для этого элемента списка, будет отображаться так, как если бы это было 10% (0,1), но Opacity значение свойства элемента списка по-прежнему будет 0,2 при запросе.For instance, if a list has a 50% (0.5) opacity and one of its list items has its own opacity set to 20% (0.2), the net visible opacity for that list item will be rendered as if it were 10% (0.1), but the property value of the list item Opacity property would still be 0.2 when queried.

Даже если объявленная или оцененная непрозрачность равна 0, элемент все еще участвует в событиях и командах ввода и потенциально может сосредоточиться.Even if the declared or evaluated opacity is 0, an element still participates in input events and commands, and is potentially focusable. Этот аспект может быть полезен, например, можно использовать объект непрозрачности (например, фигуру) для маскирования базовых объектов с прозрачными элементами.This aspect can be useful, for instance you can use an opacity-zero object (such as a shape) for masking underlying objects with transparent elements. Объект непрозрачности — ноль может обрабатывать всю обработку входных событий для базовой области.The opacity-zero object can then handle all the input event processing for an underlying area. Однако для объекта или фигуры должно быть задано значение Transparent, даже если это так, в противном случае проверка попадания не включена и никакие события не принимаются. Background FillHowever, the Background or Fill of the object or shape should be set to a value, even if it is Transparent, otherwise hit testing is not enabled, and no events are received.

Сведения о свойстве зависимостейDependency Property Information

Поле идентификатораIdentifier field OpacityProperty
Свойства метаданных, для которых задано значениеtrueMetadata properties set to true НетNone

Применяется к

Дополнительно