AutomationPeer.InvalidatePeer Method

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Triggers recalculation of the main properties of the AutomationPeer and raises the PropertyChanged notification to the automation client if the properties have changed.

Namespace:  System.Windows.Automation.Peers
Assembly:  System.Windows (in System.Windows.dll)

Syntax

'Declaration
Public Sub InvalidatePeer
public void InvalidatePeer()

Remarks

Examples of main properties include IsEnabled and GetName.

Typically, updates and notifications occur automatically after the layout is updated in Silverlight. (The update occurs in response to the LayoutUpdated event.) However, properties can change even when no rendering changes occur. For example, the visual rendering usually does not change when the values of an element's ItemStatus or Name properties change. Call InvalidatePeer when your code changes properties that do not change the visual state. InvalidatePeer forces re-evaluation of automation properties and raises property change notifications to automation clients.

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

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

Platforms

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