FrameworkElement.Triggers Propriedade

Definição

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Obtém a coleção de disparadores estabelecida diretamente nesse elemento ou em elementos filho.

public:
 property System::Windows::TriggerCollection ^ Triggers { System::Windows::TriggerCollection ^ get(); };

public System.Windows.TriggerCollection Triggers { get; }

member this.Triggers : System.Windows.TriggerCollection

Public ReadOnly Property Triggers As TriggerCollection

Valor da propriedade

TriggerCollection

Uma coleção fortemente tipada de objetos Trigger.

Comentários

Observação

Essa propriedade só pode ser definida em XAML (Extensible Application Markup Language) por meio da sintaxe da coleção mostrada ou acessando o objeto de coleção e usando seus vários métodos, como Add. A propriedade para acessar o próprio objeto de coleção é somente leitura, a coleção em si é de leitura/gravação. A propriedade existe apenas em elementos raiz; tentar encontrá-lo ou defini-lo em outro lugar fará com que uma exceção seja gerada.

Essa propriedade não permite examinar gatilhos que existem como parte dos estilos em uso neste elemento. Ele relata apenas a coleção de gatilhos que são literalmente adicionados à coleção, seja na marcação ou no código. Os elementos normalmente não têm esses elementos existentes por padrão (por meio de um modelo, por exemplo); é mais comum que gatilhos provenientes da composição de controle sejam estabelecidos em estilos.

Em termos de comportamento (e tentando estabelecer qual efeito veio da coleção declarada Triggers do elemento), tanto a condição de gatilho quanto o efeito de gatilho podem estar nesse elemento ou podem estar em seus elementos filho na árvore lógica. Observe que, se você usar eventos de tempo de vida como Loaded para obter essa coleção, os gatilhos do elemento filho podem ainda não estar totalmente carregados e a coleção será menor do que seria realmente em tempo de execução.

Observe que a coleção de gatilhos estabelecidos em um elemento dá suporte EventTriggerapenas a , não a gatilhos de propriedade (Trigger). Se você precisar de gatilhos de propriedade, coloque-os em um estilo ou modelo e, em seguida, atribua esse estilo ou modelo ao elemento diretamente por meio da Style propriedade ou indiretamente por meio de uma referência de estilo implícita.

Uso do elemento propriedade XAML

<object>  
  <object.Triggers>  
    oneOrMoreTriggers  
  </object.Triggers>  
</object>  

Valores XAML

oneOrMoreTriggers
Um ou mais elementos definidos EventTrigger . Espera-se que cada gatilho contenha referências e ações válidas do storyboard. Observe que essa coleção só pode ser estabelecida no elemento raiz de uma página. Para obter mais informações, consulte Visão geral de storyboards.

Confira também

• EventTrigger