IItemContainerGenerator Interface

Microsoft Silverlight will reach end of support after October 2021. Learn more.

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

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

Syntax

'Declaration
Public Interface IItemContainerGenerator
public interface IItemContainerGenerator

The IItemContainerGenerator type exposes the following members.

Methods

  Name Description
Public methodSupported by Silverlight for Windows Phone GenerateNext Returns the container element used to display the next item, and whether the container element has been newly generated (realized).
Public methodSupported by Silverlight for Windows Phone GeneratorPositionFromIndex Returns the GeneratorPosition object that maps to the item at the specified index.
Public methodSupported by Silverlight for Windows Phone GetItemContainerGeneratorForPanel Returns the ItemContainerGenerator appropriate for use by the specified panel.
Public methodSupported by Silverlight for Windows Phone IndexFromGeneratorPosition Returns the index that maps to the specified GeneratorPosition.
Public methodSupported by Silverlight for Windows Phone PrepareItemContainer Prepares the specified element as the container for the corresponding item.
Public methodSupported by Silverlight for Windows Phone Remove Removes one or more generated (realized) items.
Public methodSupported by Silverlight for Windows Phone RemoveAll Removes all generated (realized) items.
Public methodSupported by Silverlight for Windows Phone StartAt 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.

Top

Remarks

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.

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.