Skip to content

Latest commit

 

History

History
37 lines (21 loc) · 2.4 KB

automationproperties_nameproperty.md

File metadata and controls

37 lines (21 loc) · 2.4 KB
-api-id -api-type
P:Windows.UI.Xaml.Automation.AutomationProperties.NameProperty
winrt property

Windows.UI.Xaml.Automation.AutomationProperties.NameProperty

-description

Identifies the AutomationProperties.Name XAML attached property.

-property-value

The identifier for the AutomationProperties.Name attached property.

-remarks

The Name property should be the same as the label text on screen. For example, Name should be "Browse" for a button element with the label "Browse". The Name property must not include the mnemonic character for the access keys (that is, "&"), which is underlined in the UI text presentation. Also, the Name property should not be an extended or modified version of the on-screen label because the inconsistency between the name and the label can cause confusion among client applications and users.

When the corresponding label text is not visible on screen, or when it is replaced by graphics, alternative text should be chosen. The alternative text should be concise, intuitive, and localized to the application UI language, or to the operating system default UI language. The alternative text should not be a detailed description of the visual details, but a concise description of the UI function or feature as if it were labeled by simple text. For example, the Windows Start menu button is named "Start" (button) instead of "Windows Logo on blue round sphere graphics" (button). For more information, see Creating Text Equivalents for Images.

-property-value

The identifier for the AutomationProperties.Name XAML attached property.

-remarks

-examples

-see-also

AutomationProperties.Name, Attached properties overview