Export (0) Print
Expand All
Expand Minimize
This topic has not yet been rated - Rate this topic

AutomationPeer.GetNameCore Method

When overridden in a derived class, is called by GetName.

Namespace:  System.Windows.Automation.Peers
Assembly:  System.Windows (in System.Windows.dll)
protected abstract string GetNameCore()

Return Value

Type: System.String
The name.

You can think of this value as a string that UI Automation clients can use to explain or describe the control they are referring to. This property is used by UI Automation clients such as Narrator to tell the user what the control is. For example, a button where the text content is "OK" should return "OK" as its UI Automation Name. A ListBox control that lets users select a color might return "Colors".

Silverlight has default behavior that walks into the automation tree of a control and attempts to find plain text strings in the content, which are then forwarded as the name for UI Automation. However, this behavior is not implemented at this level. For more information, see Silverlight Accessibility Overview or FrameworkElementAutomationPeer.GetNameCore.

As part of general application support for accessibility, make sure that you have a valid UI Automation Name for all controls in the graphical user interface (GUI) so that accessibility tools such as screen readers can refer to each control in a localized manner. In some cases, a UI Automation Name can be composited by the control's peer behavior, but in other cases it is necessary to specify instance values for UI Automation Name by applying the AutomationProperties.Name attached property.

Notes to Inheritors

The initial implementation is empty.

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.