DataTrigger.Value Propriedade

Definição

Espaço de Nomes:
System.Windows
Assemblagem:
PresentationFramework.dll

Obtém ou define o valor a ser comparado com o valor da propriedade do objeto de dados.

public:
 property System::Object ^ Value { System::Object ^ get(); void set(System::Object ^ value); };
[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
[System.Windows.Markup.DependsOn("Binding")]
public object Value { get; set; }
[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
[<System.Windows.Markup.DependsOn("Binding")>]
member this.Value : obj with get, set
Public Property Value As Object

Valor de Propriedade

Object

O valor predefinido é null. Ver também a secção de Exceções.

Atributos
LocalizabilityAttribute DependsOnAttribute

Exceções

ArgumentException

Expressões não são suportadas. Fixações não são suportadas.

Exemplos

No exemplo seguinte, o ItemsSource de está ListBox ligado a Places, um ObservableCollection<T> de Place objetos. Place os objetos têm propriedades Name e State.

Cada ListBoxItemListBox um exibe um Place objeto. O Style no exemplo é aplicado a cada ListBoxItem.

É DataTrigger especificado de modo que, se o State do Place elemento de dados for "WA", então o primeiro plano do elemento correspondente ListBoxItem é definido para Vermelho.

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

O exemplo seguinte mostra dois DataTriggers definidos em um DataTemplate. O DataTemplate é aplicado a AuctionItem objetos de dados (não mostrados neste exemplo), que têm a propriedade SpecialFeatures.

O primeiro DataTrigger é especificado de modo que, se o objeto de dados tiver um SpecialFeatures valor de Color, então o item é exibido com um fundo DodgerBlue com títulos da Marinha. Se o objeto de dados tiver um SpecialFeatures valor de Highlight, então o segundo DataTrigger estará ativo, fazendo com que o item seja exibido com uma borda laranja com uma estrela.

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

Observações

Uso do elemento de propriedade XAML

<object>
  <object.Value>
    Value
  </object.Value>
</object>

Este valor é comparado com o valor da propriedade produzido pela Binding propriedade da DataTrigger. A comparação é uma verificação de igualdade de referências. Se os dois valores forem iguais, então aplicam-se as ações ou setters associados.

Note

Deve especificar ambas as Binding propriedades e Value em um DataTrigger para que o gatilho de dados seja significativo. Se uma ou ambas as propriedades não estiverem definidas, é lançada uma exceção.

Aplica-se a

Ver também