Windows.UI.Xaml.Automation.Peers.AppBarToggleButtonAutomationPeer

-description

Exposes AppBarToggleButton types to Microsoft UI Automation.

-remarks

The Windows Runtime AppBarToggleButton class creates a new AppBarToggleButtonAutomationPeer as its OnCreateAutomationPeer definition. Derive your automation peer from AppBarToggleButtonAutomationPeer if you are deriving a custom class from AppBarToggleButton and want to add automation support for additional features that you enabled in your custom class. Then override OnCreateAutomationPeer so that it returns your custom peer.

Default peer implementation and overrides in AppBarToggleButtonAutomationPeer

AppBarToggleButtonAutomationPeer has overrides of Core methods such that the associated AutomationPeer methods provide peer-specific information to a Microsoft UI Automation client.

• GetClassName returns "AppBarToggleButton".
• GetName does not use the ButtonBaseAutomationPeer behavior that returns a string based on Content. Instead, it looks for a label / LabeledBy value. Otherwise, values from apps should come from AutomationProperties.Name usages in XAML UI definitions, not from values forwarded from the control by the peer. This peer has the base class ToggleButtonAutomationPeer and inherits its behavior other than the overrides indicated above. This includes the pattern support for IToggleProvider and the GetPattern behavior that returns that pattern when requested, and GetAutomationControlType returns AutomationControlType.Button. For more info, see ToggleButtonAutomationPeer.

The peer also has other behaviors that are provided by the base FrameworkElementAutomationPeer class. For more info, see "Base implementation in FrameworkElementAutomationPeer" section of Custom automation peers.

-examples

-see-also

ToggleButtonAutomationPeer, IToggleProvider, AppBarToggleButton