Trigger Clase

Definición

Espacio de nombres:

System.Windows

Ensamblado:

PresentationFramework.dll

Representa un desencadenador que aplica valores de propiedad o realiza acciones de forma condicional.

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

Herencia

Object

DispatcherObject

DependencyObject

TriggerBase

Trigger

Atributos

ContentPropertyAttribute XamlSetTypeConverterAttribute

Implementaciones

IAddChild ISupportInitialize

Ejemplos

En el ejemplo siguiente se muestra un elemento con nombre Style disponible para Button los controles. Style define un Trigger elemento que cambia la Foreground propiedad de un botón cuando la IsPressed propiedad es true.

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

Comentarios

WPF define las propiedades que corresponden a acciones del usuario final, como la IsMouseOver propiedad establecida true en cuando el usuario mantiene el cursor sobre o UIElement la propiedad correspondiente IsMouseOver de .ContentElement Representar acciones de usuario final en valores de propiedad, junto con el Trigger elemento , permite que los estilos de WPF cambien los valores de propiedad en función de esas acciones del usuario final, todo desde el marcado.

Las propiedades modificadas por desencadenadores se restablecen automáticamente a su valor anterior cuando la condición desencadenada ya no se cumple. Los desencadenadores están optimizados para estados transitorios que se espera que cambien y vuelvan al estado original, como IsPressed en Button y IsSelected en ListBoxItem. El Property de interés debe ser una propiedad de dependencia.

Tenga en cuenta que debe especificar las Property propiedades y Value en para Trigger que el desencadenador sea significativo. Si no se establece una o ambas propiedades, se produce una excepción.

La Setters propiedad de un Trigger objeto solo puede constar de Setter objetos . Agregar un Setter elemento secundario a un Trigger objeto lo agrega implícitamente al SetterBaseCollection objeto para el Trigger objeto . EventSetter no se admiten objetos; solo Style.Setters admite EventSetter objetos .

Hay otros tipos de desencadenadores. MultiTrigger permite aplicar cambios en función del estado de varias propiedades. EventTrigger permite aplicar cambios cuando se produce un evento. DataTrigger y MultiDataTrigger son para las propiedades enlazadas a datos.

Constructores

Trigger()

Inicializa una nueva instancia de la clase Trigger.

Propiedades

DependencyObjectType	Obtiene el DependencyObjectType objeto que encapsula el tipo CLR de esta instancia. (Heredado de DependencyObject)
Dispatcher	Obtiene el objeto Dispatcher al que está asociado DispatcherObject. (Heredado de DispatcherObject)
EnterActions	Obtiene una colección de objetos TriggerAction que se aplican cuando el objeto desencadenador pasa a estar activo. Esta propiedad no se aplica a la clase EventTrigger. (Heredado de TriggerBase)
ExitActions	Obtiene una colección de objetos TriggerAction que se aplican cuando el objeto desencadenador pasa a estar inactivo. Esta propiedad no se aplica a la clase EventTrigger. (Heredado de TriggerBase)
IsSealed	Obtiene un valor que indica si esta instancia está actualmente sellada (es de solo lectura). (Heredado de DependencyObject)
Property	Obtiene o establece la propiedad que devuelve el valor que se compara con la propiedad Value del desencadenador. La comparación es una comprobación de la igualdad de referencias.
Setters	Obtiene una colección de objetos Setter, que describen los valores de propiedad que se van a aplicar si se cumple la condición especificada.
SourceName	Obtiene o establece el nombre del objeto con la propiedad que hace que se apliquen los establecedores asociados.
Value	Obtiene o establece el valor que se va a comparar con el valor de propiedad del elemento. La comparación es una comprobación de la igualdad de referencias.

Métodos

CheckAccess()	Determina si el subproceso de la llamada tiene acceso a DispatcherObject. (Heredado de DispatcherObject)
ClearValue(DependencyProperty)	Borra el valor local de una propiedad. La propiedad que se va a borrar se especifica mediante un identificador DependencyProperty. (Heredado de DependencyObject)
ClearValue(DependencyPropertyKey)	Borra el valor local de una propiedad de solo lectura. La propiedad que se va a borrar se especifica mediante un DependencyPropertyKey. (Heredado de DependencyObject)
CoerceValue(DependencyProperty)	Convierte el valor de la propiedad de dependencia especificada. Esto se logra invocando cualquier función CoerceValueCallback especificada en los metadatos de la propiedad de dependencia tal como existe en la clase DependencyObject que llama. (Heredado de DependencyObject)
Equals(Object)	Determina si un objeto DependencyObject proporcionado es equivalente al objeto DependencyObject actual. (Heredado de DependencyObject)
GetHashCode()	Obtiene un código hash de este objeto DependencyObject. (Heredado de DependencyObject)
GetLocalValueEnumerator()	Crea un enumerador especializado para determinar qué propiedades de dependencia han establecido localmente los valores en DependencyObject. (Heredado de DependencyObject)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
GetValue(DependencyProperty)	Devuelve el valor efectivo actual de una propiedad de dependencia en esta instancia de un DependencyObject. (Heredado de DependencyObject)
InvalidateProperty(DependencyProperty)	Vuelve a evaluar el valor efectivo para la propiedad de dependencia especificada. (Heredado de DependencyObject)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Se invoca cuando se actualiza el valor efectivo de alguna propiedad de dependencia en este DependencyObject. La propiedad de dependencia específica que cambió se notifica en los datos de evento. (Heredado de DependencyObject)
ReadLocalValue(DependencyProperty)	Devuelve el valor local de una propiedad de dependencia, si existe. (Heredado de DependencyObject)
ReceiveTypeConverter(Object, XamlSetTypeConverterEventArgs)	Administra los casos en los que un convertidor de tipos proporciona un valor para una propiedad de un objeto Trigger.
SetCurrentValue(DependencyProperty, Object)	Establece el valor de una propiedad de dependencia sin cambiar el origen del valor. (Heredado de DependencyObject)
SetValue(DependencyProperty, Object)	Establece el valor local de una propiedad de dependencia, especificado mediante el identificador de la propiedad de dependencia. (Heredado de DependencyObject)
SetValue(DependencyPropertyKey, Object)	Establece el valor local de una propiedad de dependencia de solo lectura, especificado por el identificador DependencyPropertyKey de la propiedad de dependencia. (Heredado de DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Devuelve un valor que indica si los procesos de serialización deben serializar el valor de la propiedad de dependencia especificada. (Heredado de DependencyObject)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
VerifyAccess()	Exige que el subproceso de la llamada tenga acceso a DispatcherObject. (Heredado de DispatcherObject)

Implementaciones de interfaz explícitas

IAddChild.AddChild(Object)	Agrega un objeto secundario.
IAddChild.AddText(String)	Agrega el contenido de texto de un nodo al objeto.
ISupportInitialize.BeginInit()	Indica al objeto que está comenzando la inicialización.
ISupportInitialize.EndInit()	Indica al objeto que se ha completado la inicialización.

Consulte también

• Introducción al ejemplo de aplicación de estilos y plantillas