Trigger Classe

Definição

Namespace:: System.Windows

Assembly:: PresentationFramework.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

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 seu 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. EventSetter não há suporte para objetos; só Style.Setters dá EventSetter suporte a 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 ocorre um evento. DataTrigger e MultiDataTrigger são para propriedades associadas a dados.

Construtores

Nome	Description
Trigger()	Inicializa uma nova instância da classe Trigger.

Propriedades

Nome	Description
DependencyObjectType	Obtém o DependencyObjectType que encapsula o tipo CLR dessa instância. (Herdado de DependencyObject)
Dispatcher	Obtém o Dispatcher que DispatcherObject está associado. (Herdado de DispatcherObject)
EnterActions	Obtém uma coleção de TriggerAction objetos a serem aplicados quando o objeto de gatilho se torna ativo. Essa propriedade não se aplica à EventTrigger classe. (Herdado de TriggerBase)
ExitActions	Obtém uma coleção de TriggerAction objetos a serem aplicados quando o objeto de gatilho ficar inativo. Essa propriedade não se aplica à EventTrigger classe. (Herdado de TriggerBase)
IsSealed	Obtém um valor que indica se essa instância está lacrada no momento (somente leitura). (Herdado de DependencyObject)
Property	Obtém ou define a propriedade que retorna o valor que é comparado com a Value propriedade do gatilho. A comparação é uma verificação de igualdade de referência.
Setters	Obtém uma coleção de Setter objetos, que descrevem os valores de propriedade a serem aplicados 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

Nome	Description
CheckAccess()	Determina se o thread de chamada tem acesso a isso DispatcherObject. (Herdado de DispatcherObject)
ClearValue(DependencyProperty)	Limpa o valor local de uma propriedade. A propriedade a ser desmarcada é especificada por um DependencyProperty identificador. (Herdado de DependencyObject)
ClearValue(DependencyPropertyKey)	Limpa o valor local de uma propriedade somente leitura. A propriedade a ser desmarcada é especificada por um DependencyPropertyKey. (Herdado de DependencyObject)
CoerceValue(DependencyProperty)	Coagi o valor da propriedade de dependência especificada. Isso é feito invocando qualquer CoerceValueCallback função especificada nos metadados de propriedade para a propriedade de dependência como ela existe na chamada DependencyObject. (Herdado de DependencyObject)
Equals(Object)	Determina se um fornecido DependencyObject é equivalente ao atual DependencyObject. (Herdado de DependencyObject)
GetHashCode()	Obtém um código hash para isso DependencyObject. (Herdado de DependencyObject)
GetLocalValueEnumerator()	Cria um enumerador especializado para determinar quais propriedades de dependência têm valores definidos localmente.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 nesta instância de um DependencyObject. (Herdado de DependencyObject)
InvalidateProperty(DependencyProperty)	Reavalia o valor efetivo da propriedade de dependência especificada. (Herdado de DependencyObject)
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Invocado sempre que o valor efetivo de qualquer propriedade de dependência tiver DependencyObject sido atualizado. A propriedade de dependência específica que foi alterada é relatada nos dados do evento. (Herdado de DependencyObject)
ReadLocalValue(DependencyProperty)	Retorna o valor local de uma propriedade de dependência, se ela existir. (Herdado de DependencyObject)
ReceiveTypeConverter(Object, XamlSetTypeConverterEventArgs)	Manipula casos em que um conversor de tipo fornece um valor para uma propriedade de um Trigger objeto.
SetCurrentValue(DependencyProperty, Object)	Define o valor de uma propriedade de dependência sem alterar sua fonte de valor. (Herdado de DependencyObject)
SetValue(DependencyProperty, Object)	Define o valor local de uma propriedade de dependência, especificada por seu identificador de propriedade de dependência. (Herdado de DependencyObject)
SetValue(DependencyPropertyKey, Object)	Define o valor local de uma propriedade de dependência somente leitura, especificada pelo DependencyPropertyKey identificador 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 isso DispatcherObject. (Herdado de DispatcherObject)

Implantações explícitas de interface

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

Aplica-se a

Comentários

Esta página foi útil?

Partilhar via

Trigger Classe

Definição

Exemplos

Comentários

Construtores

Propriedades

Métodos

Implantações explícitas de interface

Aplica-se a

Comentários