Trigger Classe

Definição

Espaço de Nomes:: System.Windows

Assemblagem:: PresentationFramework.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

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

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 seguinte mostra um nome Style disponível para Button controlos. Define Style 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>

Observações

WPF define propriedades que correspondem às ações do utilizador final, como a propriedade IsMouseOver que é definida para true quando o utilizador paira o cursor sobre um UIElement ou a propriedade correspondente IsMouseOver de um ContentElement. Representar as ações do utilizador final em valores de propriedades, juntamente com o elemento Trigger, permite que WPF estilos alterem os valores das propriedades com base nessas ações do utilizador final, tudo a partir da marcação.

As propriedades alteradas pelos gatilhos são automaticamente reiniciadas para o seu valor anterior quando a condição desencadeada deixa de ser satisfeita. Os gatilhos são otimizados para estados transitórios que se espera que mudem e regressem ao estado original, como IsPressed em .Button IsSelected ListBoxItem O Property de interesse deve ser uma propriedade de dependência.

Note que deve especificar ambas as Property propriedades e Value em a Trigger para que o gatilho tenha significado. Se uma ou ambas as propriedades não estiverem definidas, é lançada uma exceção.

A Setters propriedade de um Trigger objeto só pode consistir em Setter objetos. Adicionar um Setter filho a um Trigger objeto implícitamente adiciona-o ao SetterBaseCollection para o Trigger objeto. EventSetter os objetos não são suportados; Só Style.Setters suporta EventSetter objetos.

Existem 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 ligadas a dados.

Construtores

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

Propriedades

Name	Description
DependencyObjectType	Obtém o DependencyObjectType que envolve o tipo CLR desta instância. (Herdado de DependencyObject)
Dispatcher	Percebe o Dispatcher que isto DispatcherObject está associado. (Herdado de DispatcherObject)
EnterActions	Obtém uma coleção de TriggerAction objetos para aplicar quando o objeto de disparo se torna ativo. Esta característica não se aplica à EventTrigger classe. (Herdado de TriggerBase)
ExitActions	Obtém uma coleção de TriggerAction objetos para aplicar quando o objeto gatilho se torna inativo. Esta característica não se aplica à EventTrigger classe. (Herdado de TriggerBase)
IsSealed	Recebe um valor que indica se esta instância está atualmente selada (apenas leitura). (Herdado de DependencyObject)
Property	Obtém ou define a propriedade que devolve o valor que é comparado com a Value propriedade do gatilho. A comparação é uma verificação de igualdade de referências.
Setters	Obtém uma coleção de Setter objetos, que descrevem os valores das propriedades a aplicar quando a condição especificada for cumprida.
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 comparar com o valor da propriedade do elemento. A comparação é uma verificação de igualdade de referências.

Métodos

Name	Description
CheckAccess()	Determina se o thread que chama 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 DependencyProperty identificador. (Herdado de DependencyObject)
ClearValue(DependencyPropertyKey)	Limpa o valor local de uma propriedade de apenas leitura. O imóvel a ser limpo é especificado por um DependencyPropertyKey. (Herdado de DependencyObject)
CoerceValue(DependencyProperty)	Coage o valor da propriedade de dependência especificada. Isto é conseguido invocando qualquer CoerceValueCallback função especificada nos metadados da propriedade para a propriedade de dependência tal como existe na chamada DependencyObject. (Herdado de DependencyObject)
Equals(Object)	Determina se um fornecido DependencyObject é equivalente à corrente DependencyObject. (Herdado de DependencyObject)
GetHashCode()	Obtém um código de hash para isto DependencyObject. (Herdado de DependencyObject)
GetLocalValueEnumerator()	Cria um enumerador especializado para determinar quais as propriedades de dependência que têm valores localmente definidos neste DependencyObject. (Herdado de DependencyObject)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetValue(DependencyProperty)	Devolve 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 atual Object. (Herdado de Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Invocado sempre que o valor efetivo de qualquer propriedade de dependência disto DependencyObject for atualizado. A propriedade específica da dependência que mudou é reportada nos dados do evento. (Herdado de DependencyObject)
ReadLocalValue(DependencyProperty)	Devolve o valor local de uma propriedade de dependência, se esta existir. (Herdado de DependencyObject)
ReceiveTypeConverter(Object, XamlSetTypeConverterEventArgs)	Trata de casos em que um conversor de tipos fornece um valor para uma propriedade de um Trigger objeto.
SetCurrentValue(DependencyProperty, Object)	Define o valor de uma propriedade de dependência sem alterar a sua fonte de valor. (Herdado de DependencyObject)
SetValue(DependencyProperty, Object)	Define o valor local de uma propriedade de dependência, especificado pelo seu identificador de propriedade de dependência. (Herdado de DependencyObject)
SetValue(DependencyPropertyKey, Object)	Define o valor local de uma propriedade de dependência somente de leitura, especificado pelo DependencyPropertyKey identificador da propriedade de dependência. (Herdado de DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Devolve um valor que indica se os processos de serialização devem serializar o valor da propriedade de dependência fornecida. (Herdado de DependencyObject)
ToString()	Devolve uma cadeia que representa o objeto atual. (Herdado de Object)
VerifyAccess()	Faz cumprir que o thread que chama tem acesso a este DispatcherObject. (Herdado de DispatcherObject)

Implementações de Interface Explícita

Name	Description
IAddChild.AddChild(Object)	Adiciona um objeto filho.
IAddChild.AddText(String)	Adiciona o conteúdo textual de um nó ao objeto.
ISupportInitialize.BeginInit()	Sinaliza ao objeto que a inicialização está a começar.
ISupportInitialize.EndInit()	Sinaliza ao objeto que a inicialização está completa.

Aplica-se a

Comentários

Esta página foi útil?