Trigger Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Představuje trigger, který používá hodnoty vlastností nebo provádí akce podmíněně.
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
- Dědičnost
- Atributy
- Implementuje
Příklady
Následující příklad ukazuje pojmenovanou Style dostupnou ovládacím prvkům Button . Definuje Style prvek, který změní Foreground vlastnost tlačítka při IsPressed vlastnosti je true.Trigger
<Style x:Key="Triggers" TargetType="Button">
<Style.Triggers>
<Trigger Property="IsPressed" Value="true">
<Setter Property = "Foreground" Value="Green"/>
</Trigger>
</Style.Triggers>
</Style>
Poznámky
WPF definuje vlastnosti, které odpovídají akcím koncového uživatele, například IsMouseOver vlastnost, která je nastavena true , když uživatel najede kurzorem na UIElement nebo odpovídající IsMouseOver vlastnost objektu ContentElement. Představuje akce koncového uživatele v hodnotách vlastností spolu s Trigger elementem, umožňuje WPF změnit hodnoty vlastností na základě těchto akcí koncového uživatele, a to vše z revize.
Vlastnosti změněné aktivačními událostmi se automaticky resetují na předchozí hodnotu, pokud již není aktivační podmínka splněna. Triggery jsou optimalizované pro přechodné stavy, u kterých se očekává změna a návrat do původního stavu, například IsPressed zapnuto Button a IsSelected zapnuto ListBoxItem. Zájem Property musí být vlastnost závislosti.
Mějte na paměti, že pro trigger musíte zadat jak PropertyValue vlastnosti, tak i vlastnosti Trigger , které mají být smysluplné. Pokud jedna nebo obě vlastnosti nejsou nastaveny, vyvolá se výjimka.
Setters Vlastnost objektu Trigger se může skládat pouze z Setter objektů. Přidání podřízeného Setter objektu do objektu Trigger jej implicitně přidá do objektu SetterBaseCollectionTrigger . EventSetterobjekty nejsou podporovány; podporuje EventSetter pouze Style.Setters objekty.
Existují i jiné typy triggerů. MultiTrigger umožňuje použít změny na základě stavu více vlastností. EventTrigger umožňuje použít změny, když dojde k události. DataTrigger a MultiDataTrigger jsou určené pro vlastnosti vázané na data.
Konstruktory
| Name | Description |
|---|---|
| Trigger() |
Inicializuje novou instanci Trigger třídy. |
Vlastnosti
| Name | Description |
|---|---|
| DependencyObjectType |
DependencyObjectType Získá ten, který zabalí typ CLR této instance. (Zděděno od DependencyObject) |
| Dispatcher |
Dispatcher Získá toto DispatcherObject je přidružené. (Zděděno od DispatcherObject) |
| EnterActions |
Získá kolekci TriggerAction objektů, které se použijí při aktivaci objektu triggeru. Tato vlastnost se nevztahuje na EventTrigger třídu. (Zděděno od TriggerBase) |
| ExitActions |
Získá kolekci TriggerAction objektů, které se použijí, když se objekt triggeru stane neaktivní. Tato vlastnost se nevztahuje na EventTrigger třídu. (Zděděno od TriggerBase) |
| IsSealed |
Získá hodnotu, která označuje, zda je tato instance aktuálně zapečetěna (jen pro čtení). (Zděděno od DependencyObject) |
| Property |
Získá nebo nastaví vlastnost, která vrací hodnotu, která je porovnána s Value vlastností triggeru. Porovnání je kontrola rovnosti odkazů. |
| Setters |
Získá kolekci Setter objektů, které popisují hodnoty vlastností, které se mají použít při splnění zadané podmínky. |
| SourceName |
Získá nebo nastaví název objektu s vlastností, která způsobí použití přidružených setter. |
| Value |
Získá nebo nastaví hodnotu, která má být porovnána s hodnotou vlastnosti prvku. Porovnání je kontrola rovnosti odkazů. |
Metody
| Name | Description |
|---|---|
| CheckAccess() |
Určuje, zda volající vlákno má přístup k tomuto DispatcherObject. (Zděděno od DispatcherObject) |
| ClearValue(DependencyProperty) |
Vymaže místní hodnotu vlastnosti. Vlastnost, která se má vymazat, je určena identifikátorem DependencyProperty . (Zděděno od DependencyObject) |
| ClearValue(DependencyPropertyKey) |
Vymaže místní hodnotu vlastnosti jen pro čtení. Vlastnost, která má být vymazána, je určena parametrem DependencyPropertyKey. (Zděděno od DependencyObject) |
| CoerceValue(DependencyProperty) |
Převede hodnotu zadané vlastnosti závislosti. Toho se dosahuje vyvoláním jakékoli CoerceValueCallback funkce zadané v metadatech vlastností pro vlastnost závislosti, protože existuje ve volání DependencyObject. (Zděděno od DependencyObject) |
| Equals(Object) |
Určuje, zda je poskytnutá DependencyObject hodnota ekvivalentní aktuálnímu DependencyObject. (Zděděno od DependencyObject) |
| GetHashCode() |
Získá hash kód pro tento DependencyObject. (Zděděno od DependencyObject) |
| GetLocalValueEnumerator() |
Vytvoří specializovaný enumerátor pro určení, které vlastnosti závislosti mají místně nastavené hodnoty na tomto DependencyObject. (Zděděno od DependencyObject) |
| GetType() |
Získá Type aktuální instance. (Zděděno od Object) |
| GetValue(DependencyProperty) |
Vrátí aktuální efektivní hodnotu vlastnosti závislosti na této instanci objektu DependencyObject. (Zděděno od DependencyObject) |
| InvalidateProperty(DependencyProperty) |
Znovu vyhodnotí efektivní hodnotu pro zadanou vlastnost závislosti. (Zděděno od DependencyObject) |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object) |
| OnPropertyChanged(DependencyPropertyChangedEventArgs) |
Vyvolána vždy, když byla aktualizována efektivní hodnota jakékoli vlastnosti závislosti na této DependencyObject vlastnosti. Konkrétní vlastnost závislosti, která se změnila, je hlášena v datech události. (Zděděno od DependencyObject) |
| ReadLocalValue(DependencyProperty) |
Vrátí místní hodnotu vlastnosti závislosti, pokud existuje. (Zděděno od DependencyObject) |
| ReceiveTypeConverter(Object, XamlSetTypeConverterEventArgs) |
Zpracovává případy, kdy převaděč typů poskytuje hodnotu vlastnosti objektu Trigger . |
| SetCurrentValue(DependencyProperty, Object) |
Nastaví hodnotu vlastnosti závislosti beze změny jejího zdroje hodnot. (Zděděno od DependencyObject) |
| SetValue(DependencyProperty, Object) |
Nastaví místní hodnotu vlastnosti závislosti určenou jeho identifikátorem vlastnosti závislosti. (Zděděno od DependencyObject) |
| SetValue(DependencyPropertyKey, Object) |
Nastaví místní hodnotu vlastnosti závislosti jen pro čtení určenou identifikátorem DependencyPropertyKey vlastnosti závislosti. (Zděděno od DependencyObject) |
| ShouldSerializeProperty(DependencyProperty) |
Vrátí hodnotu, která určuje, zda procesy serializace mají serializovat hodnotu pro zadanou vlastnost závislosti. (Zděděno od DependencyObject) |
| ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |
| VerifyAccess() |
Vynucuje, že volající vlákno má přístup k tomuto DispatcherObject. (Zděděno od DispatcherObject) |
Explicitní implementace rozhraní
| Name | Description |
|---|---|
| IAddChild.AddChild(Object) |
Přidá podřízený objekt. |
| IAddChild.AddText(String) |
Přidá do objektu textový obsah uzlu. |
| ISupportInitialize.BeginInit() |
Signalizuje objekt, který inicializace spouští. |
| ISupportInitialize.EndInit() |
Signalizuje objekt, který inicializace je dokončena. |