UIElement.Opacity Свойство

Определение

Возвращает или задает коэффициент непрозрачности, применяемый ко всему UIElement при отрисовке в пользовательском интерфейсе. Это свойство зависимостей.

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

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

Double

Коэффициент непрозрачности. По умолчанию непрозрачность равна 1,0. Ожидаемые значения должны находиться в диапазоне от 0,0 до 1,0.

Атрибуты

Комментарии

Значение по умолчанию 1.0 — это значение по умолчанию, предоставляемое начальными метаданными этого свойства зависимостей класса UIElement . Другие производные классы могут изменить это значение по умолчанию, переопределив метаданные из конструктора класса.

Значение не будет применяться к фактическому Opacity макету, если элемент также не виден (IsVisible is true).

Opacity применяется из родительских элементов вниз по дереву элементов к дочерним элементам, но видимые эффекты вложенных параметров непрозрачности не указываются в значении свойства отдельных дочерних элементов. Например, если список имеет непрозрачность 50 % (0,5), а один из его элементов списка имеет собственный непрозрачность, равный 20 % (0,2), то чистая видимая непрозрачность для этого элемента списка будет отображаться так, как если бы это было 10 % (0,1), но значение свойства свойства элемента Opacity списка по-прежнему будет равно 0,2 при запросе.

Даже если объявленная или оцененная непрозрачность имеет значение 0, элемент по-прежнему участвует в входных событиях и командах и может быть ориентирован на фокус. Этот аспект может быть полезен, например, можно использовать непрозрачность нулевого объекта (например, фигуру) для маскирования базовых объектов с прозрачными элементами. Затем объект opacity-zero может обрабатывать всю обработку входных событий для базовой области. Background Fill Однако для объекта или фигуры должно быть задано значение, даже если оно имеет значениеTransparent, в противном случае проверка попадания не включена, и события не получены.

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

Поле идентификатора OpacityProperty
Metadata properties set to true Нет

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

См. также раздел