DataTrigger.Value Propriedade

Referência

Definição

Namespace:: System.Windows

Assembly:: PresentationFramework.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

Object

O valor padrão é null. Consulte também a seção Exceções.

Atributos: LocalizabilityAttribute DependsOnAttribute

Exceções

ArgumentException

Não há suporte para expressões. Não há suporte para associações.

Exemplos

No exemplo a seguir, o ItemsSource do ListBox é associado a Places, um ObservableCollection<T> dos objetos Place . Objetos de local têm propriedades Nome e Estado.

Cada ListBoxItem um deles ListBox exibe um objeto Place . O Style exemplo é aplicado a cada ListBoxItem.

É DataTrigger especificado de modo que, se o item de dados State of the Place for "WA", o primeiro plano do correspondente ListBoxItem será definido como 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 a seguir mostra dois DataTriggers definidos em um DataTemplate. O DataTemplate valor é aplicado a objetos de dados AuctionItem (não mostrados neste exemplo), que têm a propriedade SpecialFeatures. Consulte a Demonstração de Associação de Dados para obter o exemplo completo.

O primeiro DataTrigger é especificado de modo que, se o objeto de dados tiver um valor SpecialFeatures de Color, o item será exibido com um plano de fundo DodgerBlue com títulos da Marinha. Se o objeto de dados tiver um valor SpecialFeatures de Highlight, 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>

Comentários

Uso do elemento propriedade XAML

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

Esse valor é comparado com o valor da propriedade produzido pela Binding propriedade do DataTrigger. A comparação é uma verificação de igualdade de referência. Se os dois valores forem iguais, as ações ou setters associados serão aplicados.

Observe que você deve especificar as propriedades e Value as Binding propriedades em um DataTrigger para que o gatilho de dados seja significativo. Se uma ou ambas as propriedades não estiverem definidas, uma exceção será gerada.

Aplica-se a

Partilhar via