FrameworkElementAutomationPeer.CreatePeerForElement Method

This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

Creates a FrameworkElementAutomationPeer for the specified UIElement.

Namespace:  System.Windows.Automation.Peers
Assembly:  System.Windows (in System.Windows.dll)

Syntax

Public Shared Function CreatePeerForElement ( _
    element As UIElement _
) As AutomationPeer
public static AutomationPeer CreatePeerForElement(
    UIElement element
)

Parameters

Return Value

Type: System.Windows.Automation.Peers..::.AutomationPeer
The FrameworkElementAutomationPeer for the specified UIElement.

Exceptions

Exception Condition
ArgumentNullException

element is nullNothingnullptra null reference (Nothing in Visual Basic).

Remarks

This FrameworkElementAutomationPeer remains in memory until the associated UIElement is destroyed.

The same instance of the FrameworkElementAutomationPeer is returned from subsequent calls to this method and to calls to FromElement. The type of the peer is determined by the OnCreateAutomationPeer virtual callback. If UIElement does not implement the callback, no FrameworkElementAutomationPeer is created and this method returns nullNothingnullptra null reference (Nothing in Visual Basic).

Version Information

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Platforms

Windows Phone

See Also

Reference

FrameworkElementAutomationPeer Class

System.Windows.Automation.Peers Namespace