AutomationProperties.SetHeadingLevel(DependencyObject, AutomationHeadingLevel) Method


Sets the value of the AutomationProperties.HeadingLevel property for the specified DependencyObject.

Equivalent WinUI method: Microsoft.UI.Xaml.Automation.AutomationProperties.SetHeadingLevel.

 static void SetHeadingLevel(DependencyObject ^ element, AutomationHeadingLevel value);
 static void SetHeadingLevel(DependencyObject const & element, AutomationHeadingLevel value);
public static void SetHeadingLevel(DependencyObject element, AutomationHeadingLevel value);
function setHeadingLevel(element, value)
Public Shared Sub SetHeadingLevel (element As DependencyObject, value As AutomationHeadingLevel)



The specified DependencyObject.


The value for the heading level.

Windows 10 requirements

Device family
Windows 10, version 1803 (introduced in 10.0.17134.0)
API contract
Windows.Foundation.UniversalApiContract (introduced in v6.0)


Heading elements organize the user interface and make it easier to navigate. Some assistive technology (AT) allows users to quickly jump between headings. Headings have a level from 1 to 9.

Mouse settings page in Windows Ease of Access settings

Examples of headings would be section titles within the Windows Settings app. For instance, under the Ease of Access -> Mouse page, Pointer size, Pointer color, and Mouse keys would be a heading of level 1.

Applies to

See also