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
- element
Type: System.Windows..::.UIElement
The UIElement that is associated with this FrameworkElementAutomationPeer.
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