Selector.IsSynchronizedWithCurrentItem Property

Definition

Namespace:

Microsoft.UI.Xaml.Controls.Primitives

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

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

IReference<bool> IsSynchronizedWithCurrentItem();

void IsSynchronizedWithCurrentItem(IReference<bool> value);

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

var iReference = selector.isSynchronizedWithCurrentItem;
selector.isSynchronizedWithCurrentItem = iReference;

Public Property IsSynchronizedWithCurrentItem As Nullable(Of Boolean)

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

Property Value

IReference<Boolean>

Nullable<Boolean>

IReference<bool>

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

See also

• Nullable
• {x:Null} markup extension