• Article

FrameworkElementAutomationPeer.CreatePeerForElement Method

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

Creates a FrameworkElementAutomationPeer for the specified UIElement.

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

Syntax

'Declaration
Public Shared Function CreatePeerForElement ( _
    element As UIElement _
) As AutomationPeer

public static AutomationPeer CreatePeerForElement(
    UIElement element
)

Parameters

Exceptions

Exception Condition
ArgumentNullException

element is nulla 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 nulla null reference (Nothing in Visual Basic).

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.