ListViewBase ListViewBase ListViewBase ListViewBase Class

Definition

Provides the infrastructure for the ListView and GridView classes.

public : class ListViewBase : Selector, IListViewBase, IListViewBase2, IListViewBase3, IListViewBase4, IListViewBase5, IListViewBase6, ISemanticZoomInformation
public class ListViewBase : Selector, IListViewBase, IListViewBase2, IListViewBase3, IListViewBase4, IListViewBase5, IListViewBase6, ISemanticZoomInformation
Public Class ListViewBase Inherits Selector Implements IListViewBase, IListViewBase2, IListViewBase3, IListViewBase4, IListViewBase5, IListViewBase6, ISemanticZoomInformation
var listViewBase = new listViewBase();
Inheritance
Attributes
Windows 10 requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

Remarks

For user interface purposes, ListViewBase should be thought of as an abstract base class. Use ListView or GridView instead. The main difference between ListView and GridView is that ListView has a vertical/portrait orientation and GridView has a horizontal/landscape orientation. For more info, see ListView and GridView controls.

ListViewBase derived classes

ListViewBase is the parent class for GridView and ListView.

Constructors

ListViewBase() ListViewBase() ListViewBase() ListViewBase()

Provides base-class initialization behavior for classes that are derived from the ListViewBase class.

protected : ListViewBase()
protected ListViewBase()
Protected Sub New()
var listViewBase = new listViewBase();

Properties

CanDragItems CanDragItems CanDragItems CanDragItems

Gets or sets a value that indicates whether items in the view can be dragged as data payload.

public : Platform::Boolean CanDragItems { get; set; }
public bool CanDragItems { get; set; }
Public ReadWrite Property CanDragItems As bool
var bool = listViewBase.canDragItems;
listViewBase.canDragItems = bool;
<listViewBase CanDragItems="bool" />
Value
Platform::Boolean bool bool bool

True if items in the view can be dragged as data payload; otherwise, false. The default is false.

Remarks

Setting IsSwipeEnabled to false disables some default touch interactions, so it should be set to true when these interactions are needed. For example:

  • If item selection is enabled and you set IsSwipeEnabled to false, a user can deselect items by right-clicking with the mouse, but can't deselect an item with touch by using a swipe gesture.
  • If you set CanDragItems to true and IsSwipeEnabled to false, a user can drag items with the mouse, but not with touch.
  • If you set CanReorderItems to true and IsSwipeEnabled to false, a user can reorder items with the mouse, but not with touch.

CanDragItems can be set to false as part of visual states that are intended to prevent users from dragging items in views such as a GridView.

CanDragItems does not reflect transient states that might influence the ability to drag items, such as item population lag. The primary scenario where you might get the value of CanDragItems in code is to verify that dynamic templates or user-selectable options in your app UI have not changed the value since you last set it.

See Also

CanDragItemsProperty CanDragItemsProperty CanDragItemsProperty CanDragItemsProperty

Identifies the CanDragItems dependency property.

public : static DependencyProperty CanDragItemsProperty { get; }
public static DependencyProperty CanDragItemsProperty { get; }
Public Static ReadOnly Property CanDragItemsProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.ListViewBase.canDragItemsProperty;
Value
DependencyProperty DependencyProperty DependencyProperty DependencyProperty

The identifier for the CanDragItems dependency property.

CanReorderItems CanReorderItems CanReorderItems CanReorderItems

Gets or sets a value that indicates whether items in the view can be reordered through user interaction.

public : Platform::Boolean CanReorderItems { get; set; }
public bool CanReorderItems { get; set; }
Public ReadWrite Property CanReorderItems As bool
var bool = listViewBase.canReorderItems;
listViewBase.canReorderItems = bool;
<listViewBase CanReorderItems="bool" />
Value
Platform::Boolean bool bool bool

True if items in the view can be reordered through user interaction; otherwise, false. The default is false.

Examples

Here's a GridView that contains 6 rectangles that a user can reorder by drag-and-drop.

<GridView MaxHeight="310" 
          AllowDrop="True" 
          CanReorderItems="True">
    <Rectangle Height="100" Width="100" Fill="Blue"/>
    <Rectangle Height="100" Width="100" Fill="Red"/>
    <Rectangle Height="100" Width="100" Fill="Yellow"/>
    <Rectangle Height="100" Width="100" Fill="Green"/>
    <Rectangle Height="100" Width="100" Fill="Gray"/>
    <Rectangle Height="100" Width="100" Fill="LightBlue"/>
</GridView>

Remarks

To enable users to reorder items using drag-and-drop interaction, you must set both the CanReorderItems and AllowDrop properties to true.

Built in reordering is not supported when items are grouped, or when a VariableSizedWrapGrid is used as the ItemsPanel.

Setting IsSwipeEnabled to false disables some default touch interactions, so it should be set to true when these interactions are needed. For example:

  • If item selection is enabled and you set IsSwipeEnabled to false, a user can deselect items by right-clicking with the mouse, but can't deselect an item with touch by using a swipe gesture.
  • If you set CanDragItems to true and IsSwipeEnabled to false, a user can drag items with the mouse, but not with touch.
  • If you set CanReorderItems to true and IsSwipeEnabled to false, a user can reorder items with the mouse, but not with touch. +
See Also

CanReorderItemsProperty CanReorderItemsProperty CanReorderItemsProperty CanReorderItemsProperty

Identifies the CanReorderItems dependency property.

public : static DependencyProperty CanReorderItemsProperty { get; }
public static DependencyProperty CanReorderItemsProperty { get; }
Public Static ReadOnly Property CanReorderItemsProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.ListViewBase.canReorderItemsProperty;

DataFetchSize DataFetchSize DataFetchSize DataFetchSize

Gets or sets the amount of data to fetch for virtualizing/prefetch operations.

public : double DataFetchSize { get; set; }
public double DataFetchSize { get; set; }
Public ReadWrite Property DataFetchSize As double
var double = listViewBase.dataFetchSize;
listViewBase.dataFetchSize = double;
<listViewBase DataFetchSize="double" />
Value
double double double double

The amount of data to fetch per interval, in pages.

See Also

DataFetchSizeProperty DataFetchSizeProperty DataFetchSizeProperty DataFetchSizeProperty

Identifies the DataFetchSize dependency property.

public : static DependencyProperty DataFetchSizeProperty { get; }
public static DependencyProperty DataFetchSizeProperty { get; }
Public Static ReadOnly Property DataFetchSizeProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.ListViewBase.dataFetchSizeProperty;

Footer Footer Footer Footer

Gets or sets the content for the list footer.

public : Platform::Object Footer { get; set; }
public object Footer { get; set; }
Public ReadWrite Property Footer As object
var object = listViewBase.footer;
listViewBase.footer = object;
<listViewBase Footer="footerString"/>

Value
Platform::Object object object object

The content of the list footer. The default is null.

Remarks

By default, the footer is shown at the bottom for a ListView, and on the right for a GridView. If the FlowDirection property is set to RightToLeft, the footer is shown on the left for a GridView.

You can use a data template for the footer by setting the FooterTemplate property.

See Also

FooterProperty FooterProperty FooterProperty FooterProperty

Identifies the Footer dependency property.

public : static DependencyProperty FooterProperty { get; }
public static DependencyProperty FooterProperty { get; }
Public Static ReadOnly Property FooterProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.ListViewBase.footerProperty;
Value
DependencyProperty DependencyProperty DependencyProperty DependencyProperty

The identifier for the Footer dependency property.

FooterTemplate FooterTemplate FooterTemplate FooterTemplate

Gets or sets the DataTemplate used to display the content of the view footer.

public : DataTemplate FooterTemplate { get; set; }
public DataTemplate FooterTemplate { get; set; }
Public ReadWrite Property FooterTemplate As DataTemplate
var dataTemplate = listViewBase.footerTemplate;
listViewBase.footerTemplate = dataTemplate;
<listViewBase FooterTemplate="resourceReferenceToDataTemplate"/>
Value
DataTemplate DataTemplate DataTemplate DataTemplate

The template that specifies the visualization of the footer object. The default is null.

FooterTemplateProperty FooterTemplateProperty FooterTemplateProperty FooterTemplateProperty

Identifies the FooterTemplate dependency property.

public : static DependencyProperty FooterTemplateProperty { get; }
public static DependencyProperty FooterTemplateProperty { get; }
Public Static ReadOnly Property FooterTemplateProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.ListViewBase.footerTemplateProperty;

FooterTransitions FooterTransitions FooterTransitions FooterTransitions

Gets or sets the collection of Transition style elements that apply to the view footer.

public : TransitionCollection FooterTransitions { get; set; }
public TransitionCollection FooterTransitions { get; set; }
Public ReadWrite Property FooterTransitions As TransitionCollection
var transitionCollection = listViewBase.footerTransitions;
listViewBase.footerTransitions = transitionCollection;
<listViewBase>
  <listViewBase.FooterTransitions>
    <TransitionCollection>
      oneOrMoreTransitions
    </TransitionCollection>
  </listViewBase.FooterTransitions>
</listViewBase>
Value
TransitionCollection TransitionCollection TransitionCollection TransitionCollection

The collection of Transition style elements that apply to the list footer.

Remarks

Important

The XAML syntax for all properties that use a TransitionCollection value is unusual in that you must declare an explicit TransitionCollection object element as the value, and then provide object elements as child elements of TransitionCollection for each of the transition animations you want to use. For most other XAML collection properties you could omit the collection object element because it can be implicit, but properties that use TransitionCollection don't support the implicit collection usage. For more info on implicit collections and XAML, see XAML syntax guide.

Transition animations play a particular role in UI design of your app. The basic idea is that when there is a change or transition, the animation draws the attention of the user to the change.

See Also

FooterTransitionsProperty FooterTransitionsProperty FooterTransitionsProperty FooterTransitionsProperty

Identifies the FooterTransitions dependency property.

public : static DependencyProperty FooterTransitionsProperty { get; }
public static DependencyProperty FooterTransitionsProperty { get; }
Public Static ReadOnly Property FooterTransitionsProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.ListViewBase.footerTransitionsProperty;

Header Header Header Header

Gets or sets the content for the list header.

public : Platform::Object Header { get; set; }
public object Header { get; set; }
Public ReadWrite Property Header As object
var object = listViewBase.header;
listViewBase.header = object;
<listViewBase Header="headerString"/>

Value
Platform::Object object object object

The content of the list header. The default value is null.

Examples

Here's a GridView header that contains a StackPanel with text and an image. This Extensible Application Markup Language (XAML) is a simplified version of the GridView used in GroupDetail page of the Microsoft Visual Studio Grid App template.

<GridView x:Name="itemGridView"
          Margin="0,-14,0,0"
          Padding="120,0,120,50"
          ItemsSource="{Binding Source={StaticResource itemsViewSource}}"
          ItemTemplate="{StaticResource Standard500x130ItemTemplate}">

    <GridView.Header>
        <StackPanel Width="480" Margin="0,4,14,0">
            <TextBlock Text="{Binding Subtitle}" Margin="0,0,18,20" 
                       Style="{StaticResource SubheaderTextStyle}" MaxHeight="60"/>
            <Image Source="{Binding Image}" Height="400" Margin="0,0,18,20" 
                   Stretch="UniformToFill" AutomationProperties.Name="{Binding Title}"/>
            <TextBlock Text="{Binding Description}" Margin="0,0,18,0" 
                       Style="{StaticResource BodyTextStyle}"/>
        </StackPanel>
    </GridView.Header>
</GridView>

Remarks

By default, the header is shown at the top for a ListView, and on the left for a GridView. If the FlowDirection property is set to RightToLeft, the header is shown on the right for a GridView.

You can use a data template for the Header by setting the HeaderTemplate property.

See Also

HeaderProperty HeaderProperty HeaderProperty HeaderProperty

Identifies the Header dependency property.

public : static DependencyProperty HeaderProperty { get; }
public static DependencyProperty HeaderProperty { get; }
Public Static ReadOnly Property HeaderProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.ListViewBase.headerProperty;
Value
DependencyProperty DependencyProperty DependencyProperty DependencyProperty

The identifier for the Header dependency property.

HeaderTemplate HeaderTemplate HeaderTemplate HeaderTemplate

Gets or sets the DataTemplate used to display the content of the view header.

public : DataTemplate HeaderTemplate { get; set; }
public DataTemplate HeaderTemplate { get; set; }
Public ReadWrite Property HeaderTemplate As DataTemplate
var dataTemplate = listViewBase.headerTemplate;
listViewBase.headerTemplate = dataTemplate;
<listViewBase HeaderTemplate="resourceReferenceToDataTemplate"/>
Value
DataTemplate DataTemplate DataTemplate DataTemplate

The template that specifies the visualization of the header object. The default is null.

See Also

HeaderTemplateProperty HeaderTemplateProperty HeaderTemplateProperty HeaderTemplateProperty

Identifies the HeaderTemplate dependency property.

public : static DependencyProperty HeaderTemplateProperty { get; }
public static DependencyProperty HeaderTemplateProperty { get; }
Public Static ReadOnly Property HeaderTemplateProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.ListViewBase.headerTemplateProperty;

HeaderTransitions HeaderTransitions HeaderTransitions HeaderTransitions

Gets or sets the collection of Transition style elements that apply to the view header.

public : TransitionCollection HeaderTransitions { get; set; }
public TransitionCollection HeaderTransitions { get; set; }
Public ReadWrite Property HeaderTransitions As TransitionCollection
var transitionCollection = listViewBase.headerTransitions;
listViewBase.headerTransitions = transitionCollection;
<listViewBase>
  <listViewBase.HeaderTransitions>
    <TransitionCollection>
      oneOrMoreTransitions
    </TransitionCollection>
  </listViewBase.HeaderTransitions>
</listViewBase>
Value
TransitionCollection TransitionCollection TransitionCollection TransitionCollection

The collection of Transition style elements that apply to the list header.

Remarks

Important

The XAML syntax for all properties that use a TransitionCollection value is unusual in that you must declare an explicit TransitionCollection object element as the value, and then provide object elements as child elements of TransitionCollection for each of the transition animations you want to use. For most other XAML collection properties you could omit the collection object element because it can be implicit, but properties that use TransitionCollection don't support the implicit collection usage. For more info on implicit collections and XAML, see XAML syntax guide.

Transition animations play a particular role in UI design of your app. The basic idea is that when there is a change or transition, the animation draws the attention of the user to the change.

See Also

HeaderTransitionsProperty HeaderTransitionsProperty HeaderTransitionsProperty HeaderTransitionsProperty

Identifies the HeaderTransitions dependency property.

public : static DependencyProperty HeaderTransitionsProperty { get; }
public static DependencyProperty HeaderTransitionsProperty { get; }
Public Static ReadOnly Property HeaderTransitionsProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.ListViewBase.headerTransitionsProperty;

IncrementalLoadingThreshold IncrementalLoadingThreshold IncrementalLoadingThreshold IncrementalLoadingThreshold

Gets or sets the threshold range that governs when the ListViewBase class will begin to prefetch more items.

public : double IncrementalLoadingThreshold { get; set; }
public double IncrementalLoadingThreshold { get; set; }
Public ReadWrite Property IncrementalLoadingThreshold As double
var double = listViewBase.incrementalLoadingThreshold;
listViewBase.incrementalLoadingThreshold = double;
<listViewBase IncrementalLoadingThreshold="double" />
Value
double double double double

The loading threshold, in terms of pages.

Remarks

The meaning of the page count given for IncrementalLoadingThreshold is that the ListViewBase does not need to request more items via LoadMoreItemsAsync until the trigger condition (see IncrementalLoadingTrigger ) gets within the IncrementalLoadingThreshold page range. Setting a larger number (for instance 10 or more) represents a belief that the user might attempt to scroll through the list very quickly, and it is worthwhile devoting resources to loading more items as quickly as possible. Setting a smaller number (for instance 5 or less) represents a belief that the user will scroll through the list less quickly, and that the user's scroll rate will permit the items collection to catch up without being as resource intensive.

IncrementalLoadingThreshold and DataFetchSize both contribute to the possible resource load that is the result of prefetch operations.

See Also

IncrementalLoadingThresholdProperty IncrementalLoadingThresholdProperty IncrementalLoadingThresholdProperty IncrementalLoadingThresholdProperty

Identifies the IncrementalLoadingThreshold dependency property.

public : static DependencyProperty IncrementalLoadingThresholdProperty { get; }
public static DependencyProperty IncrementalLoadingThresholdProperty { get; }
Public Static ReadOnly Property IncrementalLoadingThresholdProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.ListViewBase.incrementalLoadingThresholdProperty;

IncrementalLoadingTrigger IncrementalLoadingTrigger IncrementalLoadingTrigger IncrementalLoadingTrigger

Gets or sets a value that indicates the conditions for prefetch operations by the ListViewBase class.

public : IncrementalLoadingTrigger IncrementalLoadingTrigger { get; set; }
public IncrementalLoadingTrigger IncrementalLoadingTrigger { get; set; }
Public ReadWrite Property IncrementalLoadingTrigger As IncrementalLoadingTrigger
var incrementalLoadingTrigger = listViewBase.incrementalLoadingTrigger;
listViewBase.incrementalLoadingTrigger = incrementalLoadingTrigger;
<listViewBase IncrementalLoadingTrigger="None" />
-or-
<listViewBase IncrementalLoadingTrigger="Edge" />
Value
IncrementalLoadingTrigger IncrementalLoadingTrigger IncrementalLoadingTrigger IncrementalLoadingTrigger

An enumeration value that indicates the conditions that trigger prefetch operations. The default is Edge.

See Also

IncrementalLoadingTriggerProperty IncrementalLoadingTriggerProperty IncrementalLoadingTriggerProperty IncrementalLoadingTriggerProperty

Identifies the IncrementalLoadingTrigger dependency property.

public : static DependencyProperty IncrementalLoadingTriggerProperty { get; }
public static DependencyProperty IncrementalLoadingTriggerProperty { get; }
Public Static ReadOnly Property IncrementalLoadingTriggerProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.ListViewBase.incrementalLoadingTriggerProperty;

IsActiveView IsActiveView IsActiveView IsActiveView

Gets or sets a value that indicates whether the ListViewBase instance is the active view in its owning SemanticZoom.

public : Platform::Boolean IsActiveView { get; set; }
public bool IsActiveView { get; set; }
Public ReadWrite Property IsActiveView As bool
var bool = listViewBase.isActiveView;
listViewBase.isActiveView = bool;
Value
Platform::Boolean bool bool bool

true if the ListViewBase is the active view; otherwise, false.

Remarks

You typically don't set this property in XAML or in app code. The property is set implicitly when the view is set as either the ZoomedInView or ZoomedOutView of a SemanticZoom control.

See Also

IsActiveViewProperty IsActiveViewProperty IsActiveViewProperty IsActiveViewProperty

Identifies the IsActiveView dependency property.

public : static DependencyProperty IsActiveViewProperty { get; }
public static DependencyProperty IsActiveViewProperty { get; }
Public Static ReadOnly Property IsActiveViewProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.ListViewBase.isActiveViewProperty;
Value
DependencyProperty DependencyProperty DependencyProperty DependencyProperty

The identifier for the IsActiveView dependency property.

IsItemClickEnabled IsItemClickEnabled IsItemClickEnabled IsItemClickEnabled

Gets or sets a value that indicates whether items in the view fire an ItemClick event in response to interaction.

public : Platform::Boolean IsItemClickEnabled { get; set; }
public bool IsItemClickEnabled { get; set; }
Public ReadWrite Property IsItemClickEnabled As bool
var bool = listViewBase.isItemClickEnabled;
listViewBase.isItemClickEnabled = bool;
<listViewBase IsItemClickEnabled="bool" />
Value
Platform::Boolean bool bool bool

true if interaction fires an ItemClick event; otherwise, false. The default is false.

Remarks

By default, a user can select items in the view by tapping or clicking on them. You can change this behavior to make the user interaction fire a click event instead of triggering item selection.

If you set the IsItemClickEnabled property to true, you must set the SelectionMode property to ListViewSelectionMode.None. Handle the ItemClick event to respond to the user interaction.

See Also

IsItemClickEnabledProperty IsItemClickEnabledProperty IsItemClickEnabledProperty IsItemClickEnabledProperty

Identifies the IsItemClickEnabled dependency property.

public : static DependencyProperty IsItemClickEnabledProperty { get; }
public static DependencyProperty IsItemClickEnabledProperty { get; }
Public Static ReadOnly Property IsItemClickEnabledProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.ListViewBase.isItemClickEnabledProperty;

IsMultiSelectCheckBoxEnabled IsMultiSelectCheckBoxEnabled IsMultiSelectCheckBoxEnabled IsMultiSelectCheckBoxEnabled

Gets or sets a value that indicates whether a check box is shown to enable multi-selection.

public : Platform::Boolean IsMultiSelectCheckBoxEnabled { get; set; }
public bool IsMultiSelectCheckBoxEnabled { get; set; }
Public ReadWrite Property IsMultiSelectCheckBoxEnabled As bool
var bool = listViewBase.isMultiSelectCheckBoxEnabled;
listViewBase.isMultiSelectCheckBoxEnabled = bool;
Value
Platform::Boolean bool bool bool

true if a check box is shown to enable multi-selection; otherwise, false.

IsMultiSelectCheckBoxEnabledProperty IsMultiSelectCheckBoxEnabledProperty IsMultiSelectCheckBoxEnabledProperty IsMultiSelectCheckBoxEnabledProperty

Get the identifier for the IsMultiSelectCheckBoxEnabled dependency property.

public : static DependencyProperty IsMultiSelectCheckBoxEnabledProperty { get; }
public static DependencyProperty IsMultiSelectCheckBoxEnabledProperty { get; }
Public Static ReadOnly Property IsMultiSelectCheckBoxEnabledProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.ListViewBase.isMultiSelectCheckBoxEnabledProperty;
See Also

IsSwipeEnabled IsSwipeEnabled IsSwipeEnabled IsSwipeEnabled

Gets or sets a value that indicates whether the view supports discrete input processing for a swipe interaction.

public : Platform::Boolean IsSwipeEnabled { get; set; }
public bool IsSwipeEnabled { get; set; }
Public ReadWrite Property IsSwipeEnabled As bool
var bool = listViewBase.isSwipeEnabled;
listViewBase.isSwipeEnabled = bool;
<listViewBase IsSwipeEnabled="bool" .../>
Value
Platform::Boolean bool bool bool

true if discrete input processing for swipe interactions is enabled; otherwise, false. The default is true.

Remarks

Setting IsSwipeEnabled to false disables some default touch interactions, so it should be set to true when these interactions are needed. For example:

  • If item selection is enabled and you set IsSwipeEnabled to false, a user can deselect items by right-clicking with the mouse, but can't deselect an item with touch by using a swipe gesture.
  • If you set CanDragItems to true and IsSwipeEnabled to false, a user can drag items with the mouse, but not with touch.
  • If you set CanReorderItems to true and IsSwipeEnabled to false, a user can reorder items with the mouse, but not with touch.

You typically set IsSwipeEnabled to false to disable swipe animations when items in the view don't support interactions that use the swipe gesture, like deselecting, dragging, and reordering. Disabling the animation when it's not needed can improve the performance of your app.

See Also

IsSwipeEnabledProperty IsSwipeEnabledProperty IsSwipeEnabledProperty IsSwipeEnabledProperty

Identifies the IsSwipeEnabled dependency property.

public : static DependencyProperty IsSwipeEnabledProperty { get; }
public static DependencyProperty IsSwipeEnabledProperty { get; }
Public Static ReadOnly Property IsSwipeEnabledProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.ListViewBase.isSwipeEnabledProperty;

IsZoomedInView IsZoomedInView IsZoomedInView IsZoomedInView

Gets or sets a value that indicates whether the ListViewBase instance is the zoomed-in view in its owning SemanticZoom.

public : Platform::Boolean IsZoomedInView { get; set; }
public bool IsZoomedInView { get; set; }
Public ReadWrite Property IsZoomedInView As bool
var bool = listViewBase.isZoomedInView;
listViewBase.isZoomedInView = bool;
Value
Platform::Boolean bool bool bool

true if the ListViewBase is the zoomed-in view; otherwise, false.

Remarks

You typically don't set this property in XAML or in app code. The property is set implicitly when the view is set as either the ZoomedInView or ZoomedOutView of a SemanticZoom control.

See Also

IsZoomedInViewProperty IsZoomedInViewProperty IsZoomedInViewProperty IsZoomedInViewProperty

Identifies the IsZoomedInView dependency property.

public : static DependencyProperty IsZoomedInViewProperty { get; }
public static DependencyProperty IsZoomedInViewProperty { get; }
Public Static ReadOnly Property IsZoomedInViewProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.ListViewBase.isZoomedInViewProperty;

ReorderMode ReorderMode ReorderMode ReorderMode

Gets or sets the reorder behavior for a ListViewBase instance. When Enabled, unsorted and ungrouped lists can be reordered by user manipulation.

public : ListViewReorderMode ReorderMode { get; set; }
public ListViewReorderMode ReorderMode { get; set; }
Public ReadWrite Property ReorderMode As ListViewReorderMode
var listViewReorderMode = listViewBase.reorderMode;
listViewBase.reorderMode = listViewReorderMode;
<listViewBase ReorderMode="Enabled"/>
-or-
<listViewBase ReorderMode="Disabled"/>
Value
ListViewReorderMode ListViewReorderMode ListViewReorderMode ListViewReorderMode

One of the ListViewReorderMode enumeration values. The default is Disabled.

ReorderModeProperty ReorderModeProperty ReorderModeProperty ReorderModeProperty

Identifies the ReorderMode dependency property.

public : static DependencyProperty ReorderModeProperty { get; }
public static DependencyProperty ReorderModeProperty { get; }
Public Static ReadOnly Property ReorderModeProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.ListViewBase.reorderModeProperty;
Value
DependencyProperty DependencyProperty DependencyProperty DependencyProperty

The identifier for the ReorderMode dependency property.

SelectedItems SelectedItems SelectedItems SelectedItems

Gets the currently selected items.

public : IVector<Platform::Object> SelectedItems { get; }
public IList<object> SelectedItems { get; }
Public ReadOnly Property SelectedItems As IList<object>
var iList = listViewBase.selectedItems;
Value
IVector<Platform::Object> IList<object> IList<object> IList<object>

A collection of the currently selected items. The default is an empty collection.

Remarks

When SelectionMode is Multiple or Extended, use the SelectedItems property to get the items that are selected. When SelectionMode is Single, use the Selector.SelectedItem property to get the item that's selected.

Starting in Windows 10, you can use the SelectRange and DeselectRange methods with the SelectedRanges property to make selections using ranges of indexes. This is a more efficient way to describe item selection than using SelectedItems, which requires the actual item object to be created for each selected item.

Note

If the ItemsSource implements IItemsRangeInfo, the SelectedItems collection is not updated based on selection in the list. Use the SelectedRanges property instead.

See Also

SelectedRanges SelectedRanges SelectedRanges SelectedRanges

Gets a collection of ItemIndexRange objects that describe the currently selected items in the list.

public : IVectorView<ItemIndexRange> SelectedRanges { get; }
public IReadOnlyList<ItemIndexRange> SelectedRanges { get; }
Public ReadOnly Property SelectedRanges As IReadOnlyList<ItemIndexRange>
var iReadOnlyList = listViewBase.selectedRanges;
Value
IVectorView<ItemIndexRange> IReadOnlyList<ItemIndexRange> IReadOnlyList<ItemIndexRange> IReadOnlyList<ItemIndexRange>

The collection of ItemIndexRange objects that describe the currently selected items in the list. The default is an empty collection.

Remarks

Each ItemIndexRange in the SelectedRanges collection describes a contiguous block of selected items. ItemIndexRange describes the selection by index, so item objects don't need to be created. This is a more efficient way to describe item selection than using SelectedItems, which requires the actual item object to be created for each selected item.

If your datasource performs data virtualization, you can use the SelectedRanges property with the SelectRange and DeselectRange methods to modify selection of items that have not been created yet.

Note

If the ItemsSource implements IItemsRangeInfo, the SelectedItems collection is not updated based on selection in the list. Use the SelectedRanges property instead.

See Also

SelectionMode SelectionMode SelectionMode SelectionMode

Gets or sets the selection behavior for a ListViewBase instance.

public : ListViewSelectionMode SelectionMode { get; set; }
public ListViewSelectionMode SelectionMode { get; set; }
Public ReadWrite Property SelectionMode As ListViewSelectionMode
var listViewSelectionMode = listViewBase.selectionMode;
listViewBase.selectionMode = listViewSelectionMode;
<listViewBase SelectionMode="listViewSelectionModeMemberName" />
Value
ListViewSelectionMode ListViewSelectionMode ListViewSelectionMode ListViewSelectionMode

One of the ListViewSelectionMode enumeration values. The default is Single selection.

Remarks

By default, a user can select a single item in a view. You can set the SelectionMode property to a ListViewSelectionMode enumeration value to enable multi-selection or to disable selection. Here are the selection mode values.

None Item selection is disabled.
Single With no modifier keys:

  • A user can select a single item using the space bar, mouse click, or touch tap.
  • A user can deselect an item using a downward swipe gesture.
While pressing Ctrl:

  • A user can deselect the item by using the space bar, mouse click, or touch tap.
  • Using the arrow keys, a user can move focus independently of selection.
Multiple With no modifier keys:

  • A user can select multiple items using the space bar, mouse click, or touch tap to toggle selection on the focused item.
  • Using the arrow keys, a user can move focus independently of selection.
Extended With no modifier keys:

  • The behavior is the same as Single selection.
While pressing Ctrl:

  • A user can select multiple items using the space bar, mouse click, or touch tap to toggle selection on the focused item.
  • Using the arrow keys, a user can move focus independently of selection.
While pressing Shift:

  • A user can select multiple contiguous items by clicking or tapping the first item in the selection and then the last item in the selection.
  • Using the arrow keys, a user can create a contiguous selection starting with the item selected when Shift is pressed.

Note

Touch interactions are enabled only when IsSwipeEnabled is true.

If SelectionMode is None, and CanDragItems and CanReorderItems are false, you should set IsSwipeEnabled to false to improve app performance. See the IsSwipeEnabled property for more info.

When SelectionMode is Single, use the Selector.SelectedItem property to get the item that's selected. When SelectionMode is Multiple or Extended, use the SelectedItems property to get the items that are selected.

When item selection is disabled, you can make items respond to a user click like a button instead of being selected. To do this, set SelectionMode to None, the IsItemClickEnabled property to true, and handle the ItemClick event.

For more info and examples, see How to change the interaction mode.

See Also

SelectionModeProperty SelectionModeProperty SelectionModeProperty SelectionModeProperty

Identifies the SelectionMode dependency property.

public : static DependencyProperty SelectionModeProperty { get; }
public static DependencyProperty SelectionModeProperty { get; }
Public Static ReadOnly Property SelectionModeProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.ListViewBase.selectionModeProperty;

SemanticZoomOwner SemanticZoomOwner SemanticZoomOwner SemanticZoomOwner

Gets or sets the SemanticZoom instance that hosts the ListViewBase.

public : SemanticZoom SemanticZoomOwner { get; set; }
public SemanticZoom SemanticZoomOwner { get; set; }
Public ReadWrite Property SemanticZoomOwner As SemanticZoom
var semanticZoom = listViewBase.semanticZoomOwner;
listViewBase.semanticZoomOwner = semanticZoom;
Value
SemanticZoom SemanticZoom SemanticZoom SemanticZoom

The SemanticZoom instance that hosts this view, or null if the view is not hosted in a SemanticZoom control.

Remarks

You don't set this property in Extensible Application Markup Language (XAML) or in your app code. The property is set implicitly when the view is set as either the ZoomedInView or ZoomedOutView of a SemanticZoom control.

See Also

SemanticZoomOwnerProperty SemanticZoomOwnerProperty SemanticZoomOwnerProperty SemanticZoomOwnerProperty

Identifies the SemanticZoomOwner dependency property.

public : static DependencyProperty SemanticZoomOwnerProperty { get; }
public static DependencyProperty SemanticZoomOwnerProperty { get; }
Public Static ReadOnly Property SemanticZoomOwnerProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.ListViewBase.semanticZoomOwnerProperty;

ShowsScrollingPlaceholders ShowsScrollingPlaceholders ShowsScrollingPlaceholders ShowsScrollingPlaceholders

Gets or sets a value that indicates whether the view shows placeholder UI for items during scrolling.

public : Platform::Boolean ShowsScrollingPlaceholders { get; set; }
public bool ShowsScrollingPlaceholders { get; set; }
Public ReadWrite Property ShowsScrollingPlaceholders As bool
var bool = listViewBase.showsScrollingPlaceholders;
listViewBase.showsScrollingPlaceholders = bool;
<listViewBase ShowsScrollingPlaceholders="bool" />
Value
Platform::Boolean bool bool bool

true if the view shows placeholder UI for items during scrolling; otherwise, false. The default is true.

ShowsScrollingPlaceholdersProperty ShowsScrollingPlaceholdersProperty ShowsScrollingPlaceholdersProperty ShowsScrollingPlaceholdersProperty

Identifies the ShowsScrollingPlaceholders dependency property.

public : static DependencyProperty ShowsScrollingPlaceholdersProperty { get; }
public static DependencyProperty ShowsScrollingPlaceholdersProperty { get; }
Public Static ReadOnly Property ShowsScrollingPlaceholdersProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.ListViewBase.showsScrollingPlaceholdersProperty;

SingleSelectionFollowsFocus SingleSelectionFollowsFocus SingleSelectionFollowsFocus SingleSelectionFollowsFocus

Gets or sets a value that indicates whether item selection changes when keyboard focus changes.

public : Platform::Boolean SingleSelectionFollowsFocus { get; set; }
public bool SingleSelectionFollowsFocus { get; set; }
Public ReadWrite Property SingleSelectionFollowsFocus As bool
var bool = listViewBase.singleSelectionFollowsFocus;
listViewBase.singleSelectionFollowsFocus = bool;
<listViewBase SingleSelectionFollowsFocus="bool" />
Value
Platform::Boolean bool bool bool

true if item selection changes when keyboard focus changes; otherwise, false. The default is true.

Additional features and requirements
Device family
Windows 10 Anniversary Edition (introduced v10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v3)

Remarks

This property is ignored if the list view's SelectionMode property is not set to Single.

By default, when a list view is configured for single selection, when the user moves keyboard focus to an item, the focused item is also selected. For example, if keyboard focus is moved from the first item to the second item, the SelectedIndex property is updated from 0 to 1.

Set this property to false to let a user move focus without the item selection following. For example, if each selection change causes significant UI updates, you might prefer to let the user move focus to a non-adjacent item and then press enter to update selection.

Version compatibility

The SingleSelectionFollowsFocus property is not available prior to Windows 10, version 1607. If your app’s 'minimum platform version' setting in Microsoft Visual Studio is less than the 'introduced version' shown in the Requirements block later in this page, you must design and test your app to account for this. For more info, see Version adaptive code.

To avoid exceptions when your app runs on previous versions of Windows 10, do not set this property in XAML or use it without performing a runtime check. This example shows how to use the ApiInformation class to check for the presence of this property before you set it.

<ListView x:Name="listView1" Loaded="ListView_Loaded"/>
private void ListView_Loaded(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.ListViewBase", "SingleSelectionFollowsFocus"))
    {
        listView1.SingleSelectionFollowsFocus = false;
    }
}

SingleSelectionFollowsFocusProperty SingleSelectionFollowsFocusProperty SingleSelectionFollowsFocusProperty SingleSelectionFollowsFocusProperty

Identifies the SingleSelectionFollowsFocus dependency property.

public : static DependencyProperty SingleSelectionFollowsFocusProperty { get; }
public static DependencyProperty SingleSelectionFollowsFocusProperty { get; }
Public Static ReadOnly Property SingleSelectionFollowsFocusProperty As DependencyProperty
var dependencyProperty = Windows.UI.Xaml.Controls.ListViewBase.singleSelectionFollowsFocusProperty;
Additional features and requirements
Device family
Windows 10 Anniversary Edition (introduced v10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v3)

AccessKey AccessKey AccessKey AccessKey

Inherited from UIElement

AccessKeyProperty AccessKeyProperty AccessKeyProperty AccessKeyProperty

Inherited from UIElement

AccessKeyScopeOwner AccessKeyScopeOwner AccessKeyScopeOwner AccessKeyScopeOwner

Inherited from UIElement

AccessKeyScopeOwnerProperty AccessKeyScopeOwnerProperty AccessKeyScopeOwnerProperty AccessKeyScopeOwnerProperty

Inherited from UIElement

ActualHeight ActualHeight ActualHeight ActualHeight

Inherited from FrameworkElement

ActualHeightProperty ActualHeightProperty ActualHeightProperty ActualHeightProperty

Inherited from FrameworkElement

ActualTheme ActualTheme ActualTheme ActualTheme

Inherited from FrameworkElement

ActualThemeProperty ActualThemeProperty ActualThemeProperty ActualThemeProperty

Inherited from FrameworkElement

ActualWidth ActualWidth ActualWidth ActualWidth

Inherited from FrameworkElement

ActualWidthProperty ActualWidthProperty ActualWidthProperty ActualWidthProperty

Inherited from FrameworkElement

AllowDrop AllowDrop AllowDrop AllowDrop

Inherited from UIElement

AllowDropProperty AllowDropProperty AllowDropProperty AllowDropProperty

Inherited from UIElement

AllowFocusOnInteraction AllowFocusOnInteraction AllowFocusOnInteraction AllowFocusOnInteraction

Inherited from FrameworkElement

AllowFocusOnInteractionProperty AllowFocusOnInteractionProperty AllowFocusOnInteractionProperty AllowFocusOnInteractionProperty

Inherited from FrameworkElement

AllowFocusWhenDisabled AllowFocusWhenDisabled AllowFocusWhenDisabled AllowFocusWhenDisabled

Inherited from FrameworkElement

AllowFocusWhenDisabledProperty AllowFocusWhenDisabledProperty AllowFocusWhenDisabledProperty AllowFocusWhenDisabledProperty

Inherited from FrameworkElement

Background Background Background Background

Inherited from Control

BackgroundProperty BackgroundProperty BackgroundProperty BackgroundProperty

Inherited from Control

BaseUri BaseUri BaseUri BaseUri

Inherited from FrameworkElement

BorderBrush BorderBrush BorderBrush BorderBrush

Inherited from Control

BorderBrushProperty BorderBrushProperty BorderBrushProperty BorderBrushProperty

Inherited from Control

BorderThickness BorderThickness BorderThickness BorderThickness

Inherited from Control

BorderThicknessProperty BorderThicknessProperty BorderThicknessProperty BorderThicknessProperty

Inherited from Control

CacheMode CacheMode CacheMode CacheMode

Inherited from UIElement

CacheModeProperty CacheModeProperty CacheModeProperty CacheModeProperty

Inherited from UIElement

CanDrag CanDrag CanDrag CanDrag

Inherited from UIElement

CanDragProperty CanDragProperty CanDragProperty CanDragProperty

Inherited from UIElement

CharacterReceivedEvent CharacterReceivedEvent CharacterReceivedEvent CharacterReceivedEvent

Inherited from UIElement

CharacterSpacing CharacterSpacing CharacterSpacing CharacterSpacing

Inherited from Control

CharacterSpacingProperty CharacterSpacingProperty CharacterSpacingProperty CharacterSpacingProperty

Inherited from Control

Clip Clip Clip Clip

Inherited from UIElement

ClipProperty ClipProperty ClipProperty ClipProperty

Inherited from UIElement

CompositeMode CompositeMode CompositeMode CompositeMode

Inherited from UIElement

CompositeModeProperty CompositeModeProperty CompositeModeProperty CompositeModeProperty

Inherited from UIElement

ContextFlyout ContextFlyout ContextFlyout ContextFlyout

Inherited from UIElement

ContextFlyoutProperty ContextFlyoutProperty ContextFlyoutProperty ContextFlyoutProperty

Inherited from UIElement

DataContext DataContext DataContext DataContext

Inherited from FrameworkElement

DataContextProperty DataContextProperty DataContextProperty DataContextProperty

Inherited from FrameworkElement

DefaultStyleKey DefaultStyleKey DefaultStyleKey DefaultStyleKey

Inherited from Control

DefaultStyleKeyProperty DefaultStyleKeyProperty DefaultStyleKeyProperty DefaultStyleKeyProperty

Inherited from Control

DefaultStyleResourceUri DefaultStyleResourceUri DefaultStyleResourceUri DefaultStyleResourceUri

Inherited from Control

DefaultStyleResourceUriProperty DefaultStyleResourceUriProperty DefaultStyleResourceUriProperty DefaultStyleResourceUriProperty

Inherited from Control

DesiredSize DesiredSize DesiredSize DesiredSize

Inherited from UIElement

Dispatcher Dispatcher Dispatcher Dispatcher

Inherited from DependencyObject

DisplayMemberPath DisplayMemberPath DisplayMemberPath DisplayMemberPath

Inherited from ItemsControl

DisplayMemberPathProperty DisplayMemberPathProperty DisplayMemberPathProperty DisplayMemberPathProperty

Inherited from ItemsControl

DoubleTappedEvent DoubleTappedEvent DoubleTappedEvent DoubleTappedEvent

Inherited from UIElement

DragEnterEvent DragEnterEvent DragEnterEvent DragEnterEvent

Inherited from UIElement

DragLeaveEvent DragLeaveEvent DragLeaveEvent DragLeaveEvent

Inherited from UIElement

DragOverEvent DragOverEvent DragOverEvent DragOverEvent

Inherited from UIElement

DropEvent DropEvent DropEvent DropEvent

Inherited from UIElement

ElementSoundMode ElementSoundMode ElementSoundMode ElementSoundMode

Inherited from Control

ElementSoundModeProperty ElementSoundModeProperty ElementSoundModeProperty ElementSoundModeProperty

Inherited from Control

ExitDisplayModeOnAccessKeyInvoked ExitDisplayModeOnAccessKeyInvoked ExitDisplayModeOnAccessKeyInvoked ExitDisplayModeOnAccessKeyInvoked

Inherited from UIElement

ExitDisplayModeOnAccessKeyInvokedProperty ExitDisplayModeOnAccessKeyInvokedProperty ExitDisplayModeOnAccessKeyInvokedProperty ExitDisplayModeOnAccessKeyInvokedProperty

Inherited from UIElement

FlowDirection FlowDirection FlowDirection FlowDirection

Inherited from FrameworkElement

FlowDirectionProperty FlowDirectionProperty FlowDirectionProperty FlowDirectionProperty

Inherited from FrameworkElement

FocusState FocusState FocusState FocusState

Inherited from Control

FocusStateProperty FocusStateProperty FocusStateProperty FocusStateProperty

Inherited from Control

FocusVisualMargin FocusVisualMargin FocusVisualMargin FocusVisualMargin

Inherited from FrameworkElement

FocusVisualMarginProperty FocusVisualMarginProperty FocusVisualMarginProperty FocusVisualMarginProperty

Inherited from FrameworkElement

FocusVisualPrimaryBrush FocusVisualPrimaryBrush FocusVisualPrimaryBrush FocusVisualPrimaryBrush

Inherited from FrameworkElement

FocusVisualPrimaryBrushProperty FocusVisualPrimaryBrushProperty FocusVisualPrimaryBrushProperty FocusVisualPrimaryBrushProperty

Inherited from FrameworkElement

FocusVisualPrimaryThickness FocusVisualPrimaryThickness FocusVisualPrimaryThickness FocusVisualPrimaryThickness

Inherited from FrameworkElement

FocusVisualPrimaryThicknessProperty FocusVisualPrimaryThicknessProperty FocusVisualPrimaryThicknessProperty FocusVisualPrimaryThicknessProperty

Inherited from FrameworkElement

FocusVisualSecondaryBrush FocusVisualSecondaryBrush FocusVisualSecondaryBrush FocusVisualSecondaryBrush

Inherited from FrameworkElement

FocusVisualSecondaryBrushProperty FocusVisualSecondaryBrushProperty FocusVisualSecondaryBrushProperty FocusVisualSecondaryBrushProperty

Inherited from FrameworkElement

FocusVisualSecondaryThickness FocusVisualSecondaryThickness FocusVisualSecondaryThickness FocusVisualSecondaryThickness

Inherited from FrameworkElement

FocusVisualSecondaryThicknessProperty FocusVisualSecondaryThicknessProperty FocusVisualSecondaryThicknessProperty FocusVisualSecondaryThicknessProperty

Inherited from FrameworkElement

FontFamily FontFamily FontFamily FontFamily

Inherited from Control

FontFamilyProperty FontFamilyProperty FontFamilyProperty FontFamilyProperty

Inherited from Control

FontSize FontSize FontSize FontSize

Inherited from Control

FontSizeProperty FontSizeProperty FontSizeProperty FontSizeProperty

Inherited from Control

FontStretch FontStretch FontStretch FontStretch

Inherited from Control

FontStretchProperty FontStretchProperty FontStretchProperty FontStretchProperty

Inherited from Control

FontStyle FontStyle FontStyle FontStyle

Inherited from Control

FontStyleProperty FontStyleProperty FontStyleProperty FontStyleProperty

Inherited from Control

FontWeight FontWeight FontWeight FontWeight

Inherited from Control

FontWeightProperty FontWeightProperty FontWeightProperty FontWeightProperty

Inherited from Control

Foreground Foreground Foreground Foreground

Inherited from Control

ForegroundProperty ForegroundProperty ForegroundProperty ForegroundProperty

Inherited from Control

GettingFocusEvent GettingFocusEvent GettingFocusEvent GettingFocusEvent

Inherited from UIElement

GroupStyle GroupStyle GroupStyle GroupStyle

Inherited from ItemsControl

GroupStyleSelector GroupStyleSelector GroupStyleSelector GroupStyleSelector

Inherited from ItemsControl

GroupStyleSelectorProperty GroupStyleSelectorProperty GroupStyleSelectorProperty GroupStyleSelectorProperty

Inherited from ItemsControl

Height Height Height Height

Inherited from FrameworkElement

HeightProperty HeightProperty HeightProperty HeightProperty

Inherited from FrameworkElement

HighContrastAdjustment HighContrastAdjustment HighContrastAdjustment HighContrastAdjustment

Inherited from UIElement

HighContrastAdjustmentProperty HighContrastAdjustmentProperty HighContrastAdjustmentProperty HighContrastAdjustmentProperty

Inherited from UIElement

HoldingEvent HoldingEvent HoldingEvent HoldingEvent

Inherited from UIElement

HorizontalAlignment HorizontalAlignment HorizontalAlignment HorizontalAlignment

Inherited from FrameworkElement

HorizontalAlignmentProperty HorizontalAlignmentProperty HorizontalAlignmentProperty HorizontalAlignmentProperty

Inherited from FrameworkElement

HorizontalContentAlignment HorizontalContentAlignment HorizontalContentAlignment HorizontalContentAlignment

Inherited from Control

HorizontalContentAlignmentProperty HorizontalContentAlignmentProperty HorizontalContentAlignmentProperty HorizontalContentAlignmentProperty

Inherited from Control

IsAccessKeyScope IsAccessKeyScope IsAccessKeyScope IsAccessKeyScope

Inherited from UIElement

IsAccessKeyScopeProperty IsAccessKeyScopeProperty IsAccessKeyScopeProperty IsAccessKeyScopeProperty

Inherited from UIElement

IsDoubleTapEnabled IsDoubleTapEnabled IsDoubleTapEnabled IsDoubleTapEnabled

Inherited from UIElement

IsDoubleTapEnabledProperty IsDoubleTapEnabledProperty IsDoubleTapEnabledProperty IsDoubleTapEnabledProperty

Inherited from UIElement

IsEnabled IsEnabled IsEnabled IsEnabled

Inherited from Control

IsEnabledProperty IsEnabledProperty IsEnabledProperty IsEnabledProperty

Inherited from Control

IsFocusEngaged IsFocusEngaged IsFocusEngaged IsFocusEngaged

Inherited from Control

IsFocusEngagedProperty IsFocusEngagedProperty IsFocusEngagedProperty IsFocusEngagedProperty

Inherited from Control

IsFocusEngagementEnabled IsFocusEngagementEnabled IsFocusEngagementEnabled IsFocusEngagementEnabled

Inherited from Control

IsFocusEngagementEnabledProperty IsFocusEngagementEnabledProperty IsFocusEngagementEnabledProperty IsFocusEngagementEnabledProperty

Inherited from Control

IsGrouping IsGrouping IsGrouping IsGrouping

Inherited from ItemsControl

IsGroupingProperty IsGroupingProperty IsGroupingProperty IsGroupingProperty

Inherited from ItemsControl

IsHitTestVisible IsHitTestVisible IsHitTestVisible IsHitTestVisible

Inherited from UIElement

IsHitTestVisibleProperty IsHitTestVisibleProperty IsHitTestVisibleProperty IsHitTestVisibleProperty

Inherited from UIElement

IsHoldingEnabled IsHoldingEnabled IsHoldingEnabled IsHoldingEnabled

Inherited from UIElement

IsHoldingEnabledProperty IsHoldingEnabledProperty IsHoldingEnabledProperty IsHoldingEnabledProperty

Inherited from UIElement

IsRightTapEnabled IsRightTapEnabled IsRightTapEnabled IsRightTapEnabled

Inherited from UIElement

IsRightTapEnabledProperty IsRightTapEnabledProperty IsRightTapEnabledProperty IsRightTapEnabledProperty

Inherited from UIElement

IsSynchronizedWithCurrentItem IsSynchronizedWithCurrentItem IsSynchronizedWithCurrentItem IsSynchronizedWithCurrentItem

Inherited from Selector

IsSynchronizedWithCurrentItemProperty IsSynchronizedWithCurrentItemProperty IsSynchronizedWithCurrentItemProperty IsSynchronizedWithCurrentItemProperty

Inherited from Selector

IsTabStop IsTabStop IsTabStop IsTabStop

Inherited from Control

IsTabStopProperty IsTabStopProperty IsTabStopProperty IsTabStopProperty

Inherited from Control

IsTapEnabled IsTapEnabled IsTapEnabled IsTapEnabled

Inherited from UIElement

IsTapEnabledProperty IsTapEnabledProperty IsTapEnabledProperty IsTapEnabledProperty

Inherited from UIElement

IsTemplateFocusTargetProperty IsTemplateFocusTargetProperty IsTemplateFocusTargetProperty IsTemplateFocusTargetProperty

Inherited from Control

IsTemplateKeyTipTargetProperty IsTemplateKeyTipTargetProperty IsTemplateKeyTipTargetProperty IsTemplateKeyTipTargetProperty

Inherited from Control

IsTextScaleFactorEnabled IsTextScaleFactorEnabled IsTextScaleFactorEnabled IsTextScaleFactorEnabled

Inherited from Control

IsTextScaleFactorEnabledProperty IsTextScaleFactorEnabledProperty IsTextScaleFactorEnabledProperty IsTextScaleFactorEnabledProperty

Inherited from Control

ItemContainerGenerator ItemContainerGenerator ItemContainerGenerator ItemContainerGenerator

Inherited from ItemsControl

ItemContainerStyle ItemContainerStyle ItemContainerStyle ItemContainerStyle

Inherited from ItemsControl

ItemContainerStyleProperty ItemContainerStyleProperty ItemContainerStyleProperty ItemContainerStyleProperty

Inherited from ItemsControl

ItemContainerStyleSelector ItemContainerStyleSelector ItemContainerStyleSelector ItemContainerStyleSelector

Inherited from ItemsControl

ItemContainerStyleSelectorProperty ItemContainerStyleSelectorProperty ItemContainerStyleSelectorProperty ItemContainerStyleSelectorProperty

Inherited from ItemsControl

ItemContainerTransitions ItemContainerTransitions ItemContainerTransitions ItemContainerTransitions

Inherited from ItemsControl

ItemContainerTransitionsProperty ItemContainerTransitionsProperty ItemContainerTransitionsProperty ItemContainerTransitionsProperty

Inherited from ItemsControl

Items Items Items Items

Inherited from Windows.UI.Xaml.ControlsControl.Items

ItemsPanel ItemsPanel ItemsPanel ItemsPanel

Inherited from ItemsControl

ItemsPanelProperty ItemsPanelProperty ItemsPanelProperty ItemsPanelProperty

Inherited from ItemsControl

ItemsPanelRoot ItemsPanelRoot ItemsPanelRoot ItemsPanelRoot

Inherited from ItemsControl

ItemsSource ItemsSource ItemsSource ItemsSource

Inherited from ItemsControl

ItemsSourceProperty ItemsSourceProperty ItemsSourceProperty ItemsSourceProperty

Inherited from ItemsControl

ItemTemplate ItemTemplate ItemTemplate ItemTemplate

Inherited from ItemsControl

ItemTemplateProperty ItemTemplateProperty ItemTemplateProperty ItemTemplateProperty

Inherited from ItemsControl

ItemTemplateSelector ItemTemplateSelector ItemTemplateSelector ItemTemplateSelector

Inherited from ItemsControl

ItemTemplateSelectorProperty ItemTemplateSelectorProperty ItemTemplateSelectorProperty ItemTemplateSelectorProperty

Inherited from ItemsControl

KeyboardAccelerators KeyboardAccelerators KeyboardAccelerators KeyboardAccelerators

Inherited from UIElement

KeyDownEvent KeyDownEvent KeyDownEvent KeyDownEvent

Inherited from UIElement

KeyTipHorizontalOffset KeyTipHorizontalOffset KeyTipHorizontalOffset KeyTipHorizontalOffset

Inherited from UIElement

KeyTipHorizontalOffsetProperty KeyTipHorizontalOffsetProperty KeyTipHorizontalOffsetProperty KeyTipHorizontalOffsetProperty

Inherited from UIElement

KeyTipPlacementMode KeyTipPlacementMode KeyTipPlacementMode KeyTipPlacementMode

Inherited from UIElement

KeyTipPlacementModeProperty KeyTipPlacementModeProperty KeyTipPlacementModeProperty KeyTipPlacementModeProperty

Inherited from UIElement

KeyTipVerticalOffset KeyTipVerticalOffset KeyTipVerticalOffset KeyTipVerticalOffset

Inherited from UIElement

KeyTipVerticalOffsetProperty KeyTipVerticalOffsetProperty KeyTipVerticalOffsetProperty KeyTipVerticalOffsetProperty

Inherited from UIElement

KeyUpEvent KeyUpEvent KeyUpEvent KeyUpEvent

Inherited from UIElement

Language Language Language Language

Inherited from FrameworkElement

LanguageProperty LanguageProperty LanguageProperty LanguageProperty

Inherited from FrameworkElement

Lights Lights Lights Lights

Inherited from UIElement

LightsProperty LightsProperty LightsProperty LightsProperty

Inherited from UIElement

LosingFocusEvent LosingFocusEvent LosingFocusEvent LosingFocusEvent

Inherited from UIElement

ManipulationCompletedEvent ManipulationCompletedEvent ManipulationCompletedEvent ManipulationCompletedEvent

Inherited from UIElement

ManipulationDeltaEvent ManipulationDeltaEvent ManipulationDeltaEvent ManipulationDeltaEvent

Inherited from UIElement

ManipulationInertiaStartingEvent ManipulationInertiaStartingEvent ManipulationInertiaStartingEvent ManipulationInertiaStartingEvent

Inherited from UIElement

ManipulationMode ManipulationMode ManipulationMode ManipulationMode

Inherited from UIElement

ManipulationModeProperty ManipulationModeProperty ManipulationModeProperty ManipulationModeProperty

Inherited from UIElement

ManipulationStartedEvent ManipulationStartedEvent ManipulationStartedEvent ManipulationStartedEvent

Inherited from UIElement

ManipulationStartingEvent ManipulationStartingEvent ManipulationStartingEvent ManipulationStartingEvent

Inherited from UIElement

Margin Margin Margin Margin

Inherited from FrameworkElement

MarginProperty MarginProperty MarginProperty MarginProperty

Inherited from FrameworkElement

MaxHeight MaxHeight MaxHeight MaxHeight

Inherited from FrameworkElement

MaxHeightProperty MaxHeightProperty MaxHeightProperty MaxHeightProperty

Inherited from FrameworkElement

MaxWidth MaxWidth MaxWidth MaxWidth

Inherited from FrameworkElement

MaxWidthProperty MaxWidthProperty MaxWidthProperty MaxWidthProperty

Inherited from FrameworkElement

MinHeight MinHeight MinHeight MinHeight

Inherited from FrameworkElement

MinHeightProperty MinHeightProperty MinHeightProperty MinHeightProperty

Inherited from FrameworkElement

MinWidth MinWidth MinWidth MinWidth

Inherited from FrameworkElement

MinWidthProperty MinWidthProperty MinWidthProperty MinWidthProperty

Inherited from FrameworkElement

Name Name Name Name

Inherited from FrameworkElement

NameProperty NameProperty NameProperty NameProperty

Inherited from FrameworkElement

NoFocusCandidateFoundEvent NoFocusCandidateFoundEvent NoFocusCandidateFoundEvent NoFocusCandidateFoundEvent

Inherited from UIElement

Opacity Opacity Opacity Opacity

Inherited from UIElement

OpacityProperty OpacityProperty OpacityProperty OpacityProperty

Inherited from UIElement

Padding Padding Padding Padding

Inherited from Control

PaddingProperty PaddingProperty PaddingProperty PaddingProperty

Inherited from Control

Parent Parent Parent Parent

Inherited from FrameworkElement

PointerCanceledEvent PointerCanceledEvent PointerCanceledEvent PointerCanceledEvent

Inherited from UIElement

PointerCaptureLostEvent PointerCaptureLostEvent PointerCaptureLostEvent PointerCaptureLostEvent

Inherited from UIElement

PointerCaptures PointerCaptures PointerCaptures PointerCaptures

Inherited from UIElement

PointerCapturesProperty PointerCapturesProperty PointerCapturesProperty PointerCapturesProperty

Inherited from UIElement

PointerEnteredEvent PointerEnteredEvent PointerEnteredEvent PointerEnteredEvent

Inherited from UIElement

PointerExitedEvent PointerExitedEvent PointerExitedEvent PointerExitedEvent

Inherited from UIElement

PointerMovedEvent PointerMovedEvent PointerMovedEvent PointerMovedEvent

Inherited from UIElement

PointerPressedEvent PointerPressedEvent PointerPressedEvent PointerPressedEvent

Inherited from UIElement

PointerReleasedEvent PointerReleasedEvent PointerReleasedEvent PointerReleasedEvent

Inherited from UIElement

PointerWheelChangedEvent PointerWheelChangedEvent PointerWheelChangedEvent PointerWheelChangedEvent

Inherited from UIElement

PreviewKeyDownEvent PreviewKeyDownEvent PreviewKeyDownEvent PreviewKeyDownEvent

Inherited from UIElement

PreviewKeyUpEvent PreviewKeyUpEvent PreviewKeyUpEvent PreviewKeyUpEvent

Inherited from UIElement

Projection Projection Projection Projection

Inherited from UIElement

ProjectionProperty ProjectionProperty ProjectionProperty ProjectionProperty

Inherited from UIElement

RenderSize RenderSize RenderSize RenderSize

Inherited from UIElement

RenderTransform RenderTransform RenderTransform RenderTransform

Inherited from UIElement

RenderTransformOrigin RenderTransformOrigin RenderTransformOrigin RenderTransformOrigin

Inherited from UIElement

RenderTransformOriginProperty RenderTransformOriginProperty RenderTransformOriginProperty RenderTransformOriginProperty

Inherited from UIElement

RenderTransformProperty RenderTransformProperty RenderTransformProperty RenderTransformProperty

Inherited from UIElement

RequestedTheme RequestedTheme RequestedTheme RequestedTheme

Inherited from FrameworkElement

RequestedThemeProperty RequestedThemeProperty RequestedThemeProperty RequestedThemeProperty

Inherited from FrameworkElement

RequiresPointer RequiresPointer RequiresPointer RequiresPointer

Inherited from Control

RequiresPointerProperty RequiresPointerProperty RequiresPointerProperty RequiresPointerProperty

Inherited from Control

Resources Resources Resources Resources

Inherited from FrameworkElement

RightTappedEvent RightTappedEvent RightTappedEvent RightTappedEvent

Inherited from UIElement

SelectedIndex SelectedIndex SelectedIndex SelectedIndex

Inherited from Selector

SelectedIndexProperty SelectedIndexProperty SelectedIndexProperty SelectedIndexProperty

Inherited from Selector

SelectedItem SelectedItem SelectedItem SelectedItem

Inherited from Selector

SelectedItemProperty SelectedItemProperty SelectedItemProperty SelectedItemProperty

Inherited from Selector

SelectedValue SelectedValue SelectedValue SelectedValue

Inherited from Selector

SelectedValuePath SelectedValuePath SelectedValuePath SelectedValuePath

Inherited from Selector

SelectedValuePathProperty SelectedValuePathProperty SelectedValuePathProperty SelectedValuePathProperty

Inherited from Selector

SelectedValueProperty SelectedValueProperty SelectedValueProperty SelectedValueProperty

Inherited from Selector

Style Style Style Style

Inherited from FrameworkElement

StyleProperty StyleProperty StyleProperty StyleProperty

Inherited from FrameworkElement

TabFocusNavigation TabFocusNavigation TabFocusNavigation TabFocusNavigation

Inherited from UIElement

TabFocusNavigationProperty TabFocusNavigationProperty TabFocusNavigationProperty TabFocusNavigationProperty

Inherited from UIElement

TabIndex TabIndex TabIndex TabIndex

Inherited from Control

TabIndexProperty TabIndexProperty TabIndexProperty TabIndexProperty

Inherited from Control

TabNavigation TabNavigation TabNavigation TabNavigation

Inherited from Control

TabNavigationProperty TabNavigationProperty TabNavigationProperty TabNavigationProperty

Inherited from Control

Tag Tag Tag Tag

Inherited from FrameworkElement

TagProperty TagProperty TagProperty TagProperty

Inherited from FrameworkElement

TappedEvent TappedEvent TappedEvent TappedEvent

Inherited from UIElement

Template Template Template Template

Inherited from Control

TemplateProperty TemplateProperty TemplateProperty TemplateProperty

Inherited from Control

Transform3D Transform3D Transform3D Transform3D

Inherited from UIElement

Transform3DProperty Transform3DProperty Transform3DProperty Transform3DProperty

Inherited from UIElement

Transitions Transitions Transitions Transitions

Inherited from UIElement

TransitionsProperty TransitionsProperty TransitionsProperty TransitionsProperty

Inherited from UIElement

Triggers Triggers Triggers Triggers

Inherited from FrameworkElement

UseLayoutRounding UseLayoutRounding UseLayoutRounding UseLayoutRounding

Inherited from UIElement

UseLayoutRoundingProperty UseLayoutRoundingProperty UseLayoutRoundingProperty UseLayoutRoundingProperty

Inherited from UIElement

UseSystemFocusVisuals UseSystemFocusVisuals UseSystemFocusVisuals UseSystemFocusVisuals

Inherited from Control

UseSystemFocusVisualsProperty UseSystemFocusVisualsProperty UseSystemFocusVisualsProperty UseSystemFocusVisualsProperty

Inherited from Control

VerticalAlignment VerticalAlignment VerticalAlignment VerticalAlignment

Inherited from FrameworkElement

VerticalAlignmentProperty VerticalAlignmentProperty VerticalAlignmentProperty VerticalAlignmentProperty

Inherited from FrameworkElement

VerticalContentAlignment VerticalContentAlignment VerticalContentAlignment VerticalContentAlignment

Inherited from Control

VerticalContentAlignmentProperty VerticalContentAlignmentProperty VerticalContentAlignmentProperty VerticalContentAlignmentProperty

Inherited from Control

Visibility Visibility Visibility Visibility

Inherited from UIElement

VisibilityProperty VisibilityProperty VisibilityProperty VisibilityProperty

Inherited from UIElement

Width Width Width Width

Inherited from FrameworkElement

WidthProperty WidthProperty WidthProperty WidthProperty

Inherited from FrameworkElement

XYFocusDown XYFocusDown XYFocusDown XYFocusDown

Inherited from Control

XYFocusDownNavigationStrategy XYFocusDownNavigationStrategy XYFocusDownNavigationStrategy XYFocusDownNavigationStrategy

Inherited from UIElement

XYFocusDownNavigationStrategyProperty XYFocusDownNavigationStrategyProperty XYFocusDownNavigationStrategyProperty XYFocusDownNavigationStrategyProperty

Inherited from UIElement

XYFocusDownProperty XYFocusDownProperty XYFocusDownProperty XYFocusDownProperty

Inherited from Control

XYFocusKeyboardNavigation XYFocusKeyboardNavigation XYFocusKeyboardNavigation XYFocusKeyboardNavigation

Inherited from UIElement

XYFocusKeyboardNavigationProperty XYFocusKeyboardNavigationProperty XYFocusKeyboardNavigationProperty XYFocusKeyboardNavigationProperty

Inherited from UIElement

XYFocusLeft XYFocusLeft XYFocusLeft XYFocusLeft

Inherited from Control

XYFocusLeftNavigationStrategy XYFocusLeftNavigationStrategy XYFocusLeftNavigationStrategy XYFocusLeftNavigationStrategy

Inherited from UIElement

XYFocusLeftNavigationStrategyProperty XYFocusLeftNavigationStrategyProperty XYFocusLeftNavigationStrategyProperty XYFocusLeftNavigationStrategyProperty

Inherited from UIElement

XYFocusLeftProperty XYFocusLeftProperty XYFocusLeftProperty XYFocusLeftProperty

Inherited from Control

XYFocusRight XYFocusRight XYFocusRight XYFocusRight

Inherited from Control

XYFocusRightNavigationStrategy XYFocusRightNavigationStrategy XYFocusRightNavigationStrategy XYFocusRightNavigationStrategy

Inherited from UIElement

XYFocusRightNavigationStrategyProperty XYFocusRightNavigationStrategyProperty XYFocusRightNavigationStrategyProperty XYFocusRightNavigationStrategyProperty

Inherited from UIElement

XYFocusRightProperty XYFocusRightProperty XYFocusRightProperty XYFocusRightProperty

Inherited from Control

XYFocusUp XYFocusUp XYFocusUp XYFocusUp

Inherited from Control

XYFocusUpNavigationStrategy XYFocusUpNavigationStrategy XYFocusUpNavigationStrategy XYFocusUpNavigationStrategy

Inherited from UIElement

XYFocusUpNavigationStrategyProperty XYFocusUpNavigationStrategyProperty XYFocusUpNavigationStrategyProperty XYFocusUpNavigationStrategyProperty

Inherited from UIElement

XYFocusUpProperty XYFocusUpProperty XYFocusUpProperty XYFocusUpProperty

Inherited from Control

Methods

CompleteViewChange() CompleteViewChange() CompleteViewChange() CompleteViewChange()

Changes related aspects of presentation when the overall view for a SemanticZoom changes.

public : void CompleteViewChange()
public void CompleteViewChange()
Public Function CompleteViewChange() As void
listViewBase.completeViewChange();

Remarks

Controls derived from ListViewBase typically have an associated ScrollViewer as part of their template. The ListViewBase implementation of CompleteViewChange perpetuates ScrollBarVisibility for any scroll bars across the views when the views change.

See Also

CompleteViewChangeFrom(SemanticZoomLocation, SemanticZoomLocation) CompleteViewChangeFrom(SemanticZoomLocation, SemanticZoomLocation) CompleteViewChangeFrom(SemanticZoomLocation, SemanticZoomLocation) CompleteViewChangeFrom(SemanticZoomLocation, SemanticZoomLocation)

Completes item-wise operations that are related to a view change when the ListViewBase instance is the source view and the new view is a potentially different implementing view.

public : void CompleteViewChangeFrom(SemanticZoomLocation source, SemanticZoomLocation destination)
public void CompleteViewChangeFrom(SemanticZoomLocation source, SemanticZoomLocation destination)
Public Function CompleteViewChangeFrom(source As SemanticZoomLocation, destination As SemanticZoomLocation) As void
listViewBase.completeViewChangeFrom(source, destination);
Parameters
source
SemanticZoomLocation SemanticZoomLocation SemanticZoomLocation SemanticZoomLocation

The view item as represented in the source view.

destination
SemanticZoomLocation SemanticZoomLocation SemanticZoomLocation SemanticZoomLocation

The view item as represented in the destination view.

See Also

CompleteViewChangeTo(SemanticZoomLocation, SemanticZoomLocation) CompleteViewChangeTo(SemanticZoomLocation, SemanticZoomLocation) CompleteViewChangeTo(SemanticZoomLocation, SemanticZoomLocation) CompleteViewChangeTo(SemanticZoomLocation, SemanticZoomLocation)

Completes item-wise operations that are related to a view change when the ListViewBase instance is the destination view and the source view is a potentially different implementing view.

public : void CompleteViewChangeTo(SemanticZoomLocation source, SemanticZoomLocation destination)
public void CompleteViewChangeTo(SemanticZoomLocation source, SemanticZoomLocation destination)
Public Function CompleteViewChangeTo(source As SemanticZoomLocation, destination As SemanticZoomLocation) As void
listViewBase.completeViewChangeTo(source, destination);
Parameters
source
SemanticZoomLocation SemanticZoomLocation SemanticZoomLocation SemanticZoomLocation

The view item as represented in the source view.

destination
SemanticZoomLocation SemanticZoomLocation SemanticZoomLocation SemanticZoomLocation

The view item as represented in the destination view.

See Also

DeselectRange(ItemIndexRange) DeselectRange(ItemIndexRange) DeselectRange(ItemIndexRange) DeselectRange(ItemIndexRange)

Deselects a block of items described by the ItemIndexRange.

public : void DeselectRange(ItemIndexRange itemIndexRange)
public void DeselectRange(ItemIndexRange itemIndexRange)
Public Function DeselectRange(itemIndexRange As ItemIndexRange) As void
listViewBase.deselectRange(itemIndexRange);
Parameters
itemIndexRange
ItemIndexRange ItemIndexRange ItemIndexRange ItemIndexRange

Information about the range of items, including the index of the first and last items in the range, and the number of items.

Examples

Here's how to deselect the first 9 items in a ListView named itemListView.

if (itemListView.SelectionMode == ListViewSelectionMode.Multiple ||
    itemListView.SelectionMode == ListViewSelectionMode.Extended)
{
    itemListView.DeselectRange(new ItemIndexRange(0, 9));
}

Remarks

SelectRange and DeselectRange provide a more efficient way to modify the selection than using the SelectedItems property. When you select items using index ranges, use the SelectedRanges property to get all selected ranges in the list.

When you call DeselectRange, all items in the specified range are deselected, regardless of their original selection state. You can deselect all items in a collection by using an ItemIndexRange with a FirstIndex value of 0 and a Length value equal to the number of items in the collection.

Note

If the ItemsSource implements IItemsRangeInfo, the SelectedItems collection is not updated based on selection in the list. Use the SelectedRanges property instead.

See Also

InitializeViewChange() InitializeViewChange() InitializeViewChange() InitializeViewChange()

Initializes the changes to related aspects of presentation (such as scrolling UI or state) when the overall view for a SemanticZoom is about to change.

public : void InitializeViewChange()
public void InitializeViewChange()
Public Function InitializeViewChange() As void
listViewBase.initializeViewChange();

Remarks

Controls derived from ListViewBase typically have an associated ScrollViewer as part of their template. The ListViewBase implementation of InitializeViewChange stores ScrollBarVisibility for current scroll bars, so that values can be perpetuated across the views when the views change.

See Also

IsDragSource() IsDragSource() IsDragSource() IsDragSource()

Returns a value that indicates whether the list view is both the drag source and drop target in a drag-and-drop operation.

public : Platform::Boolean IsDragSource()
public bool IsDragSource()
Public Function IsDragSource() As bool
var bool = listViewBase.isDragSource();
Returns
Platform::Boolean bool bool bool

true if the list view is both the drag source and drop target; otherwise, false.

Additional features and requirements
Device family
Windows 10 Anniversary Edition (introduced v10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v3)

Remarks

For more info, see Drag and drop.

Version compatibility

The IsDragSource method is not available prior to Windows 10, version 1607. If your app’s 'minimum platform version' setting in Microsoft Visual Studio is less than the 'introduced version' shown in the Requirements block later in this page, you must design and test your app to account for this. For more info, see Version adaptive code.

To avoid exceptions when your app runs on previous versions of Windows 10, do not call this method without first performing a runtime check. This example shows how to use the ApiInformation class to check for the presence of this method before you use it.

if (ApiInformation.IsMethodPresent("Windows.UI.Xaml.Controls.ListViewBase", "IsDragSource"))
{
    bool isDragSource = listView1.IsDragSource();
}

LoadMoreItemsAsync() LoadMoreItemsAsync() LoadMoreItemsAsync() LoadMoreItemsAsync()

Initiates the asynchronous request to load more data items, in accordance with the active incremental loading settings.

public : IAsyncOperation<LoadMoreItemsResult> LoadMoreItemsAsync()
public IAsyncOperation<LoadMoreItemsResult> LoadMoreItemsAsync()
Public Function LoadMoreItemsAsync() As IAsyncOperation( Of LoadMoreItemsResult )
var iAsyncOperation = listViewBase.loadMoreItemsAsync();
Returns
See Also

MakeVisible(SemanticZoomLocation) MakeVisible(SemanticZoomLocation) MakeVisible(SemanticZoomLocation) MakeVisible(SemanticZoomLocation)

Forces content in the view to scroll until the item that's specified by SemanticZoomLocation is visible. Also focuses the item if it finds the item.

public : void MakeVisible(SemanticZoomLocation item)
public void MakeVisible(SemanticZoomLocation item)
Public Function MakeVisible(item As SemanticZoomLocation) As void
listViewBase.makeVisible(item);
Parameters

Remarks

You use the MakeVisible method to bring an item into view when the ListViewBase control is used as a view in a SemanticZoom control. To bring an item into view when the ListViewBase control is not used in a SemanticZoom, use the ScrollIntoView method instead.

See Also

PrepareConnectedAnimation(String, Object, String) PrepareConnectedAnimation(String, Object, String) PrepareConnectedAnimation(String, Object, String) PrepareConnectedAnimation(String, Object, String)

Returns a connected animation that's associated with the specified key, data item, and source element.

public : ConnectedAnimation PrepareConnectedAnimation(Platform::String key, Platform::Object item, Platform::String elementName)
public ConnectedAnimation PrepareConnectedAnimation(String key, Object item, String elementName)
Public Function PrepareConnectedAnimation(key As String, item As Object, elementName As String) As ConnectedAnimation
var connectedAnimation = listViewBase.prepareConnectedAnimation(key, item, elementName);
Parameters
key
Platform::String String String String

The key for the animation.

item
Platform::Object Object Object Object

The data item that is animated out of view.

elementName
Platform::String String String String

The name of the element in the ItemTemplate that provides the animated visual.

Returns
Additional features and requirements
Device family
Windows 10 Creators Update (introduced v10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v4)

ScrollIntoView(Object) ScrollIntoView(Object) ScrollIntoView(Object) ScrollIntoView(Object)

Scrolls the list to bring the specified data item into view.

public : void ScrollIntoView(Platform::Object item)
public void ScrollIntoView(Object item)
Public Function ScrollIntoView(item As Object) As void
listViewBase.scrollIntoView(item);
Parameters
item
Platform::Object Object Object Object

The data item to bring into view.

Remarks

You use the ScrollIntoView method to bring an item into view when the ListViewBase control is not used as a view in a SemanticZoom control. To bring an item into view when the ListViewBase control is used in a SemanticZoom, use the MakeVisible method instead.

When the contents of the ItemsSource collection changes, particularly if many items are added to or removed from the collection, you might need to call UpdateLayout prior to calling ScrollIntoView for the specified item to scroll into the viewport.

See Also

ScrollIntoView(Object, ScrollIntoViewAlignment) ScrollIntoView(Object, ScrollIntoViewAlignment) ScrollIntoView(Object, ScrollIntoViewAlignment) ScrollIntoView(Object, ScrollIntoViewAlignment)

Scrolls the list to bring the specified data item into view with the specified alignment.

public : void ScrollIntoView(Platform::Object item, ScrollIntoViewAlignment alignment)
public void ScrollIntoView(Object item, ScrollIntoViewAlignment alignment)
Public Function ScrollIntoView(item As Object, alignment As ScrollIntoViewAlignment) As void
listViewBase.scrollIntoView(item, alignment);
Parameters
item
Platform::Object Object Object Object

The data item to bring into view.

alignment
ScrollIntoViewAlignment ScrollIntoViewAlignment ScrollIntoViewAlignment ScrollIntoViewAlignment

An enumeration value that specifies whether the item uses Default or Leading alignment.

Remarks

You use the ScrollIntoView method to bring an item into view when the ListViewBase control is not used as a view in a SemanticZoom control. To bring an item into view when the ListViewBase control is used in a SemanticZoom, use the MakeVisible method instead.

When the contents of the ItemsSource collection changes, particularly if many items are added to or removed from the collection, you might need to call UpdateLayout prior to calling ScrollIntoView for the specified item to scroll into the viewport.

See Also

SelectAll() SelectAll() SelectAll() SelectAll()

Selects all the items in a view.

public : void SelectAll()
public void SelectAll()
Public Function SelectAll() As void
listViewBase.selectAll();

Examples

if (itemGridView->SelectionMode == ListViewSelectionMode::Multiple ||
    itemGridView->SelectionMode == ListViewSelectionMode::Extended)
{
    itemGridView->SelectAll();
}
if (itemGridView.SelectionMode == ListViewSelectionMode.Multiple ||
    itemGridView.SelectionMode == ListViewSelectionMode.Extended)
{
    itemGridView.SelectAll();
}
If itemGridView.SelectionMode = ListViewSelectionMode.Multiple OrElse
   itemGridView.SelectionMode = ListViewSelectionMode.Extended Then

   itemGridView.SelectAll()
End If

Remarks

Warning

Call the SelectAll method only when the SelectionMode property is set to Multiple or Extended. If you call SelectAll when the SelectionMode is Single or None, an exception is thrown.

Starting in Windows 10, you can use the SelectRange and DeselectRange methods with the SelectedRanges property to make selections using ranges of indexes. This is a more efficient way to describe item selection than using SelectedItems, which requires the actual item object to be created for each selected item. To select all items using index ranges, use SelectRange.

See Also

SelectRange(ItemIndexRange) SelectRange(ItemIndexRange) SelectRange(ItemIndexRange) SelectRange(ItemIndexRange)

Selects a block of items described by the ItemIndexRange.

public : void SelectRange(ItemIndexRange itemIndexRange)
public void SelectRange(ItemIndexRange itemIndexRange)
Public Function SelectRange(itemIndexRange As ItemIndexRange) As void
listViewBase.selectRange(itemIndexRange);
Parameters
itemIndexRange
ItemIndexRange ItemIndexRange ItemIndexRange ItemIndexRange

Information about the range of items, including the index of the first and last items in the range, and the number of items.

Examples

Here's how to select the first 9 items in a ListView named itemListView.

if (itemListView.SelectionMode == ListViewSelectionMode.Multiple ||
    itemListView.SelectionMode == ListViewSelectionMode.Extended)
{
    itemListView.SelectRange(new ItemIndexRange(0, 9));
}

Remarks

SelectRange and DeselectRange provide a more efficient way to modify the selection than using the SelectedItems property. When you select items using index ranges, use the SelectedRanges property to get all selected ranges in the list.

When you call SelectRange, all items in the specified range are selected, regardless of their original selection state. You can select all items in a collection by using an ItemIndexRange with a FirstIndex value of 0 and a Length value equal to the number of items in the collection.

Warning

Call the SelectRange method only when the SelectionMode property is set to Multiple or Extended. If you call SelectRange when the SelectionMode is Single or None, an exception is thrown.

Note

If the ItemsSource implements IItemsRangeInfo, the SelectedItems collection is not updated based on selection in the list. Use the SelectedRanges property instead.

See Also

SetDesiredContainerUpdateDuration(TimeSpan) SetDesiredContainerUpdateDuration(TimeSpan) SetDesiredContainerUpdateDuration(TimeSpan) SetDesiredContainerUpdateDuration(TimeSpan)

Sets the maximum target time between two render passes when a ListViewBase is updating its UI with data items during initial load or scrolling.

public : void SetDesiredContainerUpdateDuration(TimeSpan duration)
public void SetDesiredContainerUpdateDuration(TimeSpan duration)
Public Function SetDesiredContainerUpdateDuration(duration As TimeSpan) As void
listViewBase.setDesiredContainerUpdateDuration(duration);
Parameters
duration
TimeSpan TimeSpan TimeSpan TimeSpan

The maximum target time between two render passes.

StartViewChangeFrom(SemanticZoomLocation, SemanticZoomLocation) StartViewChangeFrom(SemanticZoomLocation, SemanticZoomLocation) StartViewChangeFrom(SemanticZoomLocation, SemanticZoomLocation) StartViewChangeFrom(SemanticZoomLocation, SemanticZoomLocation)

Initializes item-wise operations that are related to a view change when the ListViewBase instance is the source view and the pending destination view is a potentially different implementing view.

public : void StartViewChangeFrom(SemanticZoomLocation source, SemanticZoomLocation destination)
public void StartViewChangeFrom(SemanticZoomLocation source, SemanticZoomLocation destination)
Public Function StartViewChangeFrom(source As SemanticZoomLocation, destination As SemanticZoomLocation) As void
listViewBase.startViewChangeFrom(source, destination);
Parameters
source
SemanticZoomLocation SemanticZoomLocation SemanticZoomLocation SemanticZoomLocation

The view item as represented in the source view.

destination
SemanticZoomLocation SemanticZoomLocation SemanticZoomLocation SemanticZoomLocation

The view item as represented in the destination view.

See Also

StartViewChangeTo(SemanticZoomLocation, SemanticZoomLocation) StartViewChangeTo(SemanticZoomLocation, SemanticZoomLocation) StartViewChangeTo(SemanticZoomLocation, SemanticZoomLocation) StartViewChangeTo(SemanticZoomLocation, SemanticZoomLocation)

Initializes item-wise operations that are related to a view change when the source view is a different view and the pending destination view is the ListViewBase instance.

public : void StartViewChangeTo(SemanticZoomLocation source, SemanticZoomLocation destination)
public void StartViewChangeTo(SemanticZoomLocation source, SemanticZoomLocation destination)
Public Function StartViewChangeTo(source As SemanticZoomLocation, destination As SemanticZoomLocation) As void
listViewBase.startViewChangeTo(source, destination);
Parameters
source
SemanticZoomLocation SemanticZoomLocation SemanticZoomLocation SemanticZoomLocation

The view item as represented in the source view.

destination
SemanticZoomLocation SemanticZoomLocation SemanticZoomLocation SemanticZoomLocation

The view item as represented in the destination view.

See Also

TryStartConnectedAnimationAsync(ConnectedAnimation, Object, String) TryStartConnectedAnimationAsync(ConnectedAnimation, Object, String) TryStartConnectedAnimationAsync(ConnectedAnimation, Object, String) TryStartConnectedAnimationAsync(ConnectedAnimation, Object, String)

Attempts to start the animation.

public : IAsyncOperation<Platform::Boolean> TryStartConnectedAnimationAsync(ConnectedAnimation animation, Platform::Object item, Platform::String elementName)
public IAsyncOperation<bool> TryStartConnectedAnimationAsync(ConnectedAnimation animation, Object item, String elementName)
Public Function TryStartConnectedAnimationAsync(animation As ConnectedAnimation, item As Object, elementName As String) As IAsyncOperation( Of bool )
var iAsyncOperation = listViewBase.tryStartConnectedAnimationAsync(animation, item, elementName);
Parameters
item
Platform::Object Object Object Object

The data item that is animated into view.

elementName
Platform::String String String String

The name of the element in the ItemTemplate that provides the animated visual.

Returns

true if the animation started; false if the animation has already been started, if it is no longer active, or if the destination element is the same as the source element.

Additional features and requirements
Device family
Windows 10 Creators Update (introduced v10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v4)

AddHandler(RoutedEvent,Object,Boolean) AddHandler(RoutedEvent,Object,Boolean) AddHandler(RoutedEvent,Object,Boolean) AddHandler(RoutedEvent,Object,Boolean)

Inherited from UIElement

ApplyTemplate ApplyTemplate ApplyTemplate ApplyTemplate

Inherited from Control

Arrange(Rect) Arrange(Rect) Arrange(Rect) Arrange(Rect)

Inherited from UIElement

ArrangeOverride(Size) ArrangeOverride(Size) ArrangeOverride(Size) ArrangeOverride(Size)

Inherited from FrameworkElement

CancelDirectManipulations CancelDirectManipulations CancelDirectManipulations CancelDirectManipulations

Inherited from UIElement

CapturePointer(Pointer) CapturePointer(Pointer) CapturePointer(Pointer) CapturePointer(Pointer)

Inherited from UIElement

ClearContainerForItemOverride(DependencyObject,Object) ClearContainerForItemOverride(DependencyObject,Object) ClearContainerForItemOverride(DependencyObject,Object) ClearContainerForItemOverride(DependencyObject,Object)

Inherited from ItemsControl

ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty)

Inherited from DependencyObject

ContainerFromIndex(Int32) ContainerFromIndex(Int32) ContainerFromIndex(Int32) ContainerFromIndex(Int32)

Inherited from ItemsControl

ContainerFromItem(Object) ContainerFromItem(Object) ContainerFromItem(Object) ContainerFromItem(Object)

Inherited from ItemsControl

DeferTree(DependencyObject) DeferTree(DependencyObject) DeferTree(DependencyObject) DeferTree(DependencyObject)

Inherited from FrameworkElement

FindName(String) FindName(String) FindName(String) FindName(String)

Inherited from FrameworkElement

FindSubElementsForTouchTargeting(Point,Rect) FindSubElementsForTouchTargeting(Point,Rect) FindSubElementsForTouchTargeting(Point,Rect) FindSubElementsForTouchTargeting(Point,Rect)

Inherited from UIElement

Focus(FocusState) Focus(FocusState) Focus(FocusState) Focus(FocusState)

Inherited from Control

GetAnimationBaseValue(DependencyProperty) GetAnimationBaseValue(DependencyProperty) GetAnimationBaseValue(DependencyProperty) GetAnimationBaseValue(DependencyProperty)

Inherited from DependencyObject

GetBindingExpression(DependencyProperty) GetBindingExpression(DependencyProperty) GetBindingExpression(DependencyProperty) GetBindingExpression(DependencyProperty)

Inherited from FrameworkElement

GetChildrenInTabFocusOrder GetChildrenInTabFocusOrder GetChildrenInTabFocusOrder GetChildrenInTabFocusOrder

Inherited from UIElement

GetContainerForItemOverride GetContainerForItemOverride GetContainerForItemOverride GetContainerForItemOverride

Inherited from ItemsControl

GetIsSelectionActive(DependencyObject) GetIsSelectionActive(DependencyObject) GetIsSelectionActive(DependencyObject) GetIsSelectionActive(DependencyObject)

Inherited from Selector

GetIsTemplateFocusTarget(FrameworkElement) GetIsTemplateFocusTarget(FrameworkElement) GetIsTemplateFocusTarget(FrameworkElement) GetIsTemplateFocusTarget(FrameworkElement)

Inherited from Control

GetIsTemplateKeyTipTarget(DependencyObject) GetIsTemplateKeyTipTarget(DependencyObject) GetIsTemplateKeyTipTarget(DependencyObject) GetIsTemplateKeyTipTarget(DependencyObject)

Inherited from Control

GetItemsOwner(DependencyObject) GetItemsOwner(DependencyObject) GetItemsOwner(DependencyObject) GetItemsOwner(DependencyObject)

Inherited from ItemsControl

GetTemplateChild(String) GetTemplateChild(String) GetTemplateChild(String) GetTemplateChild(String)

Inherited from Control

GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty)

Inherited from DependencyObject

GoToElementStateCore(String,Boolean) GoToElementStateCore(String,Boolean) GoToElementStateCore(String,Boolean) GoToElementStateCore(String,Boolean)

Inherited from FrameworkElement

GroupHeaderContainerFromItemContainer(DependencyObject) GroupHeaderContainerFromItemContainer(DependencyObject) GroupHeaderContainerFromItemContainer(DependencyObject) GroupHeaderContainerFromItemContainer(DependencyObject)

Inherited from ItemsControl

IndexFromContainer(DependencyObject) IndexFromContainer(DependencyObject) IndexFromContainer(DependencyObject) IndexFromContainer(DependencyObject)

Inherited from ItemsControl

InvalidateArrange InvalidateArrange InvalidateArrange InvalidateArrange

Inherited from UIElement

InvalidateMeasure InvalidateMeasure InvalidateMeasure InvalidateMeasure

Inherited from UIElement

IsItemItsOwnContainerOverride(Object) IsItemItsOwnContainerOverride(Object) IsItemItsOwnContainerOverride(Object) IsItemItsOwnContainerOverride(Object)

Inherited from ItemsControl

ItemFromContainer(DependencyObject) ItemFromContainer(DependencyObject) ItemFromContainer(DependencyObject) ItemFromContainer(DependencyObject)

Inherited from ItemsControl

ItemsControlFromItemContainer(DependencyObject) ItemsControlFromItemContainer(DependencyObject) ItemsControlFromItemContainer(DependencyObject) ItemsControlFromItemContainer(DependencyObject)

Inherited from ItemsControl

Measure(Size) Measure(Size) Measure(Size) Measure(Size)

Inherited from UIElement

MeasureOverride(Size) MeasureOverride(Size) MeasureOverride(Size) MeasureOverride(Size)

Inherited from FrameworkElement

OnApplyTemplate OnApplyTemplate OnApplyTemplate OnApplyTemplate

Inherited from FrameworkElement

OnCharacterReceived(CharacterReceivedRoutedEventArgs) OnCharacterReceived(CharacterReceivedRoutedEventArgs) OnCharacterReceived(CharacterReceivedRoutedEventArgs) OnCharacterReceived(CharacterReceivedRoutedEventArgs)

Inherited from Control

OnCreateAutomationPeer OnCreateAutomationPeer OnCreateAutomationPeer OnCreateAutomationPeer

Inherited from UIElement

OnDisconnectVisualChildren OnDisconnectVisualChildren OnDisconnectVisualChildren OnDisconnectVisualChildren

Inherited from UIElement

OnDoubleTapped(DoubleTappedRoutedEventArgs) OnDoubleTapped(DoubleTappedRoutedEventArgs) OnDoubleTapped(DoubleTappedRoutedEventArgs) OnDoubleTapped(DoubleTappedRoutedEventArgs)

Inherited from Control

OnDragEnter(DragEventArgs) OnDragEnter(DragEventArgs) OnDragEnter(DragEventArgs) OnDragEnter(DragEventArgs)

Inherited from Control

OnDragLeave(DragEventArgs) OnDragLeave(DragEventArgs) OnDragLeave(DragEventArgs) OnDragLeave(DragEventArgs)

Inherited from Control

OnDragOver(DragEventArgs) OnDragOver(DragEventArgs) OnDragOver(DragEventArgs) OnDragOver(DragEventArgs)

Inherited from Control

OnDrop(DragEventArgs) OnDrop(DragEventArgs) OnDrop(DragEventArgs) OnDrop(DragEventArgs)

Inherited from Control

OnGotFocus(RoutedEventArgs) OnGotFocus(RoutedEventArgs) OnGotFocus(RoutedEventArgs) OnGotFocus(RoutedEventArgs)

Inherited from Control

OnGroupStyleSelectorChanged(GroupStyleSelector,GroupStyleSelector) OnGroupStyleSelectorChanged(GroupStyleSelector,GroupStyleSelector) OnGroupStyleSelectorChanged(GroupStyleSelector,GroupStyleSelector) OnGroupStyleSelectorChanged(GroupStyleSelector,GroupStyleSelector)

Inherited from ItemsControl

OnHolding(HoldingRoutedEventArgs) OnHolding(HoldingRoutedEventArgs) OnHolding(HoldingRoutedEventArgs) OnHolding(HoldingRoutedEventArgs)

Inherited from Control

OnItemContainerStyleChanged(Style,Style) OnItemContainerStyleChanged(Style,Style) OnItemContainerStyleChanged(Style,Style) OnItemContainerStyleChanged(Style,Style)

Inherited from ItemsControl

OnItemContainerStyleSelectorChanged(StyleSelector,StyleSelector) OnItemContainerStyleSelectorChanged(StyleSelector,StyleSelector) OnItemContainerStyleSelectorChanged(StyleSelector,StyleSelector) OnItemContainerStyleSelectorChanged(StyleSelector,StyleSelector)

Inherited from ItemsControl

OnItemsChanged(Object) OnItemsChanged(Object) OnItemsChanged(Object) OnItemsChanged(Object)

Inherited from ItemsControl

OnItemTemplateChanged(DataTemplate,DataTemplate) OnItemTemplateChanged(DataTemplate,DataTemplate) OnItemTemplateChanged(DataTemplate,DataTemplate) OnItemTemplateChanged(DataTemplate,DataTemplate)

Inherited from ItemsControl

OnItemTemplateSelectorChanged(DataTemplateSelector,DataTemplateSelector) OnItemTemplateSelectorChanged(DataTemplateSelector,DataTemplateSelector) OnItemTemplateSelectorChanged(DataTemplateSelector,DataTemplateSelector) OnItemTemplateSelectorChanged(DataTemplateSelector,DataTemplateSelector)

Inherited from ItemsControl

OnKeyDown(KeyRoutedEventArgs) OnKeyDown(KeyRoutedEventArgs) OnKeyDown(KeyRoutedEventArgs) OnKeyDown(KeyRoutedEventArgs)

Inherited from Control

OnKeyUp(KeyRoutedEventArgs) OnKeyUp(KeyRoutedEventArgs) OnKeyUp(KeyRoutedEventArgs) OnKeyUp(KeyRoutedEventArgs)

Inherited from Control

OnLostFocus(RoutedEventArgs) OnLostFocus(RoutedEventArgs) OnLostFocus(RoutedEventArgs) OnLostFocus(RoutedEventArgs)

Inherited from Control

OnManipulationCompleted(ManipulationCompletedRoutedEventArgs) OnManipulationCompleted(ManipulationCompletedRoutedEventArgs) OnManipulationCompleted(ManipulationCompletedRoutedEventArgs) OnManipulationCompleted(ManipulationCompletedRoutedEventArgs)

Inherited from Control

OnManipulationDelta(ManipulationDeltaRoutedEventArgs) OnManipulationDelta(ManipulationDeltaRoutedEventArgs) OnManipulationDelta(ManipulationDeltaRoutedEventArgs) OnManipulationDelta(ManipulationDeltaRoutedEventArgs)

Inherited from Control

OnManipulationInertiaStarting(ManipulationInertiaStartingRoutedEventArgs) OnManipulationInertiaStarting(ManipulationInertiaStartingRoutedEventArgs) OnManipulationInertiaStarting(ManipulationInertiaStartingRoutedEventArgs) OnManipulationInertiaStarting(ManipulationInertiaStartingRoutedEventArgs)

Inherited from Control

OnManipulationStarted(ManipulationStartedRoutedEventArgs) OnManipulationStarted(ManipulationStartedRoutedEventArgs) OnManipulationStarted(ManipulationStartedRoutedEventArgs) OnManipulationStarted(ManipulationStartedRoutedEventArgs)

Inherited from Control

OnManipulationStarting(ManipulationStartingRoutedEventArgs) OnManipulationStarting(ManipulationStartingRoutedEventArgs) OnManipulationStarting(ManipulationStartingRoutedEventArgs) OnManipulationStarting(ManipulationStartingRoutedEventArgs)

Inherited from Control

OnPointerCanceled(PointerRoutedEventArgs) OnPointerCanceled(PointerRoutedEventArgs) OnPointerCanceled(PointerRoutedEventArgs) OnPointerCanceled(PointerRoutedEventArgs)

Inherited from Control

OnPointerCaptureLost(PointerRoutedEventArgs) OnPointerCaptureLost(PointerRoutedEventArgs) OnPointerCaptureLost(PointerRoutedEventArgs) OnPointerCaptureLost(PointerRoutedEventArgs)

Inherited from Control

OnPointerEntered(PointerRoutedEventArgs) OnPointerEntered(PointerRoutedEventArgs) OnPointerEntered(PointerRoutedEventArgs) OnPointerEntered(PointerRoutedEventArgs)

Inherited from Control

OnPointerExited(PointerRoutedEventArgs) OnPointerExited(PointerRoutedEventArgs) OnPointerExited(PointerRoutedEventArgs) OnPointerExited(PointerRoutedEventArgs)

Inherited from Control

OnPointerMoved(PointerRoutedEventArgs) OnPointerMoved(PointerRoutedEventArgs) OnPointerMoved(PointerRoutedEventArgs) OnPointerMoved(PointerRoutedEventArgs)

Inherited from Control

OnPointerPressed(PointerRoutedEventArgs) OnPointerPressed(PointerRoutedEventArgs) OnPointerPressed(PointerRoutedEventArgs) OnPointerPressed(PointerRoutedEventArgs)

Inherited from Control

OnPointerReleased(PointerRoutedEventArgs) OnPointerReleased(PointerRoutedEventArgs) OnPointerReleased(PointerRoutedEventArgs) OnPointerReleased(PointerRoutedEventArgs)

Inherited from Control

OnPointerWheelChanged(PointerRoutedEventArgs) OnPointerWheelChanged(PointerRoutedEventArgs) OnPointerWheelChanged(PointerRoutedEventArgs) OnPointerWheelChanged(PointerRoutedEventArgs)

Inherited from Control

OnPreviewKeyDown(KeyRoutedEventArgs) OnPreviewKeyDown(KeyRoutedEventArgs) OnPreviewKeyDown(KeyRoutedEventArgs) OnPreviewKeyDown(KeyRoutedEventArgs)

Inherited from Control

OnPreviewKeyUp(KeyRoutedEventArgs) OnPreviewKeyUp(KeyRoutedEventArgs) OnPreviewKeyUp(KeyRoutedEventArgs) OnPreviewKeyUp(KeyRoutedEventArgs)

Inherited from Control

OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs) OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs) OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs) OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs)

Inherited from UIElement

OnRightTapped(RightTappedRoutedEventArgs) OnRightTapped(RightTappedRoutedEventArgs) OnRightTapped(RightTappedRoutedEventArgs) OnRightTapped(RightTappedRoutedEventArgs)

Inherited from Control

OnTapped(TappedRoutedEventArgs) OnTapped(TappedRoutedEventArgs) OnTapped(TappedRoutedEventArgs) OnTapped(TappedRoutedEventArgs)

Inherited from Control

PrepareContainerForItemOverride(DependencyObject,Object) PrepareContainerForItemOverride(DependencyObject,Object) PrepareContainerForItemOverride(DependencyObject,Object) PrepareContainerForItemOverride(DependencyObject,Object)

Inherited from ItemsControl

ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty)

Inherited from DependencyObject

RegisterPropertyChangedCallback(DependencyProperty,DependencyPropertyChangedCallback) RegisterPropertyChangedCallback(DependencyProperty,DependencyPropertyChangedCallback) RegisterPropertyChangedCallback(DependencyProperty,DependencyPropertyChangedCallback) RegisterPropertyChangedCallback(DependencyProperty,DependencyPropertyChangedCallback)

Inherited from DependencyObject

ReleasePointerCapture(Pointer) ReleasePointerCapture(Pointer) ReleasePointerCapture(Pointer) ReleasePointerCapture(Pointer)

Inherited from UIElement

ReleasePointerCaptures ReleasePointerCaptures ReleasePointerCaptures ReleasePointerCaptures

Inherited from UIElement

RemoveFocusEngagement RemoveFocusEngagement RemoveFocusEngagement RemoveFocusEngagement

Inherited from Control

RemoveHandler(RoutedEvent,Object) RemoveHandler(RoutedEvent,Object) RemoveHandler(RoutedEvent,Object) RemoveHandler(RoutedEvent,Object)

Inherited from UIElement

SetBinding(DependencyProperty,BindingBase) SetBinding(DependencyProperty,BindingBase) SetBinding(DependencyProperty,BindingBase) SetBinding(DependencyProperty,BindingBase)

Inherited from FrameworkElement

SetIsTemplateFocusTarget(FrameworkElement,Boolean) SetIsTemplateFocusTarget(FrameworkElement,Boolean) SetIsTemplateFocusTarget(FrameworkElement,Boolean) SetIsTemplateFocusTarget(FrameworkElement,Boolean)

Inherited from Control

SetIsTemplateKeyTipTarget(DependencyObject,Boolean) SetIsTemplateKeyTipTarget(DependencyObject,Boolean) SetIsTemplateKeyTipTarget(DependencyObject,Boolean) SetIsTemplateKeyTipTarget(DependencyObject,Boolean)

Inherited from Control

SetValue(DependencyProperty,Object) SetValue(DependencyProperty,Object) SetValue(DependencyProperty,Object) SetValue(DependencyProperty,Object)

Inherited from DependencyObject

StartBringIntoView StartBringIntoView StartBringIntoView StartBringIntoView

Inherited from UIElement

StartBringIntoView(BringIntoViewOptions) StartBringIntoView(BringIntoViewOptions) StartBringIntoView(BringIntoViewOptions) StartBringIntoView(BringIntoViewOptions)

Inherited from UIElement

StartDragAsync(PointerPoint) StartDragAsync(PointerPoint) StartDragAsync(PointerPoint) StartDragAsync(PointerPoint)

Inherited from UIElement

TransformToVisual(UIElement) TransformToVisual(UIElement) TransformToVisual(UIElement) TransformToVisual(UIElement)

Inherited from UIElement

TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs) TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs) TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs) TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs)

Inherited from UIElement

TryStartDirectManipulation(Pointer) TryStartDirectManipulation(Pointer) TryStartDirectManipulation(Pointer) TryStartDirectManipulation(Pointer)

Inherited from UIElement

UnregisterPropertyChangedCallback(DependencyProperty,Int64) UnregisterPropertyChangedCallback(DependencyProperty,Int64) UnregisterPropertyChangedCallback(DependencyProperty,Int64) UnregisterPropertyChangedCallback(DependencyProperty,Int64)

Inherited from DependencyObject

UpdateLayout UpdateLayout UpdateLayout UpdateLayout

Inherited from UIElement

Events

ChoosingGroupHeaderContainer ChoosingGroupHeaderContainer ChoosingGroupHeaderContainer ChoosingGroupHeaderContainer

Occurs when an item container is to be chosen for a data group.

public : event TypedEventHandler ChoosingGroupHeaderContainer<ListViewBase,  ChoosingGroupHeaderContainerEventArgs>
public event TypedEventHandler ChoosingGroupHeaderContainer<ListViewBase,  ChoosingGroupHeaderContainerEventArgs>
Public Event TypedEventHandler ChoosingGroupHeaderContainer( Of ( Of ListViewBase ), ( Of  ChoosingGroupHeaderContainerEventArgs ))
function onChoosingGroupHeaderContainer(eventArgs){/* Your code */}


listViewBase.addEventListener("choosingGroupHeaderContainer", onChoosingGroupHeaderContainer);
listViewBase.removeEventListener("choosingGroupHeaderContainer", onChoosingGroupHeaderContainer);

Remarks

You typically handle this event to enable accessibility. The group headers do not have an accessible name set by default. This event provides access to the header instance and lets you to set the AutomationProperties.Name attached property to an appropriate value.

ChoosingItemContainer ChoosingItemContainer ChoosingItemContainer ChoosingItemContainer

Occurs when an item container is to be chosen for a data item.

public : event TypedEventHandler ChoosingItemContainer<ListViewBase,  ChoosingItemContainerEventArgs>
public event TypedEventHandler ChoosingItemContainer<ListViewBase,  ChoosingItemContainerEventArgs>
Public Event TypedEventHandler ChoosingItemContainer( Of ( Of ListViewBase ), ( Of  ChoosingItemContainerEventArgs ))
function onChoosingItemContainer(eventArgs){/* Your code */}


listViewBase.addEventListener("choosingItemContainer", onChoosingItemContainer);
listViewBase.removeEventListener("choosingItemContainer", onChoosingItemContainer);

Remarks

This event is raised only if the list or grid's ItemsPanel is an ItemsStackPanel or ItemsWrapGrid. If you replace the ItemsPanel with another panel, the event is not raised.

ContainerContentChanging ContainerContentChanging ContainerContentChanging ContainerContentChanging

Occurs when the data item associated with a UI container changes.

public : event TypedEventHandler ContainerContentChanging<ListViewBase,  ContainerContentChangingEventArgs>
public event TypedEventHandler ContainerContentChanging<ListViewBase,  ContainerContentChangingEventArgs>
Public Event TypedEventHandler ContainerContentChanging( Of ( Of ListViewBase ), ( Of  ContainerContentChangingEventArgs ))
function onContainerContentChanging(eventArgs){/* Your code */}


listViewBase.addEventListener("containerContentChanging", onContainerContentChanging);
listViewBase.removeEventListener("containerContentChanging", onContainerContentChanging);
<listViewBase ContainerContentChanging="eventhandler" />

Remarks

This event is raised only if the list or grid's ItemsPanel is an ItemsStackPanel or ItemsWrapGrid. If you replace the ItemsPanel with another panel, the event is not raised.

For info and examples, see the Update ListView and GridView items incrementally section of Optimize ListView and GridView.

For more examples, download the XAML GridView grouping and SemanticZoom sample.

See Also

DragItemsCompleted DragItemsCompleted DragItemsCompleted DragItemsCompleted

Occurs when a drag operation that involves one of the items in the view is ended.

public : event TypedEventHandler DragItemsCompleted<ListViewBase,  DragItemsCompletedEventArgs>
public event TypedEventHandler DragItemsCompleted<ListViewBase,  DragItemsCompletedEventArgs>
Public Event TypedEventHandler DragItemsCompleted( Of ( Of ListViewBase ), ( Of  DragItemsCompletedEventArgs ))
function onDragItemsCompleted(eventArgs){/* Your code */}


listViewBase.addEventListener("dragItemsCompleted", onDragItemsCompleted);
listViewBase.removeEventListener("dragItemsCompleted", onDragItemsCompleted);
See Also

DragItemsStarting DragItemsStarting DragItemsStarting DragItemsStarting

Occurs when a drag operation that involves one of the items in the view is initiated.

public : event DragItemsStartingEventHandler DragItemsStarting<>
public event DragItemsStartingEventHandler DragItemsStarting<>
Public Event DragItemsStartingEventHandler DragItemsStarting( Of )
function onDragItemsStarting(eventArgs){/* Your code */}


listViewBase.addEventListener("dragItemsStarting", onDragItemsStarting);
listViewBase.removeEventListener("dragItemsStarting", onDragItemsStarting);
<listViewBase DragItemsStarting="eventhandler" />

Remarks

This event occurs when you start a drag-and-drop operation, including when you perform a reorder operation by drag-and-drop. When you perform custom actions as a result of a drag-and-drop operation, you typically listen to this event and provide more data using the DragItemsStartingEventArgs.Data property.

You can inspect the items being dragged by checking the DragItemsStartingEventArgs.Items property.

You can cancel the drag operation by setting the DragItemsStartingEventArgs.Cancel property to true.

See Also

ItemClick ItemClick ItemClick ItemClick

Occurs when an item in the list view receives an interaction, and the IsItemClickEnabled property is true.

public : event ItemClickEventHandler ItemClick<>
public event ItemClickEventHandler ItemClick<>
Public Event ItemClickEventHandler ItemClick( Of )
function onItemClick(eventArgs){/* Your code */}


listViewBase.addEventListener("itemClick", onItemClick);
listViewBase.removeEventListener("itemClick", onItemClick);
<listViewBase ItemClick="eventhandler" />

Remarks

If the list view is one of the views in a SemanticZoom, selection entails additional behavior that might change between the views. This behavior is built in to the ListViewBase class, not the@Windows.UI.Xaml.Controls.SemanticZoom?text=SemanticZoom class.

See Also

AccessKeyDisplayDismissed AccessKeyDisplayDismissed AccessKeyDisplayDismissed AccessKeyDisplayDismissed

Inherited from UIElement

AccessKeyDisplayRequested AccessKeyDisplayRequested AccessKeyDisplayRequested AccessKeyDisplayRequested

Inherited from UIElement

AccessKeyInvoked AccessKeyInvoked AccessKeyInvoked AccessKeyInvoked

Inherited from UIElement

ActualThemeChanged ActualThemeChanged ActualThemeChanged ActualThemeChanged

Inherited from FrameworkElement

CharacterReceived CharacterReceived CharacterReceived CharacterReceived

Inherited from UIElement

ContextCanceled ContextCanceled ContextCanceled ContextCanceled

Inherited from UIElement

ContextRequested ContextRequested ContextRequested ContextRequested

Inherited from UIElement

DataContextChanged DataContextChanged DataContextChanged DataContextChanged

Inherited from FrameworkElement

DoubleTapped DoubleTapped DoubleTapped DoubleTapped

Inherited from UIElement

DragEnter DragEnter DragEnter DragEnter

Inherited from UIElement

DragLeave DragLeave DragLeave DragLeave

Inherited from UIElement

DragOver DragOver DragOver DragOver

Inherited from UIElement

DragStarting DragStarting DragStarting DragStarting

Inherited from UIElement

Drop Drop Drop Drop

Inherited from UIElement

DropCompleted DropCompleted DropCompleted DropCompleted

Inherited from UIElement

FocusDisengaged FocusDisengaged FocusDisengaged FocusDisengaged

Inherited from Control

FocusEngaged FocusEngaged FocusEngaged FocusEngaged

Inherited from Control

GettingFocus GettingFocus GettingFocus GettingFocus

Inherited from UIElement

GotFocus GotFocus GotFocus GotFocus

Inherited from UIElement

Holding Holding Holding Holding

Inherited from UIElement

IsEnabledChanged IsEnabledChanged IsEnabledChanged IsEnabledChanged

Inherited from Control

KeyDown KeyDown KeyDown KeyDown

Inherited from UIElement

KeyUp KeyUp KeyUp KeyUp

Inherited from UIElement

LayoutUpdated LayoutUpdated LayoutUpdated LayoutUpdated

Inherited from FrameworkElement

Loaded Loaded Loaded Loaded

Inherited from FrameworkElement

Loading Loading Loading Loading

Inherited from FrameworkElement

LosingFocus LosingFocus LosingFocus LosingFocus

Inherited from UIElement

LostFocus LostFocus LostFocus LostFocus

Inherited from UIElement

ManipulationCompleted ManipulationCompleted ManipulationCompleted ManipulationCompleted

Inherited from UIElement

ManipulationDelta ManipulationDelta ManipulationDelta ManipulationDelta

Inherited from UIElement

ManipulationInertiaStarting ManipulationInertiaStarting ManipulationInertiaStarting ManipulationInertiaStarting

Inherited from UIElement

ManipulationStarted ManipulationStarted ManipulationStarted ManipulationStarted

Inherited from UIElement

ManipulationStarting ManipulationStarting ManipulationStarting ManipulationStarting

Inherited from UIElement

NoFocusCandidateFound NoFocusCandidateFound NoFocusCandidateFound NoFocusCandidateFound

Inherited from UIElement

PointerCanceled PointerCanceled PointerCanceled PointerCanceled

Inherited from UIElement

PointerCaptureLost PointerCaptureLost PointerCaptureLost PointerCaptureLost

Inherited from UIElement

PointerEntered PointerEntered PointerEntered PointerEntered

Inherited from UIElement

PointerExited PointerExited PointerExited PointerExited

Inherited from UIElement

PointerMoved PointerMoved PointerMoved PointerMoved

Inherited from UIElement

PointerPressed PointerPressed PointerPressed PointerPressed

Inherited from UIElement

PointerReleased PointerReleased PointerReleased PointerReleased

Inherited from UIElement

PointerWheelChanged PointerWheelChanged PointerWheelChanged PointerWheelChanged

Inherited from UIElement

PreviewKeyDown PreviewKeyDown PreviewKeyDown PreviewKeyDown

Inherited from UIElement

PreviewKeyUp PreviewKeyUp PreviewKeyUp PreviewKeyUp

Inherited from UIElement

ProcessKeyboardAccelerators ProcessKeyboardAccelerators ProcessKeyboardAccelerators ProcessKeyboardAccelerators

Inherited from UIElement

RightTapped RightTapped RightTapped RightTapped

Inherited from UIElement

SelectionChanged SelectionChanged SelectionChanged SelectionChanged

Inherited from Selector

SizeChanged SizeChanged SizeChanged SizeChanged

Inherited from FrameworkElement

Tapped Tapped Tapped Tapped

Inherited from UIElement

Unloaded Unloaded Unloaded Unloaded

Inherited from FrameworkElement

See Also