Selector.IsSynchronizedWithCurrentItem property

Applies to Windows and Windows Phone

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 if accessed in code. To set the value to null in XAML, use the x:Null markup extension.

Selection behavior and CollectionViewSource

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

Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

Windows Phone 8.1 [Windows Runtime apps only]

Namespace

Windows.UI.Xaml.Controls.Primitives
Windows::UI::Xaml::Controls::Primitives [C++]

Metadata

Windows.winmd

See also

Selector
Nullable
x:Null

 

 

Show:
© 2014 Microsoft. All rights reserved.