AutomationProperties.LiveSetting attached property

Applies to Windows and Windows Phone

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


<object AutomationProperties.LiveSetting="automationLiveSettingMemberName" />

XAML Values

automationLiveSettingMemberName

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

Remarks

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

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

Metadata

Windows.winmd

See also

AutomationProperties

 

 

Show:
© 2014 Microsoft