Selector.IsSynchronizedWithCurrentItem property

Gets or sets a value that indicates whether a Selector should keep the SelectedItem synchronized with the current item in the Items property.

Syntax

public Nullable<bool> IsSynchronizedWithCurrentItem { get; set; }

<selector IsSynchronizedWithCurrentItem="bool"/>
- or -
<selector IsSynchronizedWithCurrentItem="{x:Null}"/>

Property value

Type: IReference<Boolean> [C++] | System.Nullable<Boolean> [.NET]

true if the SelectedItem is always synchronized with the current item in the ItemCollection; false if the SelectedItem is never synchronized with the current item; null if the SelectedItem is synchronized with the current item only if the Selector uses an ICollectionView. The default value is null/indeterminate.

If you are programming using C# or Visual Basic, the type of this property is projected as bool? (a nullable Boolean).

Remarks

The nullable value for IsSynchronizedWithCurrentItem enables the value to be indeterminate, neither true nor false. This is indicated by a value of null. To set the value to null in XAML, use the x:Null markup extension.

Selection behavior and CollectionViewSource

The default selection behavior of list controls that derive from the Selector class depends on what the items source is (the type that's used for ItemsSource). If the items source is an instance of the CollectionViewSource class, the selection in the selection control defaults to the current item. When the list is first displayed, the selection defaults to the first item as the current item. If you don't want the first item to be selected in this case, set IsSynchronizedWithCurrentItem to false in the GridView, ListView, or other Selector-based control that is showing the selection.

Requirements

See also

Selector

Nullable

x:Null

Build date: 3/12/2013