ListView ListView ListView ListView Class

Definition

public : class ListView : ListViewBase, IListViewpublic class ListView : ListViewBase, IListViewPublic Class ListView Inherits ListViewBase Implements IListView// This API is not available in Javascript.

<ListView .../>
-or-
<ListView ...>
  oneOrMoreItems
</ListView>

Inheritance

DependencyObjectDependencyObjectDependencyObjectDependencyObject

UIElementUIElementUIElementUIElement

FrameworkElementFrameworkElementFrameworkElementFrameworkElement

ControlControlControlControl

ItemsControlItemsControlItemsControlItemsControl

SelectorSelectorSelectorSelector

ListViewBaseListViewBaseListViewBaseListViewBase

ListViewListViewListViewListView

Attributes

ComposableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute WebHostHiddenAttribute

Inherited Members

Inherited properties

Inherited events

Inherited methods

Examples

In this example, the ItemTemplate of a ListView is defined inline. Because the ItemsSource is set, the ItemTemplate is applied to every item.

<ListView x:Name="itemListView"
          Margin="120,0,0,60"
          ItemsSource="{Binding Source={StaticResource itemsViewSource}}"
          SelectionChanged="ItemListView_SelectionChanged">
    <ListView.ItemTemplate>
        <DataTemplate>
            <Grid Height="110" Margin="6">
                <Grid.ColumnDefinitions>
                    <ColumnDefinition Width="Auto"/>
                    <ColumnDefinition Width="*"/>
                </Grid.ColumnDefinitions>
                <Border Background="{StaticResource ListViewItemPlaceholderBackgroundThemeBrush}" Width="110" Height="110">
                    <Image Source="{Binding Image}" Stretch="UniformToFill"/>
                </Border>
                <StackPanel Grid.Column="1" VerticalAlignment="Top" Margin="10,0,0,0">
                    <TextBlock Text="{Binding Title}" Style="{StaticResource TitleTextStyle}" TextWrapping="NoWrap"/>
                    <TextBlock Text="{Binding Subtitle}" Style="{StaticResource CaptionTextStyle}" TextWrapping="NoWrap"/>
                    <TextBlock Text="{Binding Description}" Style="{StaticResource BodyTextStyle}" MaxHeight="60"/>
                </StackPanel>
            </Grid>
        </DataTemplate>
    </ListView.ItemTemplate>          
</ListView>

<ListView>
    <ListView.ItemTemplate>
        <DataTemplate>
            <Grid>
                <Border Background="LightGray" Height="200" Width="200">
                    <TextBlock Text="{Binding}" 
                               FontSize="48" Foreground="Green"/>
                </Border>
            </Grid>
        </DataTemplate>
    </ListView.ItemTemplate>
    <ListView.Items>
        <x:String>One</x:String>
        <ListViewItem>Two</ListViewItem>
    </ListView.Items>
</ListView>

Remarks

Use a ListView to display a collection of items stacked vertically or horizontally. To display a collection in rows and columns, use a GridView.

ListView is an ItemsControl, so it can contain a collection of items of any type. To populate the view, add items to the Items collection, or set the ItemsSource property to a data source.

By default, a data item is displayed in the ListView as the string representation of the data object it's bound to. To specify exactly how items in the ListView are displayed, you create a DataTemplate to define the layout of controls used to display an individual item. The controls in the layout can be bound to properties of a data object, or have content defined inline. You assign the DataTemplate to the ItemTemplate property of the ListView. For common templates you can use in your app, see Item templates for list layouts.

If you use the ListView to display large sets of data, see Optimize ListView and GridView for tips to maintain a smooth and responsive user experience.

Prerelease. Fall Creators Update (Windows 10 Insider Preview Build 16215 and later) - Behavior change

By default, instead of performing selection, an active pen now scrolls/pans a list in UWP apps (like touch, touchpad, and passive pen). If your app depends on the previous behavior, you can override pen scrolling and revert to the previous behavior. See the Scroll​Viewer class reference for details.

By default, a user can select a single item in a ListView. You can set the SelectionMode property to a ListViewSelectionMode enumeration value to allow multi-selection or to disable selection. You can also change the ListView interaction mode to make items respond to a user click like a button instead of being selected.

This table shows the ways a user can interact with a ListView, and how you can respond to the interaction.

ListView supports data virtualization to improve performance with large data sets. Random access virtualization is supported when the data source implements the appropriate interfaces, which vary depending on the programming language:

• Visual C++ component extensions (C++/CX) apps should implement IObservableVector.
• C# or Visual Basic apps should implement INotifyCollectionChanged and System.Collections.IList (not IList). Virtualization requires both of these interfaces. Incremental loading virtualization is supported when the data source implements the ISupportIncrementalLoading interface. When incremental loading is supported, you can use these members to control data loading: DataFetchSize, IncrementalLoadingThreshold, IncrementalLoadingTrigger, LoadMoreItemsAsync.

Windows 8 In Windows 8, when the data item in a selected ListViewItem is replaced, the SelectedIndex value is not cleared. In Windows 8.1, the SelectedIndex value is cleared.

ListView implements the ISemanticZoomInformation interface, so it can be used as a view in a SemanticZoom control. When it's used in a SemanticZoom control, always set the ScrollViewer.IsVerticalScrollChainingEnabled attached property to false on the ScrollViewer that's in the ListView 's control template, like this: <ListView ScrollViewer.IsVerticalScrollChainingEnabled="False">. These members have an effect only when the ListView is hosted in a SemanticZoom control: IsActiveView, IsZoomedInView, SemanticZoomOwner, CompleteViewChange, CompleteViewChangeFrom, CompleteViewChangeTo, InitializeViewChange, MakeVisible, StartViewChangeFrom, StartViewChangeTo.

Selection behavior and CollectionViewSource

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

public : ListView()public ListView()Public Sub New()// This API is not available in Javascript.

See Also

• ListViewBase ListViewBase ListViewBase ListViewBase
• ListView styles and templates
• Data binding overview
• Controls list
• Controls by function
• RSS reader end-to-end (JavaScript) sample (Windows 10)
• ListView and GridView sample (Windows 10)
• Navigation menu (XAML) sample (Windows 10)](http://go.microsoft.com/fwlink/p/?LinkId=619902) (Windows 10)
• Navigation menu (XAML) sample (Windows 10)