IItemContainerProvider IItemContainerProvider IItemContainerProvider Interface

Exposes a Microsoft UI Automation method to enable applications to find an element in a container, such as a virtualized list. Implement this interface in order to support the capabilities that an automation client requests with a GetPattern(Windows.UI.Xaml.Automation.Peers.PatternInterface) call and PatternInterface.

Syntax

Declaration

public interface IItemContainerProviderpublic interface IItemContainerProviderPublic Interface IItemContainerProvider

Remarks

Controls that contain a large number of child items can use virtualization to efficiently manage the items. With virtualization, the control maintains full information in memory for only a subset of items at any given time. Typically, the subset includes only those items that are currently visible to the user. Full information about the remaining virtualized items is kept in storage and is loaded into memory, or realized, as the control needs it, for example, as new items become visible to the user. A related pattern is IVirtualizedItemProvider. For more info on what this pattern is for, see ItemContainer Control Pattern.

IItemContainerProvider is implemented by the existing Windows Runtime automation peers for various list controls or views, controls that share the base class ItemsControl. Each of these peers inherits from ItemsControlAutomationPeer, and ItemsControlAutomationPeer provides the common FindItemByProperty(Windows.UI.Xaml.Automation.Provider.IRawElementProviderSimple,Windows.UI.Xaml.Automation.AutomationProperty,System.Object) implementation.

The IItemContainerProvider pattern doesn't have a pattern property identifier class, the only API to implement is FindItemByProperty(Windows.UI.Xaml.Automation.Provider.IRawElementProviderSimple,Windows.UI.Xaml.Automation.AutomationProperty,System.Object), a method.

Methods summary

Retrieves an element by the specified property value.

Methods

  • FindItemByProperty(Windows.UI.Xaml.Automation.Provider.IRawElementProviderSimple,Windows.UI.Xaml.Automation.AutomationProperty,System.Object)
    FindItemByProperty(Windows.UI.Xaml.Automation.Provider.IRawElementProviderSimple,Windows.UI.Xaml.Automation.AutomationProperty,System.Object)
    FindItemByProperty(Windows.UI.Xaml.Automation.Provider.IRawElementProviderSimple,Windows.UI.Xaml.Automation.AutomationProperty,System.Object)
    FindItemByProperty(Windows.UI.Xaml.Automation.Provider.IRawElementProviderSimple,Windows.UI.Xaml.Automation.AutomationProperty,System.Object)

    Retrieves an element by the specified property value.

    public IRawElementProviderSimple FindItemByProperty(Windows.UI.Xaml.Automation.Provider.IRawElementProviderSimple startAfter,Windows.UI.Xaml.Automation.AutomationProperty automationProperty,System.Object value)public IRawElementProviderSimple FindItemByProperty(Windows.UI.Xaml.Automation.Provider.IRawElementProviderSimple startAfter,Windows.UI.Xaml.Automation.AutomationProperty automationProperty,System.Object value)Public Function FindItemByProperty(startAfter As Windows.UI.Xaml.Automation.Provider.IRawElementProviderSimple,automationProperty As Windows.UI.Xaml.Automation.AutomationProperty,value As System.Object) As IRawElementProviderSimple

    Parameters

    Returns

Device family

Windows 10 (introduced v10.0.10240.0)

API contract

Windows.Foundation.UniversalApiContract (introduced v1)

Attributes

Windows.Foundation.Metadata.GuidAttribute
Windows.Foundation.Metadata.ContractVersionAttribute
Windows.Foundation.Metadata.WebHostHiddenAttribute

Details

Assembly

Windows.UI.Xaml.Automation.Provider.dll