DataTrigger.Setters Eigenschaft

Definition

Ruft eine Auflistung von Setter-Objekten ab, die die Eigenschaftswerte beschreiben, die angewendet werden sollen, wenn das Datenelement die angegebene Bedingung erfüllt.Gets a collection of Setter objects, which describe the property values to apply when the data item meets the specified condition.

public:
 property System::Windows::SetterBaseCollection ^ Setters { System::Windows::SetterBaseCollection ^ get(); };
public System.Windows.SetterBaseCollection Setters { get; }
member this.Setters : System.Windows.SetterBaseCollection
Public ReadOnly Property Setters As SetterBaseCollection

Eigenschaftswert

Der Standardwert ist nullsein.The default value is null.

Beispiele

Im folgenden Beispiel werden zwei DataTrigger -Objekte gezeigt, die in DataTemplateeiner definiert sind.The following example shows two DataTrigger objects that are defined in a DataTemplate. Der DataTemplate wird auf die Datenobjekte des Auktions Elements angewendet (in diesem Beispiel nicht gezeigt), die über die Eigenschaft SpecialFeaturesverfügen.The DataTemplate is applied to AuctionItem data objects (not shown in this example), which have the property SpecialFeatures.

Der erste DataTrigger Wert wird so festgelegt, dass das Element, wenn das Datenobjekt den ** SpecialFeatures -Wert aufweist, mit einem DodgerBlue Hintergrund mit "Marine"-Titeln angezeigt wird.The first DataTrigger is specified such that if the data object has a SpecialFeatures value of Color, then the item is displayed with a DodgerBlue background with Navy titles. Wenn das Datenobjekt den SpecialFeatures -Wert hervorhebenhat, ist das DataTrigger zweite aktiv und bewirkt, dass das Element mit einem orangefarbenen Rahmen mit einem Stern angezeigt wird.If the data object has a SpecialFeatures value of Highlight, then the second DataTrigger will be active, causing the item to be displayed with an Orange border with a star.

Das komplette Beispiel finden Sie unter Demo zur Datenbindung.For the complete sample, see Data Binding Demo.

<DataTemplate.Triggers>
    <DataTrigger Binding="{Binding Path=SpecialFeatures}">
        <DataTrigger.Value>
            <src:SpecialFeatures>Color</src:SpecialFeatures>
        </DataTrigger.Value>
      <DataTrigger.Setters>
        <Setter Property="BorderBrush" Value="DodgerBlue" TargetName="border" />
        <Setter Property="Foreground" Value="Navy" TargetName="descriptionTitle" />
        <Setter Property="Foreground" Value="Navy" TargetName="currentPriceTitle" />
        <Setter Property="BorderThickness" Value="3" TargetName="border" />
        <Setter Property="Padding" Value="5" TargetName="border" />
      </DataTrigger.Setters>
    </DataTrigger>
    <DataTrigger Binding="{Binding Path=SpecialFeatures}">
        <DataTrigger.Value>
            <src:SpecialFeatures>Highlight</src:SpecialFeatures>
        </DataTrigger.Value>
        <Setter Property="BorderBrush" Value="Orange" TargetName="border" />
        <Setter Property="Foreground" Value="Navy" TargetName="descriptionTitle" />
        <Setter Property="Foreground" Value="Navy" TargetName="currentPriceTitle" />
        <Setter Property="Visibility" Value="Visible" TargetName="star" />
        <Setter Property="BorderThickness" Value="3" TargetName="border" />
        <Setter Property="Padding" Value="5" TargetName="border" />
    </DataTrigger>
</DataTemplate.Triggers>

Hinweise

Verwendung von XAML-EigenschaftenelementenXAML Property Element Usage

<object>  
  <object.Setters>  
    ZeroOrMoreSetters  
  </object.Setters>  
</object>  

XAML-WerteXAML Values

ZeroOrMoreSettersZeroOrMoreSetters
NULL oder mehr Setter -Objekte.Zero or more Setter objects.

Ein DataTrigger ermöglicht Ihnen das Starten von Aktionen oder Setterdas Anwenden von Eigenschafts Werten mithilfe von, wenn das Datenelement eine bestimmte Bedingung erfüllt.A DataTrigger allows you to start actions or to use Setters to apply property values when the data item meets a specified condition.

Wenn mehr als ein Setter die gleiche Eigenschaft in derselben Setter-Auflistung festlegt, wird der als letzter deklarierte Setter verwendet.If there is more than one setter setting the same property in the same setter collection, the setter that is declared last is used.

Die Setters -Eigenschaft DataTrigger eines- Setter Objekts kann nur aus-Objekten bestehen.The Setters property of a DataTrigger object can only consist of Setter objects. Wenn Sie Setter einem- DataTrigger Objekt ein untergeordnetes Element hinzufügen SetterBaseCollection , wird DataTrigger dieses implizit dem für das-Objekt hinzugefügtAdding a Setter child to a DataTrigger object implicitly adds it to the SetterBaseCollection for the DataTrigger object. EventSetterObjekte werden nicht unterstützt. unter Style.Setters stütztEventSetter nur-Objekte.EventSetter objects are not supported; only Style.Setters supports EventSetter objects.

Gilt für:

Siehe auch