Trigger Trigger Trigger Trigger Class

Definição

Representa um gatilho que aplica valores de propriedade ou executa ações de forma condicional.Represents a trigger that applies property values or performs actions conditionally.

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
type Trigger = class
    inherit TriggerBase
    interface IAddChild
    interface ISupportInitialize
Public Class Trigger
Inherits TriggerBase
Implements IAddChild, ISupportInitialize
Herança
Atributos
Implementações

Exemplos

O exemplo a seguir mostra uma nomeada Style disponíveis para Button controles.The following example shows a named Style available to Button controls. O Style define uma Trigger elemento que muda a Foreground propriedade de um botão quando o IsPressed é de propriedade true.The Style defines a Trigger element that changes the Foreground property of a button when the IsPressed property is true.

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

Comentários

WPFWPF Define as propriedades que correspondem às ações do usuário final, como o IsMouseOver propriedade é definida como true quando o usuário passa o cursor sobre um UIElement ou correspondente IsMouseOver propriedade de um ContentElement.defines properties that correspond to end-user actions, such as the IsMouseOver property that is set to true when the user hovers the cursor over a UIElement or the corresponding IsMouseOver property of a ContentElement. Que representa as ações de usuário final em valores de propriedade, junto com o Trigger elemento, permite WPFWPF estilos para alterar os valores de propriedade com base nessas ações do usuário final, tudo a partir de dentro da marcação.Representing end-user actions in property values, along with the Trigger element, allows WPFWPF styles to change property values based on those end-user actions, all from within markup.

As propriedades alteradas por gatilhos são automaticamente redefinidas para seu valor anterior quando a condição de disparada não for atendida.The properties changed by triggers are automatically reset to their previous value when the triggered condition is no longer satisfied. Os gatilhos são otimizados para transitório estados que é esperado para alterar e estado de retorno original, tais como IsPressed na Button e IsSelected em ListBoxItem.Triggers are optimized for transient states which are expected to change and return to original state, such as IsPressed on Button and IsSelected on ListBoxItem. O Property de interesse deve ser uma propriedade de dependência.The Property of interest must be a dependency property.

Observe que você deve especificar ambos os Property e Value propriedades em um Trigger para o gatilho ser significativo.Note that you must specify both the Property and Value properties on a Trigger for the trigger to be meaningful. Se uma ou ambas as propriedades não forem definidas, uma exceção é lançada.If one or both of the properties are not set, an exception is thrown.

O Setters propriedade de um Trigger objeto pode conter apenas Setter objetos.The Setters property of a Trigger object can only consist of Setter objects. Adicionando um Setter filho para uma Trigger objeto adiciona implicitamente, para o SetterBaseCollection para o Trigger objeto.Adding a Setter child to a Trigger object implicitly adds it to the SetterBaseCollection for the Trigger object. EventSetter Não há suporte para objetos; somente Style.Setters dá suporte a EventSetter objetos.EventSetter objects are not supported; only Style.Setters supports EventSetter objects.

Há outros tipos de gatilhos.There are other types of triggers. MultiTrigger permite que você aplicar mudanças com base no estado de várias propriedades.MultiTrigger allows you to apply changes based on the state of multiple properties. EventTrigger permite que você aplique as alterações quando ocorre um evento.EventTrigger allows you to apply changes when an event occurs. DataTrigger e MultiDataTrigger são para propriedades de associação de dados.DataTrigger and MultiDataTrigger are for data-bound properties.

Construtores

Trigger() Trigger() Trigger() Trigger()

Inicializa uma nova instância da classe Trigger.Initializes a new instance of the Trigger class.

Propriedades

DependencyObjectType DependencyObjectType DependencyObjectType DependencyObjectType

Obtém o DependencyObjectType que encapsula o tipo CLRCLR dessa instância.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Inherited from DependencyObject)
Dispatcher Dispatcher Dispatcher Dispatcher

Obtém o Dispatcher ao qual este DispatcherObject está associado.Gets the Dispatcher this DispatcherObject is associated with.

(Inherited from DispatcherObject)
EnterActions EnterActions EnterActions EnterActions

Obtém uma coleção de objetos TriggerAction a ser aplicada quando o objeto gatilho se tornar ativo.Gets a collection of TriggerAction objects to apply when the trigger object becomes active. Essa propriedade não se aplica à classe EventTrigger.This property does not apply to the EventTrigger class.

(Inherited from TriggerBase)
ExitActions ExitActions ExitActions ExitActions

Obtém uma coleção de objetos TriggerAction a ser aplicada quando o objeto de gatilho se tornar inativo.Gets a collection of TriggerAction objects to apply when the trigger object becomes inactive. Essa propriedade não se aplica à classe EventTrigger.This property does not apply to the EventTrigger class.

(Inherited from TriggerBase)
IsSealed IsSealed IsSealed IsSealed

Obtém um valor que indica se essa instância está validada no momento (somente leitura).Gets a value that indicates whether this instance is currently sealed (read-only).

(Inherited from DependencyObject)
Property Property Property Property

Obtém ou define a propriedade que retorna o valor que é comparado com a propriedade Value do gatilho.Gets or sets the property that returns the value that is compared with the Value property of the trigger. A comparação é uma verificação de igualdade de referência.The comparison is a reference equality check.

Setters Setters Setters Setters

Obtém uma coleção de objetos Setter, que descrevem os valores de propriedade a aplicar quando a condição especificada for atendida.Gets a collection of Setter objects, which describe the property values to apply when the specified condition has been met.

SourceName SourceName SourceName SourceName

Obtém ou define o nome do objeto com a propriedade que faz com que os setters associados sejam aplicados.Gets or sets the name of the object with the property that causes the associated setters to be applied.

Value Value Value Value

Obtém ou define o valor a ser comparado com o valor da propriedade do elemento.Gets or sets the value to be compared with the property value of the element. A comparação é uma verificação de igualdade de referência.The comparison is a reference equality check.

Métodos

CheckAccess() CheckAccess() CheckAccess() CheckAccess()

Determina se o thread de chamada tem acesso a este DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)
ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty)

Limpa o valor local de uma propriedade.Clears the local value of a property. A propriedade a ser limpa é especificada por um identificador DependencyProperty.The property to be cleared is specified by a DependencyProperty identifier.

(Inherited from DependencyObject)
ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey)

Limpa o valor local de uma propriedade somente leitura.Clears the local value of a read-only property. A propriedade a ser limpa é especificada por um DependencyPropertyKey.The property to be cleared is specified by a DependencyPropertyKey.

(Inherited from DependencyObject)
CoerceValue(DependencyProperty) CoerceValue(DependencyProperty) CoerceValue(DependencyProperty) CoerceValue(DependencyProperty)

Converte o valor da propriedade de dependência especificada.Coerces the value of the specified dependency property. Isso é feito invocando qualquer função CoerceValueCallback especificada nos metadados de propriedade para a propriedade de dependência, visto que ela existe na chamada a DependencyObject.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Inherited from DependencyObject)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se um DependencyObject fornecido é equivalente ao DependencyObject atual.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Inherited from DependencyObject)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Obtém o código hash para esse DependencyObject.Gets a hash code for this DependencyObject.

(Inherited from DependencyObject)
GetLocalValueEnumerator() GetLocalValueEnumerator() GetLocalValueEnumerator() GetLocalValueEnumerator()

Cria um enumerador especializado para determinar quais propriedades de dependência têm valores definidos localmente nessa DependencyObject.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Inherited from DependencyObject)
GetType() GetType() GetType() GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Inherited from Object)
GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty)

Retorna o valor efetivo atual de uma propriedade de dependência nessa instância de um DependencyObject.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Inherited from DependencyObject)
InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty)

Reavalia o valor efetivo para a propriedade de dependência especificadaRe-evaluates the effective value for the specified dependency property

(Inherited from DependencyObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Inherited from Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs)

Invocado sempre que o valor efetivo de qualquer propriedade de dependência nesse DependencyObject for atualizada.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. A propriedade de dependência específica que mudou é relatada os dados do evento.The specific dependency property that changed is reported in the event data.

(Inherited from DependencyObject)
ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty)

Retorna o valor local de uma propriedade de dependência, local, se houver.Returns the local value of a dependency property, if it exists.

(Inherited from DependencyObject)
ReceiveTypeConverter(Object, XamlSetTypeConverterEventArgs) ReceiveTypeConverter(Object, XamlSetTypeConverterEventArgs) ReceiveTypeConverter(Object, XamlSetTypeConverterEventArgs) ReceiveTypeConverter(Object, XamlSetTypeConverterEventArgs)

Lida com casos em que um conversor de tipo fornece um valor para uma propriedade de um objeto Trigger.Handles cases where a type converter provides a value for a property of a Trigger object.

SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object)

Define o valor da propriedade de dependência sem alterar a origem do valor.Sets the value of a dependency property without changing its value source.

(Inherited from DependencyObject)
SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object)

Define o valor local de uma propriedade de dependência, especificada pelo identificador da propriedade de dependência.Sets the local value of a dependency property, specified by its dependency property identifier.

(Inherited from DependencyObject)
SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object)

Define o valor de uma propriedade de dependência somente leitura, especificada pelo identificador DependencyPropertyKey da propriedade de dependência.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Inherited from DependencyObject)
ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty)

Retorna um valor que indica se os processos de serialização devem serializar o valor da propriedade de dependência fornecida.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Inherited from DependencyObject)
ToString() ToString() ToString() ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Inherited from Object)
VerifyAccess() VerifyAccess() VerifyAccess() VerifyAccess()

Impõe que o thread de chamada tenha acesso a este DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)

Implantações explícitas de interface

IAddChild.AddChild(Object) IAddChild.AddChild(Object) IAddChild.AddChild(Object) IAddChild.AddChild(Object)

Adiciona um objeto filho.Adds a child object.

IAddChild.AddText(String) IAddChild.AddText(String) IAddChild.AddText(String) IAddChild.AddText(String)

Adiciona o conteúdo do texto de um nó ao objeto.Adds the text content of a node to the object.

ISupportInitialize.BeginInit() ISupportInitialize.BeginInit() ISupportInitialize.BeginInit() ISupportInitialize.BeginInit()

Sinaliza o objeto de que a inicialização está sendo iniciada.Signals the object that initialization is starting.

ISupportInitialize.EndInit() ISupportInitialize.EndInit() ISupportInitialize.EndInit() ISupportInitialize.EndInit()

Sinaliza o objeto de que a inicialização está sendo concluída.Signals the object that initialization is complete.

Aplica-se a

Veja também