This documentation is archived and is not being maintained.

IItemContainerGenerator Interface

An interface that is implemented by classes which are responsible for generating user interface (UI) content on behalf of a host.

Namespace:  System.Windows.Controls.Primitives
Assembly:  PresentationFramework (in PresentationFramework.dll)

public interface IItemContainerGenerator

The IItemContainerGenerator type exposes the following members.

Public methodGenerateNext()Returns the container element used to display the next item.
Public methodGenerateNext(Boolean)Returns the container element used to display the next item, and whether the container element has been newly generated (realized).
Public methodGeneratorPositionFromIndexReturns the GeneratorPosition object that maps to the item at the specified index.
Public methodGetItemContainerGeneratorForPanelReturns the ItemContainerGenerator appropriate for use by the specified panel.
Public methodIndexFromGeneratorPositionReturns the index that maps to the specified GeneratorPosition.
Public methodPrepareItemContainerPrepares the specified element as the container for the corresponding item.
Public methodRemoveRemoves one or more generated (realized) items.
Public methodRemoveAllRemoves all generated (realized) items.
Public methodStartAt(GeneratorPosition, GeneratorDirection)Prepares the generator to generate items, starting at the specified GeneratorPosition, and in the specified GeneratorDirection.
Public methodStartAt(GeneratorPosition, GeneratorDirection, Boolean)Prepares the generator to generate items, starting at the specified GeneratorPosition, and in the specified GeneratorDirection, and controlling whether or not to start at a generated (realized) item.

ItemsControl is the base class for containing and displaying one or more data items. ItemContainerGenerator maintains an association between ItemsControl and the list of items that are displayed by ItemsControl. ItemContainerGenerator is also responsible for generating the UI for those items on behalf of ItemsControl. Panel, VirtualizingPanel, and VirtualizingStackPanel also use ItemContainerGenerator for the same reason.

ItemContainerGenerator implements IItemContainerGenerator and is the interface through which each of the mentioned layout elements communicate with ItemContainerGenerator.

.NET Framework

Supported in: 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.