DataTrigger Osztály

Definíció

Névtér:: System.Windows

Szerelvény:: PresentationFramework.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Olyan eseményindítót jelöl, amely tulajdonságértékeket alkalmaz, vagy műveleteket hajt végre, ha a kötött adatok megfelelnek egy megadott feltételnek.

public ref class DataTrigger : System::Windows::TriggerBase, System::Windows::Markup::IAddChild

[System.Windows.Markup.ContentProperty("Setters")]
public class DataTrigger : System.Windows.TriggerBase, System.Windows.Markup.IAddChild

[System.Windows.Markup.ContentProperty("Setters")]
[System.Windows.Markup.XamlSetMarkupExtension("ReceiveMarkupExtension")]
public class DataTrigger : System.Windows.TriggerBase, System.Windows.Markup.IAddChild

[<System.Windows.Markup.ContentProperty("Setters")>]
type DataTrigger = class
    inherit TriggerBase
    interface IAddChild

[<System.Windows.Markup.ContentProperty("Setters")>]
[<System.Windows.Markup.XamlSetMarkupExtension("ReceiveMarkupExtension")>]
type DataTrigger = class
    inherit TriggerBase
    interface IAddChild

Public Class DataTrigger
Inherits TriggerBase
Implements IAddChild

Öröklődés: Object

DispatcherObject

DependencyObject

TriggerBase
DataTrigger

Attribútumok: ContentPropertyAttribute XamlSetMarkupExtensionAttribute

Megvalósítás: IAddChild

Példák

Az alábbi példában az ItemsSource érték ListBox a Helyekhez van kötve, egy ObservableCollection<T>Hely objektumhoz. A helyobjektumokneve és állapota tulajdonsággal rendelkezik.

Mindegyik ListBoxItem egy ListBox objektumot jelenít meg. A Style példában szereplő értékek mindegyikre ListBoxItemérvényesek.

A DataTrigger beállítás úgy van megadva, hogy ha a Hely adatelem állapota "WA", akkor a megfelelő ListBoxItem előtér pirosra van állítva.

<Window.Resources>
  <c:Places x:Key="PlacesData"/>

  <Style TargetType="ListBoxItem">
    <Style.Triggers>
      <DataTrigger Binding="{Binding Path=State}" Value="WA">
        <Setter Property="Foreground" Value="Red" />
      </DataTrigger>	
      <MultiDataTrigger>
        <MultiDataTrigger.Conditions>
          <Condition Binding="{Binding Path=Name}" Value="Portland" />
          <Condition Binding="{Binding Path=State}" Value="OR" />
        </MultiDataTrigger.Conditions>
        <Setter Property="Background" Value="Cyan" />
      </MultiDataTrigger>
    </Style.Triggers>
  </Style>

  <DataTemplate DataType="{x:Type c:Place}">
    <Canvas Width="160" Height="20">
      <TextBlock FontSize="12"
             Width="130" Canvas.Left="0" Text="{Binding Path=Name}"/>
      <TextBlock FontSize="12" Width="30"
                 Canvas.Left="130" Text="{Binding Path=State}"/>
    </Canvas>
  </DataTemplate>
</Window.Resources>

<StackPanel>
  <TextBlock FontSize="18" Margin="5" FontWeight="Bold"
    HorizontalAlignment="Center">Data Trigger Sample</TextBlock>
  <ListBox Width="180" HorizontalAlignment="Center" Background="Honeydew"
    ItemsSource="{Binding Source={StaticResource PlacesData}}"/>
</StackPanel>

Az alábbi példa bemutatja, hogyan használható egy DataTrigger, egy BeginStoryboard művelet és egy Storyboard tulajdonság animálása, ha a kötött adatok megfelelnek egy adott feltételnek. A példa egy vezérlő készletadatait ListBox jeleníti meg. A készleten kívüli könyveket tartalmazó összes DataTrigger könyv animálásához használ Opacity egy animálástListBoxItem.

<Page 
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  Title="DataTriggerStoryboardExample">

  <Page.Resources>
    <XmlDataProvider x:Key="InventoryData" XPath="Inventory/Books">
      <x:XData>
        <Inventory xmlns="">
          <Books>
            <Book ISBN="0-7356-0562-9" Stock="in" Number="9">
              <Title>XML in Action</Title>
              <Summary>XML Web Technology</Summary>
            </Book>
            <Book ISBN="0-7356-1370-2" Stock="in" Number="8">
              <Title>Programming Microsoft Windows With C#</Title>
              <Summary>C# Programming using the .NET Framework</Summary>
            </Book>
            <Book ISBN="0-7356-1288-9" Stock="out" Number="7">
              <Title>Inside C#</Title>
              <Summary>C# Language Programming</Summary>
            </Book>
            <Book ISBN="0-7356-1377-X" Stock="in" Number="5">
              <Title>Introducing Microsoft .NET</Title>
              <Summary>Overview of .NET Technology</Summary>
            </Book>
            <Book ISBN="0-7356-1448-2" Stock="out" Number="4">
              <Title>Microsoft C# Language Specifications</Title>
              <Summary>The C# language definition</Summary>
            </Book>
          </Books>
          <CDs>
            <CD Stock="in" Number="3">
              <Title>Classical Collection</Title>
              <Summary>Classical Music</Summary>
            </CD>
            <CD Stock="out" Number="9">
              <Title>Jazz Collection</Title>
              <Summary>Jazz Music</Summary>
            </CD>
          </CDs>
        </Inventory>
      </x:XData>
    </XmlDataProvider>

    <Style x:Key="AnimatedListBoxItemStyle" TargetType="{x:Type ListBoxItem}">

      <Setter Property="Margin" Value="0,2,0,2" />
      <Setter Property="Padding" Value="0,2,0,2" />

      <Style.Triggers>
        <DataTrigger 
         Binding="{Binding XPath=@Stock}" 
         Value="out">
          <DataTrigger.EnterActions>
            <BeginStoryboard>
              <Storyboard>
                <DoubleAnimation
                 Storyboard.TargetProperty="Opacity"
                 From="0.25" To="0.5" Duration="0:0:1" 
                 RepeatBehavior="Forever"
                 AutoReverse="True"/>
              </Storyboard>
            </BeginStoryboard>
          </DataTrigger.EnterActions>
          <DataTrigger.ExitActions>
            <BeginStoryboard> 
              <Storyboard FillBehavior="Stop">
                <DoubleAnimation
                  Storyboard.TargetProperty="Opacity"
                  To="1" Duration="0:0:1" />
              </Storyboard>
            </BeginStoryboard>  
          </DataTrigger.ExitActions>
          
        </DataTrigger>
      </Style.Triggers>
    </Style>
  </Page.Resources>

  <StackPanel>
    <ListBox HorizontalAlignment="Center"
      ItemContainerStyle="{StaticResource AnimatedListBoxItemStyle}"
      Padding="2">
      <ListBox.ItemsSource>
        <Binding Source="{StaticResource InventoryData}"
                 XPath="*"/>
      </ListBox.ItemsSource>

      <ListBox.ItemTemplate>
        <DataTemplate>
          <TextBlock FontSize="12" Margin="0,0,10,0">
            <TextBlock.Text>
              <Binding XPath="Title"/>
            </TextBlock.Text>
          </TextBlock>
        </DataTemplate>
      </ListBox.ItemTemplate>
    </ListBox>
  </StackPanel>
</Page>

Megjegyzések

Style, ControlTemplateés DataTemplate mindegyik rendelkezik eseményindító-gyűjteménysel. Az A DataTrigger lehetővé teszi a tulajdonságértékek beállítását, ha az adatobjektum tulajdonságértéke megegyezik egy megadott Valueértékkel. Ha például egy objektumlistát Employee jelenít meg, előfordulhat, hogy az előtér színe az aktuális Employee's jelenléti állapottól függően eltérő lesz. (Például azok, akik jelenleg szabadságon vannak, Employees lila előtérrel jelennek meg.) Bizonyos esetekben célszerűbb konvertert létrehozni vagy használni DataTemplateSelector. További információ: Data Templating Overview.

Vegye figyelembe, hogy meg kell adnia az Binding adatindító tulajdonságait és Value tulajdonságait DataTrigger is ahhoz, hogy az eseményindító értelmezhető legyen. Ha egyik vagy mindkét tulajdonság nincs megadva, a rendszer kivételt jelez.

Egy Setters objektum tulajdonsága DataTrigger csak objektumokból állhat Setter . Setter Gyermek hozzáadása egy DataTrigger objektumhoz implicit módon hozzáadja azt az SetterBaseCollection DataTrigger objektumhoz. EventSetter az objektumok nem támogatottak; csak Style.Setters az objektumokat támogatja EventSetter .

Konstruktorok

Name	Description
DataTrigger()	Inicializálja a DataTrigger osztály új példányát.

Tulajdonságok

Name	Description
Binding	Lekéri vagy beállítja az adatobjektum tulajdonságértékét előállító kötést.
DependencyObjectType	Lekéri a DependencyObjectType példány CLR-típusát körbefuttatót. (Öröklődés forrása DependencyObject)
Dispatcher	Lekérdezi, Dispatcher hogy ez a társítva van-e DispatcherObject . (Öröklődés forrása DispatcherObject)
EnterActions	Lekéri azokat az TriggerAction objektumgyűjteményeket, amelyeket az eseményindító objektum aktívvá válásakor alkalmazni kell. Ez a tulajdonság nem vonatkozik az EventTrigger osztályra. (Öröklődés forrása TriggerBase)
ExitActions	Lekéri azokat az TriggerAction objektumgyűjteményeket, amelyeket akkor kell alkalmazni, amikor az eseményindító objektum inaktívvá válik. Ez a tulajdonság nem vonatkozik az EventTrigger osztályra. (Öröklődés forrása TriggerBase)
IsSealed	Olyan értéket kap, amely jelzi, hogy a példány jelenleg zárolva van-e (írásvédett). (Öröklődés forrása DependencyObject)
Setters	Lekéri az objektumok gyűjteményét Setter , amely leírja azokat a tulajdonságértékeket, amelyeket akkor kell alkalmazni, amikor az adatelem megfelel a megadott feltételnek.
Value	Lekéri vagy beállítja az adatobjektum tulajdonságértékével összehasonlítandó értéket.

Metódusok

Name	Description
CheckAccess()	Meghatározza, hogy a hívó szál hozzáfér-e ehhez DispatcherObject. (Öröklődés forrása DispatcherObject)
ClearValue(DependencyProperty)	Törli egy tulajdonság helyi értékét. A törölni kívánt tulajdonságot egy DependencyProperty azonosító határozza meg. (Öröklődés forrása DependencyObject)
ClearValue(DependencyPropertyKey)	Törli egy írásvédett tulajdonság helyi értékét. A törölni kívánt tulajdonságot egy DependencyPropertyKey. (Öröklődés forrása DependencyObject)
CoerceValue(DependencyProperty)	A megadott függőségi tulajdonság értékét kényszeríti. Ez úgy érhető el, hogy meghívja a függőségi tulajdonság tulajdonság metaadataiban megadott függvényeket CoerceValueCallback a hívás DependencyObjectsorán. (Öröklődés forrása DependencyObject)
Equals(Object)	Meghatározza, hogy a megadott DependencyObject érték megegyezik-e az aktuális DependencyObjectértékével. (Öröklődés forrása DependencyObject)
GetHashCode()	Ehhez lekéri a DependencyObjectkivonatkódot. (Öröklődés forrása DependencyObject)
GetLocalValueEnumerator()	Létrehoz egy speciális enumerátort annak meghatározásához, hogy mely függőségi tulajdonságok rendelkeznek helyileg beállított értékekkel.DependencyObject (Öröklődés forrása DependencyObject)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
GetValue(DependencyProperty)	Egy függőségi tulajdonság aktuális tényleges értékét adja vissza az adott példányon DependencyObject. (Öröklődés forrása DependencyObject)
InvalidateProperty(DependencyProperty)	Újra kiértékeli a megadott függőségi tulajdonság tényleges értékét. (Öröklődés forrása DependencyObject)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Akkor hívjuk meg, ha az adott DependencyObject függőségi tulajdonság tényleges értéke frissült. A módosított függőségi tulajdonságot az eseményadatok jelentik. (Öröklődés forrása DependencyObject)
ReadLocalValue(DependencyProperty)	Egy függőségi tulajdonság helyi értékét adja vissza, ha létezik. (Öröklődés forrása DependencyObject)
ReceiveMarkupExtension(Object, XamlSetMarkupExtensionEventArgs)	Azokat az eseteket kezeli, amikor egy korrektúrakiterjesztés egy objektum tulajdonságának DataTrigger értékét adja meg.
SetCurrentValue(DependencyProperty, Object)	Beállítja egy függőségi tulajdonság értékét az értékforrás módosítása nélkül. (Öröklődés forrása DependencyObject)
SetValue(DependencyProperty, Object)	Beállítja egy függőségi tulajdonság helyi értékét, amelyet a függőségi tulajdonság azonosítója határoz meg. (Öröklődés forrása DependencyObject)
SetValue(DependencyPropertyKey, Object)	Beállítja egy írásvédett függőség tulajdonság helyi értékét, amelyet a DependencyPropertyKey függőségi tulajdonság azonosítója határoz meg. (Öröklődés forrása DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Olyan értéket ad vissza, amely jelzi, hogy a szerializálási folyamatok szerializálják-e a megadott függőségi tulajdonság értékét. (Öröklődés forrása DependencyObject)
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)
VerifyAccess()	Kényszeríti, hogy a hívószál hozzáférhessen ehhez.DispatcherObject (Öröklődés forrása DispatcherObject)

Explicit interfész-implementációk

Name	Description
IAddChild.AddChild(Object)	Gyermekobjektumot ad hozzá.
IAddChild.AddText(String)	Hozzáadja egy csomópont szöveges tartalmát az objektumhoz.

A következőre érvényes:

Lásd még

Visszajelzés

Hasznosnak találta ezt az oldalt?