AppBarAutomationPeer Class
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class AppBarAutomationPeer : FrameworkElementAutomationPeer, IExpandCollapseProvider, IToggleProvider
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class AppBarAutomationPeer : FrameworkElementAutomationPeer, IExpandCollapseProvider, IToggleProvider, IWindowProvider
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class AppBarAutomationPeer : FrameworkElementAutomationPeer, IExpandCollapseProvider, IToggleProvider
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class AppBarAutomationPeer : FrameworkElementAutomationPeer, IExpandCollapseProvider, IToggleProvider, IWindowProvider
Public Class AppBarAutomationPeer
Inherits FrameworkElementAutomationPeer
Implements IExpandCollapseProvider, IToggleProvider
Public Class AppBarAutomationPeer
Inherits FrameworkElementAutomationPeer
Implements IExpandCollapseProvider, IToggleProvider, IWindowProvider
- Inheritance
-
Object IInspectable DependencyObject AutomationPeer FrameworkElementAutomationPeer AppBarAutomationPeer
- Attributes
- Implements
Windows requirements
Device family |
Windows 10 (introduced in 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (introduced in v1.0)
|
Remarks
The Windows Runtime AppBar class creates a new AppBarAutomationPeer as its OnCreateAutomationPeer definition. Derive your automation peer from AppBarAutomationPeer if you are deriving a custom class from AppBar 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 AppBarAutomationPeer
AppBarAutomationPeer has overrides of Core methods such that the associated AutomationPeer methods provide peer-specific information to a Microsoft UI Automation client.
- GetPattern reports that the peer provides pattern support for PatternInterface.Toggle (IToggleProvider).
- ****: GetPattern also reports pattern support for PatternInterface.ExpandCollapse (IExpandCollapseProvider).
- GetClassName returns "ApplicationBar".
- GetAutomationControlType returns AutomationControlType.AppBar.
Note
Windows 8: returns AutomationControlType.Custom
- The peer can fire the PropertyChanged automation event when ToggleState of the peer and owner control changes. 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.
Constructors
AppBarAutomationPeer(AppBar) |
Initializes a new instance of the AppBarAutomationPeer class. |
Properties
Dispatcher |
Gets the CoreDispatcher that this object is associated with. The CoreDispatcher represents a facility that can access the DependencyObject on the UI thread even if the code is initiated by a non-UI thread. (Inherited from DependencyObject) |
EventsSource |
Gets or sets an AutomationPeer that is reported to the automation client as the source for all the events that come from this AutomationPeer. See Remarks. (Inherited from AutomationPeer) |
ExpandCollapseState |
Gets the state, expanded or collapsed, of the control. |
InteractionState |
Gets the interaction state of the app bar, such as running, closing, and so on. |
IsModal |
Gets a Boolean value indicating if the app bar is modal. |
IsTopmost |
Gets a Boolean value indicating if the app bar is the topmost element in the z-order of layout. |
Maximizable |
Gets a Boolean value that indicates whether the app bar can be maximized. |
Minimizable |
Gets a Boolean value that indicates whether the app bar can be minimized. |
Owner |
Gets the UIElement owner that is associated with this FrameworkElementAutomationPeer. (Inherited from FrameworkElementAutomationPeer) |
ToggleState |
Retrieves the toggle state of the owner AppBar. |
VisualState |
Gets the visual state of the app bar. |
Methods
ClearValue(DependencyProperty) |
Clears the local value of a dependency property. (Inherited from DependencyObject) |
Close() |
Closes the app bar. |
Collapse() |
Hides all nodes, controls, or content that are descendants of the control. |
Expand() |
Displays all child nodes, controls, or content of the control. |
GetAcceleratorKey() |
Gets the accelerator key combinations for the object that is associated with the UI Automation peer. (Inherited from AutomationPeer) |
GetAcceleratorKeyCore() |
Provides the peer's behavior when a Microsoft UI Automation client calls GetAcceleratorKey or an equivalent Microsoft UI Automation client API. (Inherited from AutomationPeer) |
GetAccessKey() |
Gets the access key for the element that is associated with the automation peer. (Inherited from AutomationPeer) |
GetAccessKeyCore() |
Provides the peer's behavior when a Microsoft UI Automation client calls GetAccessKey or an equivalent Microsoft UI Automation client API. (Inherited from AutomationPeer) |
GetAnimationBaseValue(DependencyProperty) |
Returns any base value established for a dependency property, which would apply in cases where an animation is not active. (Inherited from DependencyObject) |
GetAnnotations() |
Gets a reference to the list of UI automation annotations for the current automation peer. (Inherited from AutomationPeer) |
GetAnnotationsCore() |
Provides the behavior of the peer when a Microsoft UI Automation client calls GetAnnotations or an equivalent Microsoft UI Automation client API. (Inherited from AutomationPeer) |
GetAutomationControlType() |
Gets the control type for the element that is associated with the UI Automation peer. (Inherited from AutomationPeer) |
GetAutomationControlTypeCore() |
Provides the peer's behavior when a Microsoft UI Automation client calls GetAutomationControlType or an equivalent Microsoft UI Automation client API. (Inherited from AutomationPeer) |
GetAutomationId() |
Gets the AutomationId of the element that is associated with the automation peer. (Inherited from AutomationPeer) |
GetAutomationIdCore() |
Provides the peer's behavior when a Microsoft UI Automation client calls GetAutomationId or an equivalent Microsoft UI Automation client API. (Inherited from AutomationPeer) |
GetBoundingRectangle() |
Gets the Rect object that represents the screen coordinates of the element that is associated with the automation peer. (Inherited from AutomationPeer) |
GetBoundingRectangleCore() |
Provides the peer's behavior when a Microsoft UI Automation client calls GetBoundingRectangle or an equivalent Microsoft UI Automation client API. (Inherited from AutomationPeer) |
GetChildren() |
Gets the collection of child elements that are represented in the UI Automation tree as immediate child elements of the automation peer. (Inherited from AutomationPeer) |
GetChildrenCore() |
Provides the peer's behavior when a Microsoft UI Automation client calls GetChildren or an equivalent Microsoft UI Automation client API. (Inherited from AutomationPeer) |
GetClassName() |
Gets a name that is used with AutomationControlType, to differentiate the control that is represented by this AutomationPeer. (Inherited from AutomationPeer) |
GetClassNameCore() |
Provides the peer's behavior when a Microsoft UI Automation client calls GetClassName or an equivalent Microsoft UI Automation client API. (Inherited from AutomationPeer) |
GetClickablePoint() |
Gets a point on the element that is associated with the automation peer that responds to a mouse click. (Inherited from AutomationPeer) |
GetClickablePointCore() |
Provides the peer's behavior when a Microsoft UI Automation client calls GetClickablePoint or an equivalent Microsoft UI Automation client API. (Inherited from AutomationPeer) |
GetControlledPeers() |
Provides the peer's behavior when a Microsoft UI Automation client calls GetControlledPeers or an equivalent Microsoft UI Automation client API such as getting a property value as identified by UIA_ControllerForPropertyId. (Inherited from AutomationPeer) |
GetControlledPeersCore() |
Gets a list of the controlled peers for the current automation peer. (Inherited from AutomationPeer) |
GetCulture() |
Calls GetCultureCore to get the culture value for the element that is associated with the automation peer. (Inherited from AutomationPeer) |
GetCultureCore() |
Gets the culture value for the element that is associated with the automation peer. (Inherited from AutomationPeer) |
GetDescribedByCore() |
Gets a collection of elements that provide more information about the automation element. (Inherited from AutomationPeer) |
GetElementFromPoint(Point) |
Gets an element from the specified point. (Inherited from AutomationPeer) |
GetElementFromPointCore(Point) |
Provides the behavior of the peer when a Microsoft UI Automation client calls GetElementFromPoint or an equivalent Microsoft UI Automation client API. (Inherited from AutomationPeer) |
GetFlowsFromCore() |
Provides the peer's behavior when a Microsoft UI Automation client calls GetFlowsFrom or an equivalent Microsoft UI Automation client API. (Inherited from AutomationPeer) |
GetFlowsToCore() |
Provides the peer's behavior when a Microsoft UI Automation client calls GetFlowsTo or an equivalent Microsoft UI Automation client API. (Inherited from AutomationPeer) |
GetFocusedElement() |
Gets the element that currently has the focus. (Inherited from AutomationPeer) |
GetFocusedElementCore() |
Provides the behavior of the peer when a Microsoft UI Automation client calls GetFocusedElement or an equivalent Microsoft UI Automation client API. (Inherited from AutomationPeer) |
GetFullDescription() |
Gets a localized string that describes the actual visual appearance or contents of something such as an image or image control. (Inherited from AutomationPeer) |
GetFullDescriptionCore() |
Provides the peer's behavior when a Microsoft UI Automation client calls GetFullDescription or an equivalent Microsoft UI Automation client API. (Inherited from AutomationPeer) |
GetHeadingLevel() |
Gets the heading level of the UI Automation element that is associated with this automation peer. (Inherited from AutomationPeer) |
GetHeadingLevelCore() |
Provides the peer's behavior when a Microsoft UI Automation client calls GetHeadingLevel or an equivalent Microsoft UI Automation client API. (Inherited from AutomationPeer) |
GetHelpText() |
Gets text that describes the functionality of the control that is associated with the automation peer. (Inherited from AutomationPeer) |
GetHelpTextCore() |
Provides the peer's behavior when a Microsoft UI Automation client calls GetHelpText or an equivalent Microsoft UI Automation client API. (Inherited from AutomationPeer) |
GetItemStatus() |
Gets text that conveys the visual status of the element that is associated with this automation peer. (Inherited from AutomationPeer) |
GetItemStatusCore() |
Provides the peer's behavior when a Microsoft UI Automation client calls GetItemStatus or an equivalent Microsoft UI Automation client API. (Inherited from AutomationPeer) |
GetItemType() |
Gets a string that describes what kind of item an element represents. (Inherited from AutomationPeer) |
GetItemTypeCore() |
Provides the peer's behavior when a Microsoft UI Automation client calls GetItemType or an equivalent Microsoft UI Automation client API. (Inherited from AutomationPeer) |
GetLabeledBy() |
Gets the AutomationPeer for the UIElement that is targeted to the element. (Inherited from AutomationPeer) |
GetLabeledByCore() |
Provides the peer's behavior when a Microsoft UI Automation client calls GetLabeledBy or an equivalent Microsoft UI Automation client API. (Inherited from AutomationPeer) |
GetLandmarkType() |
Gets the landmark type for this automation peer. (Inherited from AutomationPeer) |
GetLandmarkTypeCore() |
Provides the peer's behavior when a Microsoft UI Automation client calls GetLandmarkType or an equivalent Microsoft UI Automation client API. (Inherited from AutomationPeer) |
GetLevel() |
Returns the 1-based integer for the level (hierarchy) of the element that is associated with the automation peer. (Inherited from AutomationPeer) |
GetLevelCore() |
Provides the behavior of the peer when a Microsoft UI Automation client calls GetLevel or an equivalent Microsoft UI Automation client API. (Inherited from AutomationPeer) |
GetLiveSetting() |
Gets the live setting notification behavior information for the object that is associated with the UI Automation peer. (Inherited from AutomationPeer) |
GetLiveSettingCore() |
Provides the peer's behavior when a Microsoft UI Automation client calls GetLiveSetting or an equivalent Microsoft UI Automation client API. (Inherited from AutomationPeer) |
GetLocalizedControlType() |
Gets a localized string that represents the AutomationControlType value for the control that is associated with this automation peer. (Inherited from AutomationPeer) |
GetLocalizedControlTypeCore() |
Provides the peer's behavior when a Microsoft UI Automation client calls GetLocalizedControlType or an equivalent Microsoft UI Automation client API. (Inherited from AutomationPeer) |
GetLocalizedLandmarkType() |
Gets a localized string that represents the AutomationLandmarkType value for the element that is associated with this automation peer. (Inherited from AutomationPeer) |
GetLocalizedLandmarkTypeCore() |
Provides the peer's behavior when a Microsoft UI Automation client calls GetLocalizedLandmarkType or an equivalent Microsoft UI Automation client API. (Inherited from AutomationPeer) |
GetName() |
Gets text that describes the element that is associated with this automation peer. The Microsoft UI Automation Name value is the primary identifier used by most assistive technology when they represent your app's UI by interacting with the Microsoft UI Automation framework. (Inherited from AutomationPeer) |
GetNameCore() |
Provides the peer's behavior when a Microsoft UI Automation client calls GetName or an equivalent Microsoft UI Automation client API. (Inherited from AutomationPeer) |
GetOrientation() |
Gets a value that indicates the explicit control orientation, if any. (Inherited from AutomationPeer) |
GetOrientationCore() |
Provides the peer's behavior when a Microsoft UI Automation client calls GetOrientation or an equivalent Microsoft UI Automation client API. (Inherited from AutomationPeer) |
GetParent() |
Gets the AutomationPeer that is the parent of this AutomationPeer. (Inherited from AutomationPeer) |
GetPattern(PatternInterface) |
Gets the control pattern that is associated with the specified PatternInterface. (Inherited from AutomationPeer) |
GetPatternCore(PatternInterface) |
Provides the peer's behavior when a Microsoft UI Automation client calls GetPattern or an equivalent Microsoft UI Automation client API. (Inherited from AutomationPeer) |
GetPeerFromPoint(Point) |
Gets an AutomationPeer from the specified point. (Inherited from AutomationPeer) |
GetPeerFromPointCore(Point) |
Provides the peer's behavior when a Microsoft UI Automation client calls GetPeerFromPoint or an equivalent Microsoft UI Automation client API. (Inherited from AutomationPeer) |
GetPositionInSet() |
Returns the 1-based integer for the ordinal position in the set for the element that is associated with the automation peer. (Inherited from AutomationPeer) |
GetPositionInSetCore() |
Provides the peer’s behavior when a Microsoft UI Automation client calls GetPositionInSet or an equivalent Microsoft UI Automation client API. (Inherited from AutomationPeer) |
GetSizeOfSet() |
Returns the 1-based integer for the size of the set where the element that is associated with the automation peer is located. (Inherited from AutomationPeer) |
GetSizeOfSetCore() |
Provides the peer’s behavior when a Microsoft UI Automation client calls GetSizeOfSet or an equivalent Microsoft UI Automation client API. (Inherited from AutomationPeer) |
GetValue(DependencyProperty) |
Returns the current effective value of a dependency property from a DependencyObject. (Inherited from DependencyObject) |
HasKeyboardFocus() |
Gets a value that indicates whether the element that is associated with this automation peer currently has keyboard focus. (Inherited from AutomationPeer) |
HasKeyboardFocusCore() |
Provides the peer's behavior when a Microsoft UI Automation client calls HasKeyboardFocus or an equivalent Microsoft UI Automation client API. (Inherited from AutomationPeer) |
InvalidatePeer() |
Triggers recalculation of the main properties of the AutomationPeer and raises the PropertyChanged notification to the automation client if the properties have changed. (Inherited from AutomationPeer) |
IsContentElement() |
Gets a value that indicates whether the element that is associated with this automation peer contains data that is presented to the user. (Inherited from AutomationPeer) |
IsContentElementCore() |
Provides the peer's behavior when a Microsoft UI Automation client calls IsContentElement or an equivalent Microsoft UI Automation client API. (Inherited from AutomationPeer) |
IsControlElement() |
Gets a value that indicates whether the element is understood by the user as interactive or as contributing to the logical structure of the control in the GUI. (Inherited from AutomationPeer) |
IsControlElementCore() |
Provides the peer's behavior when a Microsoft UI Automation client calls IsControlElement or an equivalent Microsoft UI Automation client API. (Inherited from AutomationPeer) |
IsDataValidForForm() |
Gets a Boolean value that indicates whether the entered or selected value is valid for the form rule associated with the automation element. (Inherited from AutomationPeer) |
IsDataValidForFormCore() |
Provides the peer’s behavior when a Microsoft UI Automation client accesses IsDataValidForForm or an equivalent Microsoft UI Automation client API. (Inherited from AutomationPeer) |
IsDialog() |
Gets a value that indicates whether the element associated with this automation peer is a dialog window. (Inherited from AutomationPeer) |
IsDialogCore() |
Provides the peer's behavior when a Microsoft UI Automation client calls IsDialog or an equivalent Microsoft UI Automation client API. (Inherited from AutomationPeer) |
IsEnabled() |
Gets a value that indicates whether the element associated with this automation peer supports interaction. (Inherited from AutomationPeer) |
IsEnabledCore() |
Provides the peer's behavior when a Microsoft UI Automation client calls IsEnabled or an equivalent Microsoft UI Automation client API. (Inherited from AutomationPeer) |
IsKeyboardFocusable() |
Gets a value that indicates whether the element can accept keyboard focus. (Inherited from AutomationPeer) |
IsKeyboardFocusableCore() |
Provides the peer's behavior when a Microsoft UI Automation client calls IsKeyboardFocusable or an equivalent Microsoft UI Automation client API. (Inherited from AutomationPeer) |
IsOffscreen() |
Gets a value that indicates whether an element is off the screen. (Inherited from AutomationPeer) |
IsOffscreenCore() |
Provides the peer's behavior when a Microsoft UI Automation client calls IsOffscreen or an equivalent Microsoft UI Automation client API. (Inherited from AutomationPeer) |
IsPassword() |
Gets a value that indicates whether the element contains sensitive content. (Inherited from AutomationPeer) |
IsPasswordCore() |
Provides the peer's behavior when a Microsoft UI Automation client calls IsPassword or an equivalent Microsoft UI Automation client API. (Inherited from AutomationPeer) |
IsPeripheral() |
Gets a Boolean value that indicates whether the automation element represents peripheral UI. (Inherited from AutomationPeer) |
IsPeripheralCore() |
Provides the peer’s behavior when a Microsoft UI Automation client accesses IsPeripheral or an equivalent Microsoft UI Automation client API. (Inherited from AutomationPeer) |
IsRequiredForForm() |
Gets a value that indicates whether the element that is associated with this peer must be completed on a form. (Inherited from AutomationPeer) |
IsRequiredForFormCore() |
Provides the peer's behavior when a Microsoft UI Automation client calls IsRequiredForForm or an equivalent Microsoft UI Automation client API. (Inherited from AutomationPeer) |
Navigate(AutomationNavigationDirection) |
Gets the element in the specified direction within the UI automation tree. (Inherited from AutomationPeer) |
NavigateCore(AutomationNavigationDirection) |
Provides the peer’s behavior when a Microsoft UI Automation client calls Navigate or an equivalent Microsoft UI Automation client API. (Inherited from AutomationPeer) |
PeerFromProvider(IRawElementProviderSimple) |
Gets an AutomationPeer for the specified IRawElementProviderSimple proxy. (Inherited from AutomationPeer) |
ProviderFromPeer(AutomationPeer) |
Gets the IRawElementProviderSimple proxy for the specified AutomationPeer. (Inherited from AutomationPeer) |
RaiseAutomationEvent(AutomationEvents) |
Raises an automation event. (Inherited from AutomationPeer) |
RaiseNotificationEvent(AutomationNotificationKind, AutomationNotificationProcessing, String, String) |
Initiates a notification event. (Inherited from AutomationPeer) |
RaisePropertyChangedEvent(AutomationProperty, Object, Object) |
Raises an event to notify the automation client of a changed property value. (Inherited from AutomationPeer) |
RaiseStructureChangedEvent(AutomationStructureChangeType, AutomationPeer) |
Raises an event to notify the Microsoft UI Automation core that the tree structure has changed. (Inherited from AutomationPeer) |
RaiseTextEditTextChangedEvent(AutomationTextEditChangeType, IVectorView<String>) |
Raises an event to notify the Microsoft UI Automation core that a text control has programmatically changed text. (Inherited from AutomationPeer) |
ReadLocalValue(DependencyProperty) |
Returns the local value of a dependency property, if a local value is set. (Inherited from DependencyObject) |
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
Registers a notification function for listening to changes to a specific DependencyProperty on this DependencyObject instance. (Inherited from DependencyObject) |
SetFocus() |
Sets the keyboard focus on the element that is associated with this automation peer. (Inherited from AutomationPeer) |
SetFocusCore() |
Provides the peer's behavior when a Microsoft UI Automation client calls SetFocus or an equivalent Microsoft UI Automation client API. (Inherited from AutomationPeer) |
SetParent(AutomationPeer) |
Sets the AutomationPeer that is the parent of this AutomationPeer. (Inherited from AutomationPeer) |
SetValue(DependencyProperty, Object) |
Sets the local value of a dependency property on a DependencyObject. (Inherited from DependencyObject) |
SetVisualState(WindowVisualState) |
Changes the visual state of the app bar (such as minimizing or maximizing it). |
ShowContextMenu() |
Shows the available context menu for the owner element. (Inherited from AutomationPeer) |
ShowContextMenuCore() |
Provides the peer's behavior when a Microsoft UI Automation client calls ShowContextMenu or an equivalent Microsoft UI Automation client API. (Inherited from AutomationPeer) |
Toggle() |
Cycles through the toggle states of an AppBarAutomationPeer. |
UnregisterPropertyChangedCallback(DependencyProperty, Int64) |
Cancels a change notification that was previously registered by calling RegisterPropertyChangedCallback. (Inherited from DependencyObject) |
WaitForInputIdle(Int32) |
Blocks the calling code for the specified time or until the associated process enters an idle state, whichever completes first. |
Applies to
See also
الملاحظات
https://aka.ms/ContentUserFeedback.
قريبًا: خلال عام 2024، سنتخلص تدريجيًا من GitHub Issues بوصفها آلية إرسال ملاحظات للمحتوى ونستبدلها بنظام ملاحظات جديد. لمزيد من المعلومات، راجعإرسال الملاحظات وعرضها المتعلقة بـ