Trigger Classe

Definição

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Representa um gatilho que aplica valores de propriedade ou executa ações de forma condicional.

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

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

[System.Windows.Markup.ContentProperty("Setters")]
public class Trigger : System.Windows.TriggerBase, 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")>]
type Trigger = class
    inherit TriggerBase
    interface IAddChild

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

[<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

Public Class Trigger
Inherits TriggerBase
Implements IAddChild, ISupportInitialize

Herança

Object

DispatcherObject

DependencyObject

TriggerBase

Trigger

Atributos

ContentPropertyAttribute XamlSetTypeConverterAttribute

Implementações

IAddChild ISupportInitialize

Exemplos

O exemplo a seguir mostra um nome Style disponível para Button controles. O Style define um Trigger elemento que altera a Foreground propriedade de um botão quando a IsPressed propriedade é 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

O WPF define propriedades que correspondem a ações do usuário final, como a IsMouseOver propriedade definida para true quando o usuário passa o cursor sobre uma UIElement ou a propriedade correspondente IsMouseOver de um ContentElement. Representar ações do usuário final em valores de propriedade, juntamente com o elemento, permite que os Trigger estilos do WPF alterem valores de propriedade com base nessas ações do usuário final, tudo de dentro da marcação.

As propriedades alteradas por gatilhos são automaticamente redefinidas para o valor anterior quando a condição disparada não é mais atendida. Os gatilhos são otimizados para estados transitórios que devem ser alterados e retornados ao estado original, como IsPressed ativado Button e IsSelected ativado ListBoxItem. O Property interesse deve ser uma propriedade de dependência.

Observe que você deve especificar as propriedades e Value as Property propriedades em um Trigger para que o gatilho seja significativo. Se uma ou ambas as propriedades não estiverem definidas, uma exceção será gerada.

A Setters propriedade de um Trigger objeto só pode consistir em Setter objetos. Adicionar um Setter filho a um Trigger objeto o adiciona implicitamente ao SetterBaseCollection Trigger objeto. EventSetternão há suporte para objetos; só dá EventSetter suporte a Style.Setters objetos.

Há outros tipos de gatilhos. MultiTrigger permite aplicar alterações com base no estado de várias propriedades. EventTrigger permite aplicar alterações quando um evento ocorre. DataTrigger e MultiDataTrigger são para propriedades associadas a dados.

Construtores

Trigger()

Inicializa uma nova instância da classe Trigger.

Propriedades

DependencyObjectType	Obtém o DependencyObjectType que encapsula o tipo CLR dessa instância. (Herdado de DependencyObject)
Dispatcher	Obtém o Dispatcher ao qual este DispatcherObject está associado. (Herdado de DispatcherObject)
EnterActions	Obtém uma coleção de objetos TriggerAction a ser aplicada quando o objeto gatilho se tornar ativo. Essa propriedade não se aplica à classe EventTrigger. (Herdado de TriggerBase)
ExitActions	Obtém uma coleção de objetos TriggerAction a ser aplicada quando o objeto de gatilho se tornar inativo. Essa propriedade não se aplica à classe EventTrigger. (Herdado de TriggerBase)
IsSealed	Obtém um valor que indica se essa instância está validada no momento (somente leitura). (Herdado de DependencyObject)
Property	Obtém ou define a propriedade que retorna o valor que é comparado com a propriedade Value do gatilho. A comparação é uma verificação de igualdade de referência.
Setters	Obtém uma coleção de objetos Setter, que descrevem os valores de propriedade a aplicar quando a condição especificada for atendida.
SourceName	Obtém ou define o nome do objeto com a propriedade que faz com que os setters associados sejam aplicados.
Value	Obtém ou define o valor a ser comparado com o valor da propriedade do elemento. A comparação é uma verificação de igualdade de referência.

Métodos

CheckAccess()	Determina se o thread de chamada tem acesso a este DispatcherObject. (Herdado de DispatcherObject)
ClearValue(DependencyProperty)	Limpa o valor local de uma propriedade. A propriedade a ser limpa é especificada por um identificador DependencyProperty. (Herdado de DependencyObject)
ClearValue(DependencyPropertyKey)	Limpa o valor local de uma propriedade somente leitura. A propriedade a ser limpa é especificada por um DependencyPropertyKey. (Herdado de DependencyObject)
CoerceValue(DependencyProperty)	Converte o valor da propriedade de dependência especificada. 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. (Herdado de DependencyObject)
Equals(Object)	Determina se um DependencyObject fornecido é equivalente ao DependencyObject atual. (Herdado de DependencyObject)
GetHashCode()	Obtém o código hash para esse DependencyObject. (Herdado de DependencyObject)
GetLocalValueEnumerator()	Cria um enumerador especializado para determinar quais propriedades de dependência têm valores definidos localmente nessa DependencyObject. (Herdado de DependencyObject)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetValue(DependencyProperty)	Retorna o valor efetivo atual de uma propriedade de dependência nessa instância de um DependencyObject. (Herdado de DependencyObject)
InvalidateProperty(DependencyProperty)	Reavalia o valor efetivo para a propriedade de dependência especificada. (Herdado de DependencyObject)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Invocado sempre que o valor efetivo de qualquer propriedade de dependência nesse DependencyObject for atualizado. A propriedade de dependência específica que mudou é relatada os dados do evento. (Herdado de DependencyObject)
ReadLocalValue(DependencyProperty)	Retorna o valor local de uma propriedade de dependência, local, se houver. (Herdado de DependencyObject)
ReceiveTypeConverter(Object, XamlSetTypeConverterEventArgs)	Lida com casos em que um conversor de tipo fornece um valor para uma propriedade de um objeto Trigger.
SetCurrentValue(DependencyProperty, Object)	Define o valor da propriedade de dependência sem alterar a origem do valor. (Herdado de DependencyObject)
SetValue(DependencyProperty, Object)	Define o valor local de uma propriedade de dependência, especificada pelo identificador da propriedade de dependência. (Herdado de DependencyObject)
SetValue(DependencyPropertyKey, Object)	Define o valor de uma propriedade de dependência somente leitura, especificada pelo identificador DependencyPropertyKey da propriedade de dependência. (Herdado de DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Retorna um valor que indica se os processos de serialização devem serializar o valor da propriedade de dependência fornecida. (Herdado de DependencyObject)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
VerifyAccess()	Impõe que o thread de chamada tenha acesso a este DispatcherObject. (Herdado de DispatcherObject)

Implantações explícitas de interface

IAddChild.AddChild(Object)	Adiciona um objeto filho.
IAddChild.AddText(String)	Adiciona o conteúdo do texto de um nó ao objeto.
ISupportInitialize.BeginInit()	Sinaliza o objeto de que a inicialização está sendo iniciada.
ISupportInitialize.EndInit()	Sinaliza o objeto de que a inicialização está sendo concluída.

Confira também

• Introdução ao exemplo de modelagem e estilo