Selector.IsSynchronizedWithCurrentItem Propriedade

Referência

Definição

Namespace:: System.Windows.Controls.Primitives

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 um valor que indica se um Selector deve manter o SelectedItem sincronizado com o item atual na propriedade Items.

public:
 property Nullable<bool> IsSynchronizedWithCurrentItem { Nullable<bool> get(); void set(Nullable<bool> value); };

[System.ComponentModel.Bindable(true)]
[System.ComponentModel.TypeConverter("System.Windows.NullableBoolConverter, PresentationFramework, Version=3.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, Custom=null")]
[System.Windows.Localizability(System.Windows.LocalizationCategory.NeverLocalize)]
public bool? IsSynchronizedWithCurrentItem { get; set; }

[System.ComponentModel.Bindable(true)]
[System.Windows.Localizability(System.Windows.LocalizationCategory.NeverLocalize)]
[System.ComponentModel.TypeConverter("System.Windows.NullableBoolConverter, PresentationFramework, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, Custom=null")]
public bool? IsSynchronizedWithCurrentItem { get; set; }

[<System.ComponentModel.Bindable(true)>]
[<System.ComponentModel.TypeConverter("System.Windows.NullableBoolConverter, PresentationFramework, Version=3.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, Custom=null")>]
[<System.Windows.Localizability(System.Windows.LocalizationCategory.NeverLocalize)>]
member this.IsSynchronizedWithCurrentItem : Nullable<bool> with get, set

[<System.ComponentModel.Bindable(true)>]
[<System.Windows.Localizability(System.Windows.LocalizationCategory.NeverLocalize)>]
[<System.ComponentModel.TypeConverter("System.Windows.NullableBoolConverter, PresentationFramework, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, Custom=null")>]
member this.IsSynchronizedWithCurrentItem : Nullable<bool> with get, set

Public Property IsSynchronizedWithCurrentItem As Nullable(Of Boolean)

Valor da propriedade

Nullable<Boolean>

true se o SelectedItem estiver sempre sincronizado com o item atual no ItemCollection; false se o SelectedItem nunca for sincronizado com o item atual; null se o SelectedItem for sincronizado com o item atual somente se o Selector usar um CollectionView. O valor padrão é null.

Atributos: BindableAttribute TypeConverterAttribute LocalizabilityAttribute

Exemplos

O exemplo a seguir associa dois controles ListBox ao mesmo ItemsSource. Como IsSynchronizedWithCurrentItem está definido como true em cada ListBox, o item selecionado é sempre o mesmo para ambos os controles

<XmlDataProvider x:Key="Employees" XPath="/Employees/*">
  <x:XData>
    <Employees xmlns="">
      <Employee Name="Terry Adams" Type="FTE" EmployeeNumber="1" />
      <Employee Name="Claire O'Donnell" Type="FTE" EmployeeNumber="12345" />
      <Employee Name="Palle Peterson" Type="FTE" EmployeeNumber="5678" />
      <Employee Name="Amy E. Alberts" Type="CSG" EmployeeNumber="99222" />
      <Employee Name="Stefan Hesse" Type="Vendor" EmployeeNumber="-" />
    </Employees>
  </x:XData>
</XmlDataProvider>

<DataTemplate x:Key="EmployeeItemTemplate">
  <TextBlock Text="{Binding XPath=@Name}" />
</DataTemplate>

<ListBox Name="employeeListBox1"
         ItemsSource="{Binding Source={StaticResource Employees}}"
         ItemTemplate="{StaticResource EmployeeItemTemplate}"
         IsSynchronizedWithCurrentItem="True"/>

<ListBox Name="employeeListBox2"
         ItemsSource="{Binding Source={StaticResource Employees}}"
         ItemTemplate="{StaticResource EmployeeItemTemplate}"
         IsSynchronizedWithCurrentItem="True"/>

Comentários

Você pode definir a propriedade IsSynchronizedWithCurrentItem como true para garantir que o item selecionado sempre corresponda à propriedade CurrentItem no ItemCollection. Por exemplo, suponha que haja dois controles ListBox com a propriedade ItemsSource definida como a mesma origem. Defina IsSynchronizedWithCurrentItem para true em ambas as caixas de listagem para garantir que o item selecionado em cada ListBox seja o mesmo.

Uso do atributo XAML

< objetoIsSynchronizedWithCurrentItem="Boolean"/>

-ou-

< objetoIsSynchronizedWithCurrentItem="{}"/>

Informações da propriedade Dependency


Campo identificador	IsSynchronizedWithCurrentItemProperty
Propriedades de metadados definidas como `true`	Nenhum

Aplica-se a

Compartilhar via