Export (0) Print
Expand All

VirtualizingStackPanel.IsVirtualizing Attached Property

Gets or sets a value that indicates that this VirtualizingStackPanel is virtualizing its child collection.

Namespace: System.Windows.Controls
Assembly: PresentationFramework (in PresentationFramework.dll)
XML Namespace:  http://schemas.microsoft.com/winfx/2006/xaml/presentation

See VirtualizingStackPanel.GetIsVirtualizing, VirtualizingStackPanel.SetIsVirtualizing
See VirtualizingStackPanel.GetIsVirtualizing, VirtualizingStackPanel.SetIsVirtualizing
See VirtualizingStackPanel.GetIsVirtualizing, VirtualizingStackPanel.SetIsVirtualizing
<object VirtualizingStackPanel.IsVirtualizing="bool" .../>

Property Value

true if this instance of VirtualizingStackPanel is virtualizing its child collection; otherwise false. The default value is true.

In this context, the word "virtualize" refers to a technique by which a subset of user interface (UI) elements are generated from a larger number of data items based on which items are visible on-screen. Generating a large number of user interface (UI) elements when only a few elements might be on the screen at a given time is intensive with regard to both memory and processor. Through functionality that VirtualizingPanel provides, VirtualizingStackPanel calculates the number of visible items and works with the ItemContainerGenerator from an ItemsControl (such as ListBox or ListView) to create user interface (UI) elements only for visible items.

The following example shows how to bind to an XML data source and virtualize the data source within a ListBox element by using Extensible Application Markup Language (XAML). Notice that the IsVirtualizing attached property is explicitly set to true.

<Page xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
      WindowTitle="VirtualizingStackPanel Sample" 
        <XmlDataProvider x:Key="Leagues" Source="Leagues.xml" XPath="Leagues/League"/>
    <DataTemplate x:Key="NameDataStyle">
      <TextBlock Text="{Binding XPath=@name}" FontFamily="Arial" FontSize="12" Foreground="Black"/>
  <Border HorizontalAlignment="Left" 
      <StackPanel DataContext="{Binding Source={StaticResource Leagues}}">
          <TextBlock Text="{Binding XPath=@name}" FontFamily="Arial" FontSize="18" Foreground="Black"/>
              <ListBox VirtualizingStackPanel.IsVirtualizing="True" 
                       ItemsSource="{Binding XPath=Team}" 
                       ItemTemplate="{DynamicResource NameDataStyle}"/>      

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

Community Additions

© 2014 Microsoft