DataTrigger Classe

Definizione

Spazio dei nomi:: System.Windows

Assembly:: PresentationFramework.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Rappresenta un trigger che applica i valori delle proprietà o esegue azioni quando i dati associati soddisfano una condizione specificata.

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

Ereditarietà: Object

DispatcherObject

DependencyObject

TriggerBase
DataTrigger

Attributi: ContentPropertyAttribute XamlSetMarkupExtensionAttribute

Implementazioni: IAddChild

Esempio

Nell'esempio seguente, l'oggetto ItemsSource di ListBox è associato a Places, un ObservableCollection<T> di oggetti Place . Gli oggetti Place hanno proprietà Name e State.

Ognuno ListBoxItem di ListBox essi visualizza un oggetto Place . Nell'esempio Style viene applicato a ogni ListBoxItemoggetto .

Viene DataTrigger specificato in modo che se l'elemento dati State of the Place è "WA", il primo piano del corrispondente ListBoxItem viene impostato su Rosso.

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

Nell'esempio seguente viene illustrato come usare un'azione DataTrigger, BeginStoryboard un'azione e un Storyboard oggetto per animare una proprietà quando i dati associati soddisfano una condizione specificata. Nell'esempio vengono visualizzate le informazioni di inventario in un ListBox controllo . Usa un DataTrigger oggetto per animare l'oggetto Opacity di ogni ListBoxItem che contiene un libro esaurito.

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

Commenti

Style, ControlTemplatee DataTemplate tutti dispongono di una raccolta di trigger. Un DataTrigger oggetto consente di impostare i valori delle proprietà quando il valore della proprietà dell'oggetto dati corrisponde a un oggetto specificato Value. Ad esempio, se si visualizza un elenco di oggetti, è possibile che il colore di Employee primo piano sia diverso in base a ogni Employee's presenza corrente. Ad esempio, Employees chi è attualmente in vacanza viene visualizzato con un primo piano viola. In alcuni scenari può essere più adatto per creare un convertitore o per usare un oggetto DataTemplateSelector. Per altre informazioni, vedere Panoramica dei modelli di dati.

Si noti che è necessario specificare sia le Binding proprietà e Value in un DataTrigger per il trigger di dati sia significativo. Se una o entrambe le proprietà non vengono specificate, viene generata un'eccezione.

La Setters proprietà di un DataTrigger oggetto può essere costituita solo da Setter oggetti . L'aggiunta di un Setter elemento figlio a un DataTrigger oggetto lo aggiunge in modo implicito all'oggetto SetterBaseCollection per l'oggetto DataTrigger . EventSettergli oggetti non sono supportati; supporta EventSetter solo Style.Setters oggetti.

Costruttori

Nome	Descrizione
DataTrigger()	Inizializza una nuova istanza della classe DataTrigger.

Proprietà

Nome	Descrizione
Binding	Ottiene o imposta l'associazione che produce il valore della proprietà dell'oggetto dati.
DependencyObjectType	Ottiene l'oggetto DependencyObjectType che esegue il wrapping del tipo CLR di questa istanza. (Ereditato da DependencyObject)
Dispatcher	Ottiene l'oggetto Dispatcher DispatcherObject a cui è associato. (Ereditato da DispatcherObject)
EnterActions	Ottiene una raccolta di TriggerAction oggetti da applicare quando l'oggetto trigger diventa attivo. Questa proprietà non si applica alla EventTrigger classe . (Ereditato da TriggerBase)
ExitActions	Ottiene una raccolta di TriggerAction oggetti da applicare quando l'oggetto trigger diventa inattivo. Questa proprietà non si applica alla EventTrigger classe . (Ereditato da TriggerBase)
IsSealed	Ottiene un valore che indica se questa istanza è attualmente sealed (sola lettura). (Ereditato da DependencyObject)
Setters	Ottiene una raccolta di oggetti che descrivono i valori delle Setter proprietà da applicare quando l'elemento dati soddisfa la condizione specificata.
Value	Ottiene o imposta il valore da confrontare con il valore della proprietà dell'oggetto dati.

Metodi

Nome	Descrizione
CheckAccess()	Determina se il thread chiamante ha accesso a questo DispatcherObjectoggetto . (Ereditato da DispatcherObject)
ClearValue(DependencyProperty)	Cancella il valore locale di una proprietà. La proprietà da cancellare viene specificata da un DependencyProperty identificatore. (Ereditato da DependencyObject)
ClearValue(DependencyPropertyKey)	Cancella il valore locale di una proprietà di sola lettura. La proprietà da cancellare viene specificata da un oggetto DependencyPropertyKey. (Ereditato da DependencyObject)
CoerceValue(DependencyProperty)	Forza il valore della proprietà di dipendenza specificata. A tale scopo, richiamare qualsiasi CoerceValueCallback funzione specificata nei metadati della proprietà per la proprietà di dipendenza così come esiste nella chiamata DependencyObjectdi . (Ereditato da DependencyObject)
Equals(Object)	Determina se un oggetto specificato DependencyObject è equivalente all'oggetto corrente DependencyObject. (Ereditato da DependencyObject)
GetHashCode()	Ottiene un codice hash per l'oggetto DependencyObject. (Ereditato da DependencyObject)
GetLocalValueEnumerator()	Crea un enumeratore specializzato per determinare quali proprietà di dipendenza hanno valori impostati localmente in questo DependencyObjectoggetto . (Ereditato da DependencyObject)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
GetValue(DependencyProperty)	Restituisce il valore effettivo corrente di una proprietà di dipendenza in questa istanza di un oggetto DependencyObject. (Ereditato da DependencyObject)
InvalidateProperty(DependencyProperty)	Rivaluta il valore effettivo per la proprietà di dipendenza specificata. (Ereditato da DependencyObject)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Richiamato ogni volta che il valore effettivo di qualsiasi proprietà di dipendenza in questo DependencyObject oggetto è stato aggiornato. La proprietà di dipendenza specifica modificata viene segnalata nei dati dell'evento. (Ereditato da DependencyObject)
ReadLocalValue(DependencyProperty)	Restituisce il valore locale di una proprietà di dipendenza, se esistente. (Ereditato da DependencyObject)
ReceiveMarkupExtension(Object, XamlSetMarkupExtensionEventArgs)	Gestisce i casi in cui un'estensione di markup fornisce un valore per una proprietà di un DataTrigger oggetto .
SetCurrentValue(DependencyProperty, Object)	Imposta il valore di una proprietà di dipendenza senza modificarne l'origine del valore. (Ereditato da DependencyObject)
SetValue(DependencyProperty, Object)	Imposta il valore locale di una proprietà di dipendenza, specificato dall'identificatore della proprietà di dipendenza. (Ereditato da DependencyObject)
SetValue(DependencyPropertyKey, Object)	Imposta il valore locale di una proprietà di dipendenza di sola lettura, specificato dall'identificatore DependencyPropertyKey della proprietà di dipendenza. (Ereditato da DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Restituisce un valore che indica se i processi di serializzazione devono serializzare il valore per la proprietà di dipendenza specificata. (Ereditato da DependencyObject)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
VerifyAccess()	Impone che il thread chiamante abbia accesso a questo DispatcherObjectoggetto . (Ereditato da DispatcherObject)

Implementazioni dell'interfaccia esplicita

Nome	Descrizione
IAddChild.AddChild(Object)	Aggiunge un oggetto figlio.
IAddChild.AddText(String)	Aggiunge il contenuto di testo di un nodo all'oggetto .

Si applica a

Vedi anche

Commenti e suggerimenti

Questa pagina è stata utile?