FrameworkElement.Triggers Propriedade

Definição

Obtém a coleção de disparadores estabelecida diretamente nesse elemento ou em elementos filho.Gets the collection of triggers established directly on this element, or in child elements.

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

Uma coleção fortemente tipada de objetos Trigger.A strongly typed collection of Trigger objects.

Comentários

Observação

Essa propriedade só pode ser definida em XAML (linguagem XAML)Extensible Application Markup Language (XAML) por meio da sintaxe de coleção mostrada ou acessando o objeto de coleção e usando seus vários métodos, como Add.This property can only be set in XAML (linguagem XAML)Extensible Application Markup Language (XAML) through the collection syntax shown, or by accessing the collection object and using its various methods such as Add. A propriedade para acessar o objeto de coleção em si é somente leitura, a coleção em si é de leitura/gravação.The property to access the collection object itself is read-only, the collection itself is read-write. A propriedade existe somente em elementos raiz; tentar encontrá-lo ou defini-lo em outro lugar fará com que uma exceção seja gerada.The property only exists on root elements; attempting to find it or set it elsewhere will cause an exception to be thrown.

Essa propriedade não permite que você examine os gatilhos que existem como parte dos estilos em uso neste elemento.This property does not enable you to examine triggers that exist as part of styles in use on this element. Ele apenas relata a coleção de gatilhos que são literalmente adicionados à coleção, seja em marcação ou código.It only reports the collection of triggers that are literally added to the collection, either in markup or code. Os elementos normalmente não têm esses elementos existentes por padrão (por meio de um modelo, por exemplo); é mais comum que os gatilhos provenientes da composição de controle sejam estabelecidos em estilos.Elements do not typically have such elements existing by default (through a template for instance); it is more common for triggers that come from control compositing to be established in styles instead.

Em termos de comportamento (e tentando estabelecer qual efeito veio de qual coleção de Triggers declarada de elemento), a condição de gatilho e o efeito de gatilho podem estar nesse elemento ou podem estar em seus elementos filho na árvore lógica.In terms of behavior (and trying to establish which effect came from which element's declared Triggers collection), both the triggering condition and the trigger effect might be on this element, or might be on its child elements in the logical tree. Observe que se você usar eventos de tempo de vida como Loaded para obter essa coleção, os gatilhos do elemento filho ainda não estarão totalmente carregados e a coleção será menor do que seria realmente no tempo de execução.Note that if you use lifetime events such as Loaded to get this collection, the child element's triggers might not yet be fully loaded, and the collection will be smaller than it would truly be at run time.

Observe que a coleção de gatilhos estabelecidos em um elemento suporta apenas EventTrigger, não gatilhos de propriedade (Trigger).Note that the collection of triggers established on an element only supports EventTrigger, not property triggers (Trigger). Se você precisar de gatilhos de propriedade, coloque-os dentro de um estilo ou modelo e, em seguida, atribua esse estilo ou modelo ao elemento diretamente por meio da propriedade Style ou indiretamente por meio de uma referência de estilo implícita.If you require property triggers, you must place these within a style or template and then assign that style or template to the element either directly through the Style property, or indirectly through an implicit style reference.

Uso do elemento propriedade XAMLXAML Property Element Usage

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

Valores XAMLXAML Values

oneOrMoreTriggersoneOrMoreTriggers
Um ou mais elementos de EventTrigger definidos.One or more defined EventTrigger elements. Espera-se que esse gatilho contenha referências e ações de storyboard válidas.Each such trigger is expected to contain valid storyboard actions and references. Observe que essa coleção só pode ser estabelecida no elemento raiz de uma página.Note that this collection can only be established on the root element of a page. Para obter mais informações, consulte Visão geral de storyboards.For more information, see Storyboards Overview.

Aplica-se a

Veja também