Trigger Класс

Определение

Пространство имен:

System.Windows

Сборка:

PresentationFramework.dll

Представляет триггер, который применяет значения свойств или выполняет действия условно.

public ref class Trigger : System::Windows::TriggerBase, System::ComponentModel::ISupportInitialize, System::Windows::Markup::IAddChild

[System.Windows.Markup.ContentProperty("Setters")]
[System.Windows.Markup.XamlSetTypeConverter("ReceiveTypeConverter")]
public class Trigger : System.Windows.TriggerBase, System.ComponentModel.ISupportInitialize, System.Windows.Markup.IAddChild

[<System.Windows.Markup.ContentProperty("Setters")>]
[<System.Windows.Markup.XamlSetTypeConverter("ReceiveTypeConverter")>]
type Trigger = class
    inherit TriggerBase
    interface ISupportInitialize
    interface IAddChild

Public Class Trigger
Inherits TriggerBase
Implements IAddChild, ISupportInitialize

Наследование

Object

DispatcherObject

DependencyObject

TriggerBase

Trigger

Атрибуты

ContentPropertyAttribute XamlSetTypeConverterAttribute

Реализации

IAddChild ISupportInitialize

Примеры

В следующем примере показан именованный Style элемент Button управления. Trigger Определяет Style элемент, который изменяет Foreground свойство кнопки при IsPressed использовании trueсвойства.

<Style x:Key="Triggers" TargetType="Button">
    <Style.Triggers>
    <Trigger Property="IsPressed" Value="true">
        <Setter Property = "Foreground" Value="Green"/>
    </Trigger>
    </Style.Triggers>
</Style>

Комментарии

WPF определяет свойства, соответствующие действиям конечных пользователей, например IsMouseOver свойству, заданному true при наведении курсора на объект или UIElement соответствующее IsMouseOver свойство.ContentElement Представление действий конечных пользователей в значениях свойств вместе с элементом Trigger позволяет стилям WPF изменять значения свойств на основе этих действий конечных пользователей, все из разметки.

Свойства, измененные триггерами, автоматически сбрасываются до предыдущего значения, когда активированное условие больше не удовлетворяется. Триггеры оптимизированы для временных состояний, которые, как ожидается, изменяются и возвращаются в исходное состояние, например IsPressed включено Button и IsSelected включено ListBoxItem. Интерес Property должен быть свойством зависимости.

Обратите внимание, что необходимо указать и PropertyValue свойства триггера Trigger , чтобы он был значимым. Если одно или оба свойства не заданы, создается исключение.

Setters Свойство Trigger объекта может состоять только из Setter объектов. Setter Добавление дочернего Trigger объекта в объект неявно добавляет его в SetterBaseCollectionTrigger объект. EventSetterобъекты не поддерживаются; поддерживает EventSetter только Style.Setters объекты.

Существуют другие типы триггеров. MultiTrigger позволяет применять изменения в зависимости от состояния нескольких свойств. EventTrigger позволяет применять изменения при возникновении события. DataTrigger и MultiDataTrigger предназначены для свойств, связанных с данными.

Конструкторы

Имя	Описание
Trigger()	Инициализирует новый экземпляр класса Trigger.

Свойства

Имя	Описание
DependencyObjectType	Возвращает объект DependencyObjectType , который упаковывает тип СРЕДЫ CLR этого экземпляра. (Унаследовано от DependencyObject)
Dispatcher	Dispatcher Возвращает это DispatcherObject значение, с которым связано. (Унаследовано от DispatcherObject)
EnterActions	Возвращает коллекцию объектов, применяемых при активации TriggerAction объекта триггера. Это свойство не применяется к классу EventTrigger . (Унаследовано от TriggerBase)
ExitActions	Возвращает коллекцию объектов, применяемых TriggerAction при неактивном объекте триггера. Это свойство не применяется к классу EventTrigger . (Унаследовано от TriggerBase)
IsSealed	Возвращает значение, указывающее, запечатан ли этот экземпляр (только для чтения). (Унаследовано от DependencyObject)
Property	Возвращает или задает свойство, возвращающее значение, которое сравнивается со Value свойством триггера. Сравнение — это проверка равенства ссылок.
Setters	Возвращает коллекцию Setter объектов, описывающих значения свойств, применяемые при выполнении указанного условия.
SourceName	Возвращает или задает имя объекта со свойством, которое приводит к применению связанных наборов.
Value	Возвращает или задает значение для сравнения со значением свойства элемента. Сравнение — это проверка равенства ссылок.

Методы

Имя	Описание
CheckAccess()	Определяет, имеет ли вызывающий поток доступ к этому DispatcherObject. (Унаследовано от DispatcherObject)
ClearValue(DependencyProperty)	Очищает локальное значение свойства. Свойство для очистки указывается идентификатором DependencyProperty . (Унаследовано от DependencyObject)
ClearValue(DependencyPropertyKey)	Очищает локальное значение свойства только для чтения. Свойство, которое необходимо очистить, задается параметром DependencyPropertyKey. (Унаследовано от DependencyObject)
CoerceValue(DependencyProperty)	Принуждает значение указанного свойства зависимостей. Это достигается путем вызова любой CoerceValueCallback функции, указанной в метаданных свойств для свойства зависимостей, так как он существует при вызове DependencyObject. (Унаследовано от DependencyObject)
Equals(Object)	Определяет, эквивалентен ли предоставленный DependencyObject объект текущему DependencyObject. (Унаследовано от DependencyObject)
GetHashCode()	Получает хэш-код для этого DependencyObject. (Унаследовано от DependencyObject)
GetLocalValueEnumerator()	Создает специализированный перечислитель для определения того, какие свойства зависимостей имеют локальные значения для этого DependencyObject. (Унаследовано от DependencyObject)
GetValue(DependencyProperty)	Возвращает текущее эффективное значение свойства зависимостей для этого экземпляра DependencyObject. (Унаследовано от DependencyObject)
InvalidateProperty(DependencyProperty)	Повторно вычисляет эффективное значение для указанного свойства зависимостей. (Унаследовано от DependencyObject)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Вызывается при каждом обновлении эффективного значения любого свойства DependencyObject зависимостей. Определенное свойство зависимостей, которое изменилось, сообщается в данных события. (Унаследовано от DependencyObject)
ReadLocalValue(DependencyProperty)	Возвращает локальное значение свойства зависимостей, если оно существует. (Унаследовано от DependencyObject)
ReceiveTypeConverter(Object, XamlSetTypeConverterEventArgs)	Обрабатывает случаи, когда преобразователь типов предоставляет значение для свойства Trigger объекта.
SetCurrentValue(DependencyProperty, Object)	Задает значение свойства зависимостей, не изменяя его источник значений. (Унаследовано от DependencyObject)
SetValue(DependencyProperty, Object)	Задает локальное значение свойства зависимостей, указанное его идентификатором свойства зависимостей. (Унаследовано от DependencyObject)
SetValue(DependencyPropertyKey, Object)	Задает локальное значение свойства зависимостей только для чтения, указанное DependencyPropertyKey идентификатором свойства зависимости. (Унаследовано от DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Возвращает значение, указывающее, должны ли процессы сериализации сериализовать значение для указанного свойства зависимостей. (Унаследовано от DependencyObject)
VerifyAccess()	Принудительно применяет, что вызывающий поток имеет доступ к этому DispatcherObject. (Унаследовано от DispatcherObject)

Явные реализации интерфейса

Имя	Описание
IAddChild.AddChild(Object)	Добавляет дочерний объект.
IAddChild.AddText(String)	Добавляет текстовое содержимое узла в объект.
ISupportInitialize.BeginInit()	Сигнализирует объекту о запуске инициализации.
ISupportInitialize.EndInit()	Сигнализирует объекту о завершении инициализации.