Items​Control​Automation​Peer Items​Control​Automation​Peer Items​Control​Automation​Peer Class

Definition

Exposes ItemsControl types to Microsoft UI Automation.

public class ItemsControlAutomationPeer : FrameworkElementAutomationPeer, IItemsControlAutomationPeer, IItemsControlAutomationPeer2, IItemsControlAutomationPeerOverrides2, IItemContainerProviderpublic class ItemsControlAutomationPeer : FrameworkElementAutomationPeer, IItemsControlAutomationPeer, IItemsControlAutomationPeer2, IItemsControlAutomationPeerOverrides2, IItemContainerProviderPublic Class ItemsControlAutomationPeer Inherits FrameworkElementAutomationPeer Implements IItemsControlAutomationPeer, IItemsControlAutomationPeer2, IItemsControlAutomationPeerOverrides2, IItemContainerProvider
Inheritance
Attributes
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

Windows.UI.Xaml.Automation.Peers.AutomationPeer.RaiseTextEditTextChangedEvent(Windows.UI.Xaml.Automation.AutomationTextEditChangeType,Windows.Foundation.Collections.IVectorView<System.String>)Windows.UI.Xaml.Automation.Peers.AutomationPeer.RaiseTextEditTextChangedEvent(Windows.UI.Xaml.Automation.AutomationTextEditChangeType,Windows.Foundation.Collections.IVectorView<System.String>)Windows.UI.Xaml.Automation.Peers.AutomationPeer.RaiseTextEditTextChangedEvent(Windows.UI.Xaml.Automation.AutomationTextEditChangeType,Windows.Foundation.Collections.IVectorView<System.String>)

Remarks

The Windows Runtime ItemsControl class creates a new ItemsControlAutomationPeer as its OnCreateAutomationPeer definition. Derive your automation peer from ItemsControlAutomationPeer if you are deriving a custom class from ItemsControl and want to add automation support for additional features that you enabled in your custom class. Then override OnCreateAutomationPeer so that it returns your custom peer. Make sure though that there aren't any existing derived classes from ItemsControl that might better suit your scenario. For example, Selector, FlipView, GridView, ComboBox, ListViewBase and ListBox are all a type of ItemsControl. Each of these already has a dedicated automation peer.

Default peer implementation and overrides in ItemsControlAutomationPeer

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

For Windows Phone Store app, ItemsControlAutomationPeer has methods that support creating item-specific automation peers for data items. See CreateItemAutomationPeer and OnCreateItemAutomationPeer.

ItemsControlAutomationPeer derived classes

ItemsControlAutomationPeer is the parent class for SelectorAutomationPeer.

Constructors

ItemsControlAutomationPeer(ItemsControl) ItemsControlAutomationPeer(ItemsControl) ItemsControlAutomationPeer(ItemsControl)

Initializes a new instance of the ItemsControlAutomationPeer class.

public ItemsControlAutomationPeer(ItemsControl owner)public ItemsControlAutomationPeer(ItemsControl owner)Public Sub New(owner As ItemsControl)
Parameters
owner
ItemsControl ItemsControl ItemsControl

The owner element to create for.

Attributes

Methods

CreateItemAutomationPeer(Object) CreateItemAutomationPeer(Object) CreateItemAutomationPeer(Object)

Creates a new instance of the ItemAutomationPeer for a data item in the Items collection of this ItemsControl.

public ItemAutomationPeer CreateItemAutomationPeer(Object item)public ItemAutomationPeer CreateItemAutomationPeer(Object item)Public Function CreateItemAutomationPeer(item As Object) As ItemAutomationPeer
Parameters
item
System.Object System.Object System.Object

The data item that is associated with this ItemAutomationPeer.

Returns
Attributes

FindItemByProperty(IRawElementProviderSimple, AutomationProperty, Object) FindItemByProperty(IRawElementProviderSimple, AutomationProperty, Object) FindItemByProperty(IRawElementProviderSimple, AutomationProperty, Object)

Retrieves an element by the specified property value.

public IRawElementProviderSimple FindItemByProperty(IRawElementProviderSimple startAfter, AutomationProperty automationProperty, Object value)public IRawElementProviderSimple FindItemByProperty(IRawElementProviderSimple startAfter, AutomationProperty automationProperty, Object value)Public Function FindItemByProperty(startAfter As IRawElementProviderSimple, automationProperty As AutomationProperty, value As Object) As IRawElementProviderSimple
Parameters
startAfter
IRawElementProviderSimple IRawElementProviderSimple IRawElementProviderSimple

The item in the container after which to begin the search.

automationProperty
AutomationProperty AutomationProperty AutomationProperty

The property that contains the value to retrieve.

value
System.Object System.Object System.Object

The value to retrieve.

Returns

The first item that matches the search criterion if such an item exists; otherwise, null.

Attributes

OnCreateItemAutomationPeer(Object) OnCreateItemAutomationPeer(Object) OnCreateItemAutomationPeer(Object)

Invoked whenever a new instance of the ItemAutomationPeer is created for a data item in the Items collection of this ItemsControl.

protected virtual ItemAutomationPeer OnCreateItemAutomationPeer(Object item)protected virtual ItemAutomationPeer OnCreateItemAutomationPeer(Object item)Protected Overridable Function OnCreateItemAutomationPeer(item As Object) As ItemAutomationPeer
Parameters
item
System.Object System.Object System.Object

The data item that is associated with this ItemAutomationPeer.

Returns
Attributes

See Also