DataTrigger 类

定义

命名空间:: System.Windows

程序集:: PresentationFramework.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

表示在绑定数据满足指定条件时应用属性值或执行操作的触发器。

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

继承: Object

DispatcherObject

DependencyObject

TriggerBase
DataTrigger

属性: ContentPropertyAttribute XamlSetMarkupExtensionAttribute

实现: IAddChild

示例

在以下示例中，该ItemsSource ListBox位置绑定到 Place 对象的位置ObservableCollection<T>。放置对象具有属性 Name 和 State。

每个对象都显示一个 Place 对象。ListBoxItem ListBox 示例中 Style 将应用于每个 ListBoxItem。

指定DataTrigger此项时，如果“位置”数据项的状态为“WA”，则相应ListBoxItem项的前景设置为红色。

<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>

以下示例演示如何在绑定数据满足指定条件时使用 DataTrigger、 BeginStoryboard 操作和 Storyboard 动画处理属性。该示例在控件中 ListBox 显示清单信息。它使用一个 DataTrigger 动画 Opacity 处理每一个包含缺货书籍的 ListBoxItem 动画。

<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>

注解

Style、 ControlTemplate和 DataTemplate 所有都有一个触发器集合。允许 DataTrigger 在数据对象的属性值与指定的 Value属性值匹配时设置属性值。例如，如果要显示对象列表 Employee ，则可能希望前景颜色根据每个 Employee's 当前出席情况而有所不同。（例如， Employees 当前正在度假的人显示有紫色前景。在某些情况下，创建转换器或使用 DataTemplateSelector转换器可能更合适。有关详细信息，请参阅数据模板化概述。

请注意，必须为数据触发器指定 Binding 属性和 Value 属性 DataTrigger 才能有意义。如果未指定一个或两个属性，则会引发异常。

对象的 Setters 属性 DataTrigger 只能包含 Setter 对象。向 Setter 对象添加子级 DataTrigger 会隐式将其添加到 SetterBaseCollection 该 DataTrigger 对象的子级。 EventSetter 不支持对象;仅 Style.Setters 支持 EventSetter 对象。

构造函数

名称	说明
DataTrigger()	初始化 DataTrigger 类的新实例。

属性

名称	说明
Binding	获取或设置生成数据对象的属性值的绑定。
DependencyObjectType	获取包装 DependencyObjectType 此实例的 CLR 类型。 (继承自 DependencyObject)
Dispatcher	获取与此Dispatcher DispatcherObject关联的值。 (继承自 DispatcherObject)
EnterActions	获取在触发器对象处于活动状态时要应用的对象集合 TriggerAction 。此属性不适用于类 EventTrigger 。 (继承自 TriggerBase)
ExitActions	获取在触发器对象变为非活动状态时要应用的对象集合 TriggerAction 。此属性不适用于类 EventTrigger 。 (继承自 TriggerBase)
IsSealed	获取一个值，该值指示此实例当前是否密封（只读）。 (继承自 DependencyObject)
Setters	获取对象的集合，该集合 Setter 描述数据项满足指定条件时要应用的属性值。
Value	获取或设置要与数据对象的属性值进行比较的值。

方法

名称	说明
CheckAccess()	确定调用线程是否有权访问此 DispatcherObject权限。 (继承自 DispatcherObject)
ClearValue(DependencyProperty)	清除属性的本地值。要清除的属性由 DependencyProperty 标识符指定。 (继承自 DependencyObject)
ClearValue(DependencyPropertyKey)	清除只读属性的本地值。要清除的属性由一个 DependencyPropertyKey. (继承自 DependencyObject)
CoerceValue(DependencyProperty)	强制指定依赖属性的值。这是通过调用中调用依赖属性CoerceValueCallback的属性元数据中指定的任何DependencyObject函数来实现的。 (继承自 DependencyObject)
Equals(Object)	确定提供的 DependencyObject 是否等效于当前 DependencyObject。 (继承自 DependencyObject)
GetHashCode()	获取此 DependencyObject代码的哈希代码。 (继承自 DependencyObject)
GetLocalValueEnumerator()	创建一个专用枚举器，用于确定哪些依赖项属性具有本地 DependencyObject设置的值。 (继承自 DependencyObject)
GetType()	获取当前实例的 Type。 (继承自 Object)
GetValue(DependencyProperty)	返回此实例 DependencyObject上的依赖属性的当前有效值。 (继承自 DependencyObject)
InvalidateProperty(DependencyProperty)	重新评估指定依赖属性的有效值。 (继承自 DependencyObject)
MemberwiseClone()	创建当前 Object的浅表副本。 (继承自 Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	每当更新此 DependencyObject 属性上任何依赖属性的有效值时调用。在事件数据中报告更改的特定依赖属性。 (继承自 DependencyObject)
ReadLocalValue(DependencyProperty)	返回依赖属性的本地值（如果存在）。 (继承自 DependencyObject)
ReceiveMarkupExtension(Object, XamlSetMarkupExtensionEventArgs)	处理标记扩展为对象的属性 DataTrigger 提供值的情况。
SetCurrentValue(DependencyProperty, Object)	设置依赖项属性的值，而不更改其值源。 (继承自 DependencyObject)
SetValue(DependencyProperty, Object)	设置依赖属性的本地值，由依赖属性标识符指定。 (继承自 DependencyObject)
SetValue(DependencyPropertyKey, Object)	设置只读依赖属性的本地值，由 DependencyPropertyKey 依赖属性的标识符指定。 (继承自 DependencyObject)
ShouldSerializeProperty(DependencyProperty)	返回一个值，该值指示序列化进程是否应序列化所提供的依赖属性的值。 (继承自 DependencyObject)
ToString()	返回一个表示当前对象的字符串。 (继承自 Object)
VerifyAccess()	强制调用线程有权访问此 DispatcherObject权限。 (继承自 DispatcherObject)

显式接口实现

名称	说明
IAddChild.AddChild(Object)	添加子对象。
IAddChild.AddText(String)	将节点的文本内容添加到对象。

适用于

另请参阅

反馈

此页面是否有帮助？

通过

DataTrigger 类

定义

示例

注解

构造函数

属性

方法

显式接口实现

适用于

另请参阅

反馈