IXRVirtualizingStackPanel::GetIsVirtualizing (Compact 2013)

3/28/2014

This method retrieves a value that specifies whether this control is using virtualization.

Syntax

virtual HRESULT STDMETHODCALLTYPE GetIsVirtualizing(
    __out bool* pIsVirtualizing
) = 0;

Parameters

• pIsVirtualizing
  [out] Pointer to a Boolean value that indicates whether the IXRVirtualizingStackPanel control is using virtualization.

Return Value

Returns an HRESULT that indicates success or failure.

Remarks

Virtualization refers to a technique by which a subset of UI elements is generated from a larger set of data items based on the items that are visible on the screen. Through functionality that is provided by the parent IXRVirtualizingPanel class, IXRVirtualizingStackPanel objects calculate visible items and work with an internal implementation of the ItemContainerGenerator from an IXRItemsControl (such as IXRListBox) to create UI elements only for visible items.

When the VirtualizationMode property is set to XRVirtualizationMode_Recycling (the default), an IXRVirtualizingStackPanel object reuses item containers instead of creating a new one each time. If the IXRVirtualizingStackPanel object cannot recycle item containers, it uses the standard mode of virtualization, XRVirtualizationMode_Standard, in which item containers are created and discarded for each item. However, when an IXRItemsControl object contains many items, the process of creating and discarding item containers in standard virtualization mode can negatively affect performance.

.NET Framework Equivalent

System.Windows.Controls.VirtualizingStackPanel.IsVirtualizingProperty

Requirements

See Also

Reference

IXRVirtualizingStackPanel