GetAutomationControlTypeCore method
TOC
Collapse the table of content
Expand the table of content

AutomationPeer.GetAutomationControlTypeCore method

Provides the peer's behavior when a Microsoft UI Automation client calls GetAutomationControlType or an equivalent UI Automation client API.

Syntax


Protected Overridable Function GetAutomationControlTypeCore() As AutomationControlType

Parameters

This method has no parameters.

Return value

Type: AutomationControlType

The control type.

Remarks

The base implementation for AutomationPeer and FrameworkElementAutomationPeer return Custom. If you keep this behavior, you must override GetLocalizedControlTypeCore.

The more common scenario for defining an automation peer is overriding one of the existing peer classes that pairs with the control class you are overriding. In this case each such peer class reports a practical value of AutomationControlType that makes sense for the original owner control that the peer was implemented for. Often you can leave this behavior alone. It isn't typical to derive from a control-specific peer and use its behavior but then change the AutomationControlType, which is probably the most basic information that a peer reports. Check the existing behavior of the peer class you are overriding, and verify that you're reporting the correct control type. Also, double-check that there isn't a more specific peer class available that could already be reporting the correct control type as well as providing other behavior that's more appropriate for your peer. For more info, see Custom automation peers.

Requirements (Windows 10 device family)

Device family

Universal, introduced version 10.0.10240.0

API contract

Windows.Foundation.UniversalApiContract, introduced version 1.0

Namespace

Windows.UI.Xaml.Automation.Peers
Windows::UI::Xaml::Automation::Peers [C++]

Metadata

Windows.Foundation.UniversalApiContract.winmd

Requirements (Windows 8.x and Windows Phone 8.x)

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

Windows Phone 8.1 [Windows Runtime apps only]

Namespace

Windows.UI.Xaml.Automation.Peers
Windows::UI::Xaml::Automation::Peers [C++]

Metadata

Windows.winmd

See also

AutomationPeer
FrameworkElementAutomationPeer
Custom automation peers
Accessibility

 

 

Show:
© 2016 Microsoft