Expand Minimize

AutomationPeer.GetAutomationControlTypeCore method

Applies to Windows and Windows Phone

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

Syntax


protected:
virtual AutomationControlType GetAutomationControlTypeCore()

Parameters

This method has no parameters.

Return value

Type: AutomationControlType

The control type.

Remarks

The "Core" methods are the standard implementations that perform the default action of an associated UI Automation client-callable method. You can override any of the "Core" methods to return alternative values in a custom automation peer. In this case, GetAutomationControlTypeCore is invoked any time that GetAutomationControlType is called.

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

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 for Windows Store apps using C#/VB/C++ and XAML

 

 

Show:
© 2014 Microsoft