Item​Automation​Peer Item​Automation​Peer Item​Automation​Peer Class


Exposes a data item in an Items collection to Microsoft UI Automation.

public : class ItemAutomationPeer : AutomationPeer, IItemAutomationPeer, IVirtualizedItemProviderpublic class ItemAutomationPeer : AutomationPeer, IItemAutomationPeer, IVirtualizedItemProviderPublic Class ItemAutomationPeer Inherits AutomationPeer Implements IItemAutomationPeer, IVirtualizedItemProvider
Windows 10 requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

Inherited Members

Inherited methods

Inherited properties


ItemAutomationPeer is generated from items control logic and ItemsControlAutomationPeer, not an associated control class.

In addition to the typical peer implementation API, ItemAutomationPeer has an ItemsControlAutomationPeer property to reference its container peer. The container peer potentially supplies the logic for AutomationPeer methods as called against the ItemAutomationPeer. There is also an Item property that is similar in purpose to the Owner property on other peers (it provides the reference to the object that this peer provides the automation exposure for). Both these values must be set in the ItemAutomationPeer constructor.

ItemAutomationPeer implements the Realize method in order to support the IVirtualizedItemProvider control pattern. Clients can call their framework's equivalent pattern access to Realize to get a non-virtualized result. This generates more information about the item in an automation tree view.

Default peer implementation and overrides in ItemDatAutomationPeer

ItemAutomationPeer has overrides of Core methods such that the associated AutomationPeer methods provide peer-specific information to a Microsoft UI Automation client.

ItemAutomationPeer derived classes

ItemAutomationPeer is the parent class for SelectorItemAutomationPeer.


ItemAutomationPeer(Object, ItemsControlAutomationPeer) ItemAutomationPeer(Object, ItemsControlAutomationPeer) ItemAutomationPeer(Object, ItemsControlAutomationPeer)

Initializes a new instance of the ItemAutomationPeer class.

public : ItemAutomationPeer(PlatForm::Object item, ItemsControlAutomationPeer parent)public ItemAutomationPeer(Object item, ItemsControlAutomationPeer parent)Public Sub New(item As Object, parent As ItemsControlAutomationPeer)
PlatForm::Object Object Object

The specific item to create for.



Item Item Item

Gets the data item in the Items collection that is associated with this ItemAutomationPeer.

public : PlatForm::Object Item { get; }public object Item { get; }Public ReadOnly Property Item As object
PlatForm::Object object object

The data item.



This property is similar in purpose to the Owner property on other peers (it provides the reference to the object that this peer provides the automation exposure for). Its value must be set in the ItemAutomationPeer constructor.

ItemsControlAutomationPeer ItemsControlAutomationPeer ItemsControlAutomationPeer

Gets the ItemsControlAutomationPeer that is associated with the ItemsControl that holds the Items collection.

public : ItemsControlAutomationPeer ItemsControlAutomationPeer { get; }public ItemsControlAutomationPeer ItemsControlAutomationPeer { get; }Public ReadOnly Property ItemsControlAutomationPeer As ItemsControlAutomationPeer


Realize() Realize() Realize()

Makes the virtual item fully accessible as a Microsoft UI Automation element.

public : void Realize()public void Realize()Public Function Realize() As void
See Also

See Also