FrameworkElement.Triggers Właściwość

Definicja

Pobiera kolekcję wyzwalaczy ustanowionych bezpośrednio w tym elemencie lub w elementach podrzędnych.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

Wartość właściwości

TriggerCollection

Kolekcja obiektów o jednoznacznie określonym typie Trigger .A strongly typed collection of Trigger objects.

Uwagi

Uwaga

Tę właściwość można ustawić tylko Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML) za pośrednictwem podanej składni kolekcji lub przez uzyskanie dostępu do obiektu kolekcja i użycie jego różnych metod, takich jak Add.This property can only be set in Extensible Application Markup Language (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. Właściwość uzyskiwania dostępu do obiektu kolekcji jest tylko do odczytu, a sama kolekcja to Read-Write.The property to access the collection object itself is read-only, the collection itself is read-write. Właściwość istnieje tylko w elementach głównych. próba znalezienia lub ustawienia go w innym miejscu spowoduje zgłoszenie wyjątku.The property only exists on root elements; attempting to find it or set it elsewhere will cause an exception to be thrown.

Ta właściwość nie pozwala na badanie wyzwalaczy, które istnieją jako część stylów używanych dla tego elementu.This property does not enable you to examine triggers that exist as part of styles in use on this element. Tylko raportuje kolekcja wyzwalaczy, które są dosłownie dodawane do kolekcji, w znacznikach lub kodzie.It only reports the collection of triggers that are literally added to the collection, either in markup or code. Elementy zazwyczaj nie mają takich elementów, które są domyślnie istniejące (za pomocą szablonu dla wystąpienia); jest to bardziej powszechne w przypadku wyzwalaczy, które pochodzą z składania, które mają zostać utworzone w stylach.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.

W warunkach zachowania (i próba ustalenia, który efekt pochodzi z kolekcji zadeklarowanej elementu Triggers ), zarówno warunek wyzwalania, jak i efekt wyzwalacza mogą znajdować się w tym elemencie lub mogą znajdować się w jego elementach podrzędnych drzewa logicznego.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. Należy pamiętać, że jeśli używasz zdarzeń okresu istnienia, takich jak Loaded Aby uzyskać tę kolekcję, wyzwalacze elementu podrzędnego mogą jeszcze nie być w pełni załadowane, a kolekcja będzie mniejsza niż w czasie wykonywania.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.

Należy zauważyć, że kolekcja wyzwalaczy ustanowionych w elemencie obsługuje tylko EventTrigger , a nie wyzwalaczy właściwości ( Trigger ).Note that the collection of triggers established on an element only supports EventTrigger, not property triggers (Trigger). Jeśli wymagane są wyzwalacze właściwości, należy umieścić je w obrębie stylu lub szablonu, a następnie przypisać ten styl lub szablon do elementu bezpośrednio przez Style Właściwość lub pośrednio za pomocą jawnego odwołania do stylu.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.

Użycie elementu właściwości języka XAMLXAML Property Element Usage

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

Wartości XAMLXAML Values

oneOrMoreTriggersoneOrMoreTriggers
Co najmniej jeden EventTrigger element zdefiniowany.One or more defined EventTrigger elements. Każdy taki wyzwalacz powinien zawierać prawidłowe akcje i odwołania scenorysu.Each such trigger is expected to contain valid storyboard actions and references. Należy zauważyć, że ta kolekcja może zostać ustanowiona tylko w elemencie głównym strony.Note that this collection can only be established on the root element of a page. Aby uzyskać więcej informacji, zobacz Omówienie scenorysów.For more information, see Storyboards Overview.

Dotyczy

Zobacz też