AutomationProperties.LiveSetting attached property
Collapse the table of content
Expand the table of content

AutomationProperties.LiveSetting attached property

Gets or sets the live setting value for the specified element.

<object AutomationProperties.LiveSetting="automationLiveSettingMemberName" />

XAML Values


A constant name from the AutomationLiveSetting enumeration, for example Assertive.


AutomationProperties.LiveSetting is an attached property, which supports a XAML usage. When getting this property in code, use GetLiveSetting. When setting this property in code, use SetLiveSetting. In code usages, the target parameter is the object where the attached property value is set. Another way to get or set the value in code is to use the dependency property system, calling either GetValue or SetValue and passing LiveSettingProperty as the dependency property identifier.

The purpose of AutomationProperties.LiveSetting and the AutomationProperties attached properties is to provide instance values for behavior that are not already present or defined in the control definition or a control's applied generic template.

AutomationProperties.LiveSetting declares the content update notification behavior of an element in the Microsoft UI Automation tree. Specifically, this model of notification behavior reporting is similar to the live region concept that is described in the Accessible Rich Internet Applications (ARIA) specification. If the value of AutomationProperties.LiveSetting is not the default (AutomationLiveSettings.Off), content changes may occur without the element having focus. An example of a live region is a ticker section that lists updating stock quotes.

Requirements (Windows 10 device family)

Device family

API contract




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]





See also




© 2016 Microsoft