AppBarButtonAutomationPeer 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
向 Microsoft UI 自动化公开 AppBarButton 类型。
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class AppBarButtonAutomationPeer : ButtonAutomationPeer, IExpandCollapseProvider[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class AppBarButtonAutomationPeer : ButtonAutomationPeer, IExpandCollapseProviderPublic Class AppBarButtonAutomationPeer
Inherits ButtonAutomationPeer
Implements IExpandCollapseProvider- 继承
-
Object IInspectable DependencyObject AutomationPeer FrameworkElementAutomationPeer ButtonBaseAutomationPeer ButtonAutomationPeer AppBarButtonAutomationPeer
- 属性
- 实现
注解
Windows 运行时 AppBarButton 类创建新的 AppBarButtonAutomationPeer 作为其 OnCreateAutomationPeer 定义。 如果要从 AppBarButton 派生自定义类，并且想要添加对自定义类中启用的其他功能的自动化支持，请从 AppBarButtonAutomationPeer 派生自动化对等方。 然后重写 OnCreateAutomationPeer ，以便它返回自定义对等方。
AppBarButtonAutomationPeer 中的默认对等实现和替代
AppBarButtonAutomationPeer 具有核心方法的替代，以便关联的 AutomationPeer 方法向 Microsoft UI 自动化客户端提供对等特定的信息。
- GetClassName 返回“AppBarButton”。
- GetName 不使用基于 Content 返回字符串的 ButtonBaseAutomationPeer 行为。 而是查找标签/ LabeledBy 值。 否则，应用中的值应来自 XAML UI 定义中的 AutomationProperties.Name 用法，而不是来自对等方从控件转发的值。 此对等具有基类 ButtonAutomationPeer ，并继承其行为，而不是上面指示的替代。 这包括对 IInvokeProvider 的模式支持，以及请求时返回该模式的 GetPattern 行为， GetAutomationControlType 返回 AutomationControlType.Button。
对等方还具有基 FrameworkElementAutomationPeer 类提供的其他行为。 有关详细信息，请参阅 自定义自动化对等节点的“FrameworkElementAutomationPeer 中的基本实现”部分。
构造函数
| AppBarButtonAutomationPeer(AppBarButton) |
初始化 AppBarButtonAutomationPeer 类的新实例。 |
属性
| Dispatcher |
始终在Windows 应用 SDK应用中返回 |
| DispatcherQueue |
|
| EventsSource |
获取或设置一个 AutomationPeer，它作为来自此 AutomationPeer 的所有事件的源报告给 自动化客户端。 请参阅“备注”。 (继承自 AutomationPeer) |
| ExpandCollapseState |
获取控件的状态（展开或折叠）。 |
| Owner |
获取与此 FrameworkElementAutomationPeer 关联的 UIElement 所有者。 (继承自 FrameworkElementAutomationPeer) |
方法
| ClearValue(DependencyProperty) |
清除依赖属性的本地值。 (继承自 DependencyObject) |
| Collapse() |
隐藏属于控件子代的所有节点、控件或内容。 |
| Expand() |
显示控件的所有子级节点、控件或内容。 |
| GetAcceleratorKey() |
获取与UI 自动化对等方关联的 对象的快捷键组合。 (继承自 AutomationPeer) |
| GetAcceleratorKeyCore() |
提供 Microsoft UI 自动化 客户端调用 GetAcceleratorKey 或等效的 Microsoft UI 自动化 客户端 API 时对等的行为。 (继承自 AutomationPeer) |
| GetAccessKey() |
获取与自动化对等关联的元素的访问密钥。 (继承自 AutomationPeer) |
| GetAccessKeyCore() |
在 Microsoft UI 自动化 客户端调用 GetAccessKey 或等效的 Microsoft UI 自动化 客户端 API 时提供对等行为。 (继承自 AutomationPeer) |
| GetAnimationBaseValue(DependencyProperty) |
返回为依赖属性建立的任何基值，该基值适用于动画未处于活动状态的情况。 (继承自 DependencyObject) |
| GetAnnotations() |
获取对当前自动化对等的 UI 自动化注释列表的引用。 (继承自 AutomationPeer) |
| GetAnnotationsCore() |
在 Microsoft UI 自动化 客户端调用 GetAnnotations 或等效的 Microsoft UI 自动化 客户端 API 时提供对等行为。 (继承自 AutomationPeer) |
| GetAutomationControlType() |
获取与UI 自动化对等方关联的元素的控件类型。 (继承自 AutomationPeer) |
| GetAutomationControlTypeCore() |
在 Microsoft UI 自动化 客户端调用 GetAutomationControlType 或等效的 Microsoft UI 自动化 客户端 API 时提供对等行为。 (继承自 AutomationPeer) |
| GetAutomationId() |
获取与自动化对等方关联的元素的 AutomationId 。 (继承自 AutomationPeer) |
| GetAutomationIdCore() |
在 Microsoft UI 自动化 客户端调用 GetAutomationId 或等效的 Microsoft UI 自动化 客户端 API 时提供对等行为。 (继承自 AutomationPeer) |
| GetBoundingRectangle() |
获取表示与自动化对等关联的元素的屏幕坐标的 Rect 对象。 (继承自 AutomationPeer) |
| GetBoundingRectangleCore() |
在 Microsoft UI 自动化 客户端调用 GetBoundingRectangle 或等效的 Microsoft UI 自动化 客户端 API 时提供对等行为。 (继承自 AutomationPeer) |
| GetChildren() |
获取子元素的集合，这些子元素在UI 自动化树中表示为自动化对等的直接子元素。 (继承自 AutomationPeer) |
| GetChildrenCore() |
在 Microsoft UI 自动化 客户端调用 GetChildren 或等效的 Microsoft UI 自动化 客户端 API 时提供对等行为。 (继承自 AutomationPeer) |
| GetClassName() |
获取与 AutomationControlType 一起使用的名称，以区分由此 AutomationPeer 表示的控件。 (继承自 AutomationPeer) |
| GetClassNameCore() |
在 Microsoft UI 自动化 客户端调用 GetClassName 或等效的 Microsoft UI 自动化 客户端 API 时提供对等行为。 (继承自 AutomationPeer) |
| GetClickablePoint() |
获取元素上的一个点，该点与响应鼠标单击的自动化对等方相关联。 (继承自 AutomationPeer) |
| GetClickablePointCore() |
在 Microsoft UI 自动化 客户端调用 GetClickablePoint 或等效的 Microsoft UI 自动化 客户端 API 时提供对等行为。 (继承自 AutomationPeer) |
| GetControlledPeers() |
在 Microsoft UI 自动化 客户端调用 GetControlledPeers 或等效的 Microsoft UI 自动化 客户端 API（例如获取由 UIA_ControllerForPropertyId 标识的属性值）时提供对等行为。 (继承自 AutomationPeer) |
| GetControlledPeersCore() |
获取当前自动化对等的受控对等的列表。 (继承自 AutomationPeer) |
| GetCulture() |
调用 GetCultureCore 以获取与自动化对等体关联的元素的区域性值。 (继承自 AutomationPeer) |
| GetCultureCore() |
获取与自动化对等方关联的元素的区域性值。 (继承自 AutomationPeer) |
| GetDescribedByCore() |
获取元素的集合，这些元素提供有关自动化元素的详细信息。 (继承自 AutomationPeer) |
| GetElementFromPoint(Point) |
从指定点获取元素。 (继承自 AutomationPeer) |
| GetElementFromPointCore(Point) |
当 Microsoft UI 自动化 客户端调用 GetElementFromPoint 或等效的 Microsoft UI 自动化 客户端 API 时，提供对等行为。 (继承自 AutomationPeer) |
| GetFlowsFromCore() |
在 Microsoft UI 自动化 客户端调用 AutomationProperties.GetFlowsFrom 或等效的 Microsoft UI 自动化 客户端 API 时提供对等行为。 (继承自 AutomationPeer) |
| GetFlowsToCore() |
在 Microsoft UI 自动化 客户端调用 AutomationProperties.GetFlowsTo 或等效的 Microsoft UI 自动化 客户端 API 时提供对等行为。 (继承自 AutomationPeer) |
| GetFocusedElement() |
获取当前具有焦点的元素。 (继承自 AutomationPeer) |
| GetFocusedElementCore() |
在 Microsoft UI 自动化 客户端调用 GetFocusedElement 或等效的 Microsoft UI 自动化 客户端 API 时提供对等行为。 (继承自 AutomationPeer) |
| GetFullDescription() |
获取一个本地化字符串，该字符串描述图像或图像控件等内容的实际视觉外观或内容。 (继承自 AutomationPeer) |
| GetFullDescriptionCore() |
在 Microsoft UI 自动化 客户端调用 GetFullDescription 或等效的 Microsoft UI 自动化 客户端 API 时提供对等行为。 (继承自 AutomationPeer) |
| GetHeadingLevel() |
获取与此自动化对等节点关联的 UI 自动化 元素的标题级别。 (继承自 AutomationPeer) |
| GetHeadingLevelCore() |
在 Microsoft UI 自动化 客户端调用 GetHeadingLevel 或等效的 Microsoft UI 自动化 客户端 API 时提供对等行为。 (继承自 AutomationPeer) |
| GetHelpText() |
获取描述与自动化同级关联的控件的功能的文本。 (继承自 AutomationPeer) |
| GetHelpTextCore() |
在 Microsoft UI 自动化 客户端调用 GetHelpText 或等效的 Microsoft UI 自动化 客户端 API 时提供对等行为。 (继承自 AutomationPeer) |
| GetItemStatus() |
获取可传达与此自动化同级关联的元素的可视状态的文本。 (继承自 AutomationPeer) |
| GetItemStatusCore() |
在 Microsoft UI 自动化 客户端调用 GetItemStatus 或等效的 Microsoft UI 自动化 客户端 API 时提供对等行为。 (继承自 AutomationPeer) |
| GetItemType() |
获取一个字符串，该字符串描述元素表示的项类型。 (继承自 AutomationPeer) |
| GetItemTypeCore() |
在 Microsoft UI 自动化 客户端调用 GetItemType 或等效的 Microsoft UI 自动化 客户端 API 时提供对等行为。 (继承自 AutomationPeer) |
| GetLabeledBy() |
获取面向 元素的 UIElement 的 AutomationPeer。 (继承自 AutomationPeer) |
| GetLabeledByCore() |
在 Microsoft UI 自动化 客户端调用 GetLabeledBy 或等效的 Microsoft UI 自动化 客户端 API 时提供对等行为。 (继承自 AutomationPeer) |
| GetLandmarkType() |
获取此自动化对等的陆标类型。 (继承自 AutomationPeer) |
| GetLandmarkTypeCore() |
在 Microsoft UI 自动化 客户端调用 GetLandmarkType 或等效的 Microsoft UI 自动化 客户端 API 时提供对等行为。 (继承自 AutomationPeer) |
| GetLevel() |
返回与自动化对等关联的元素的级别 (层次结构) 的从 1 开始的整数。 (继承自 AutomationPeer) |
| GetLevelCore() |
在 Microsoft UI 自动化 客户端调用 GetLevel 或等效的 Microsoft UI 自动化 客户端 API 时提供对等行为。 (继承自 AutomationPeer) |
| GetLiveSetting() |
获取与UI 自动化对等方关联的对象的实时设置通知行为信息。 (继承自 AutomationPeer) |
| GetLiveSettingCore() |
在 Microsoft UI 自动化 客户端调用 GetLiveSetting 或等效的 Microsoft UI 自动化 客户端 API 时提供对等行为。 (继承自 AutomationPeer) |
| GetLocalizedControlType() |
获取一个本地化字符串，该字符串表示与此自动化对等关联的控件的 AutomationControlType 值。 (继承自 AutomationPeer) |
| GetLocalizedControlTypeCore() |
在 Microsoft UI 自动化 客户端调用 GetLocalizedControlType 或等效的 Microsoft UI 自动化 客户端 API 时提供对等行为。 (继承自 AutomationPeer) |
| GetLocalizedLandmarkType() |
获取一个本地化字符串，该字符串表示与此自动化对等关联的元素的 AutomationLandmarkType 值。 (继承自 AutomationPeer) |
| GetLocalizedLandmarkTypeCore() |
在 Microsoft UI 自动化 客户端调用 GetLocalizedLandmarkType 或等效的 Microsoft UI 自动化 客户端 API 时提供对等行为。 (继承自 AutomationPeer) |
| GetName() |
获取描述与此自动化同级关联的元素的文本。 Microsoft UI 自动化 Name 值是大多数辅助技术通过与 Microsoft UI 自动化 框架交互来表示应用的 UI 时使用的主要标识符。 (继承自 AutomationPeer) |
| GetNameCore() |
在 Microsoft UI 自动化 客户端调用 GetName 或等效的 Microsoft UI 自动化 客户端 API 时提供对等行为。 (继承自 AutomationPeer) |
| GetOrientation() |
获取指示显式控件方向（如果有）的值。 (继承自 AutomationPeer) |
| GetOrientationCore() |
在 Microsoft UI 自动化 客户端调用 GetOrientation 或等效的 Microsoft UI 自动化 客户端 API 时提供对等行为。 (继承自 AutomationPeer) |
| GetParent() |
获取此 AutomationPeer 的父级的 AutomationPeer。 (继承自 AutomationPeer) |
| GetPattern(PatternInterface) |
获取与指定的 PatternInterface 关联的控件模式。 (继承自 AutomationPeer) |
| GetPatternCore(PatternInterface) |
在 Microsoft UI 自动化 客户端调用 GetPattern 或等效的 Microsoft UI 自动化 客户端 API 时提供对等行为。 (继承自 AutomationPeer) |
| GetPeerFromPoint(Point) |
从指定点获取 AutomationPeer 。 (继承自 AutomationPeer) |
| GetPeerFromPointCore(Point) |
在 Microsoft UI 自动化 客户端调用 GetPeerFromPoint 或等效的 Microsoft UI 自动化 客户端 API 时提供对等行为。 (继承自 AutomationPeer) |
| GetPositionInSet() |
返回与自动化对等关联的元素的集中序号位置的从 1 开始的整数。 (继承自 AutomationPeer) |
| GetPositionInSetCore() |
在 Microsoft UI 自动化 客户端调用 GetPositionInSet 或等效的 Microsoft UI 自动化 客户端 API 时提供对等行为。 (继承自 AutomationPeer) |
| GetSizeOfSet() |
返回与自动化对等关联的元素所在的集大小的从 1 开始的整数。 (继承自 AutomationPeer) |
| GetSizeOfSetCore() |
在 Microsoft UI 自动化 客户端调用 GetSizeOfSet 或等效的 Microsoft UI 自动化 客户端 API 时提供对等行为。 (继承自 AutomationPeer) |
| GetValue(DependencyProperty) |
从 DependencyObject 返回依赖属性的当前有效值。 (继承自 DependencyObject) |
| HasKeyboardFocus() |
获取一个值，该值指示与此自动化同级关联的元素当前是否具有键盘焦点。 (继承自 AutomationPeer) |
| HasKeyboardFocusCore() |
在 Microsoft UI 自动化 客户端调用 HasKeyboardFocus 或等效的 Microsoft UI 自动化 客户端 API 时提供对等行为。 (继承自 AutomationPeer) |
| InvalidatePeer() |
触发对 AutomationPeer main 属性的重新计算，并在属性发生更改时向自动化客户端引发 PropertyChanged 通知。 (继承自 AutomationPeer) |
| Invoke() |
发送请求，以单击与自动化对等方关联的按钮。 (继承自 ButtonAutomationPeer) |
| IsContentElement() |
获取一个值，该值指示与此自动化对等方关联的元素是否包含向用户显示的数据。 (继承自 AutomationPeer) |
| IsContentElementCore() |
在 Microsoft UI 自动化 客户端调用 IsContentElement 或等效的 Microsoft UI 自动化 客户端 API 时提供对等行为。 (继承自 AutomationPeer) |
| IsControlElement() |
获取一个值，该值指示元素是被用户理解为交互式元素，还是作为 GUI 中控件逻辑结构的贡献。 (继承自 AutomationPeer) |
| IsControlElementCore() |
在 Microsoft UI 自动化 客户端调用 IsControlElement 或等效的 Microsoft UI 自动化 客户端 API 时提供对等行为。 (继承自 AutomationPeer) |
| IsDataValidForForm() |
获取一个布尔值，该值指示输入的值或所选值对于与自动化元素关联的表单规则是否有效。 (继承自 AutomationPeer) |
| IsDataValidForFormCore() |
在 Microsoft UI 自动化 客户端访问 IsDataValidForForm 或等效的 Microsoft UI 自动化 客户端 API 时提供对等行为。 (继承自 AutomationPeer) |
| IsDialog() |
获取一个值，该值指示与此自动化对等关联的元素是否为对话框窗口。 (继承自 AutomationPeer) |
| IsDialogCore() |
在 Microsoft UI 自动化 客户端调用 IsDialog 或等效的 Microsoft UI 自动化 客户端 API 时提供对等行为。 (继承自 AutomationPeer) |
| IsEnabled() |
获取一个值，该值指示与此自动化同级关联的元素是否支持交互。 (继承自 AutomationPeer) |
| IsEnabledCore() |
在 Microsoft UI 自动化 客户端调用 IsEnabled 或等效的 Microsoft UI 自动化 客户端 API 时提供对等行为。 (继承自 AutomationPeer) |
| IsKeyboardFocusable() |
获取一个值，该值指示此元素是否可以接受键盘焦点。 (继承自 AutomationPeer) |
| IsKeyboardFocusableCore() |
在 Microsoft UI 自动化 客户端调用 IsKeyboardFocusable 或等效的 Microsoft UI 自动化 客户端 API 时提供对等行为。 (继承自 AutomationPeer) |
| IsOffscreen() |
获取一个值，该值指示元素是否不在屏幕上。 (继承自 AutomationPeer) |
| IsOffscreenCore() |
在 Microsoft UI 自动化 客户端调用 IsOffscreen 或等效的 Microsoft UI 自动化 客户端 API 时提供对等行为。 (继承自 AutomationPeer) |
| IsPassword() |
获取一个值，该值指示元素是否包含敏感内容。 (继承自 AutomationPeer) |
| IsPasswordCore() |
在 Microsoft UI 自动化 客户端调用 IsPassword 或等效的 Microsoft UI 自动化 客户端 API 时提供对等行为。 (继承自 AutomationPeer) |
| IsPeripheral() |
获取一个布尔值，该值指示自动化元素是否表示外围 UI。 (继承自 AutomationPeer) |
| IsPeripheralCore() |
提供 Microsoft UI 自动化 客户端访问 IsPeripheral 或等效的 Microsoft UI 自动化 客户端 API 时对等的行为。 (继承自 AutomationPeer) |
| IsRequiredForForm() |
获取一个值，该值指示是否必须在窗体中完成与此同级关联的元素。 (继承自 AutomationPeer) |
| IsRequiredForFormCore() |
在 Microsoft UI 自动化 客户端调用 IsRequiredForForm 或等效的 Microsoft UI 自动化 客户端 API 时提供对等行为。 (继承自 AutomationPeer) |
| Navigate(AutomationNavigationDirection) |
获取 UI 自动化树中指定方向的元素。 (继承自 AutomationPeer) |
| NavigateCore(AutomationNavigationDirection) |
在 Microsoft UI 自动化 客户端调用 Navigate 或等效的 Microsoft UI 自动化 客户端 API 时提供对等行为。 (继承自 AutomationPeer) |
| PeerFromProvider(IRawElementProviderSimple) |
获取指定 IRawElementProviderSimple 代理的 AutomationPeer。 (继承自 AutomationPeer) |
| ProviderFromPeer(AutomationPeer) |
获取指定 AutomationPeer 的 IRawElementProviderSimple 代理。 (继承自 AutomationPeer) |
| RaiseAutomationEvent(AutomationEvents) |
引发自动化事件。 (继承自 AutomationPeer) |
| RaiseNotificationEvent(AutomationNotificationKind, AutomationNotificationProcessing, String, String) |
启动通知事件。 (继承自 AutomationPeer) |
| RaisePropertyChangedEvent(AutomationProperty, Object, Object) |
引发事件以通知自动化客户端已更改的属性值。 (继承自 AutomationPeer) |
| RaiseStructureChangedEvent(AutomationStructureChangeType, AutomationPeer) |
引发事件以通知 Microsoft UI 自动化核心树结构已更改。 (继承自 AutomationPeer) |
| RaiseTextEditTextChangedEvent(AutomationTextEditChangeType, IVectorView<String>) |
引发事件以通知 Microsoft UI 自动化核心文本控件已以编程方式更改文本。 (继承自 AutomationPeer) |
| ReadLocalValue(DependencyProperty) |
如果设置了本地值，则返回依赖属性的本地值。 (继承自 DependencyObject) |
| RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
注册通知函数，用于侦听此 DependencyObject 实例上对特定 DependencyProperty 的更改。 (继承自 DependencyObject) |
| SetFocus() |
对与此自动化同级关联的元素设置键盘焦点。 (继承自 AutomationPeer) |
| SetFocusCore() |
在 Microsoft UI 自动化 客户端调用 SetFocus 或等效的 Microsoft UI 自动化客户端 API 时提供对等行为。 (继承自 AutomationPeer) |
| SetParent(AutomationPeer) |
设置此 AutomationPeer 的父级 AutomationPeer。 (继承自 AutomationPeer) |
| SetValue(DependencyProperty, Object) |
设置 DependencyObject 上依赖属性的本地值。 (继承自 DependencyObject) |
| ShowContextMenu() |
显示所有者元素的可用上下文菜单。 (继承自 AutomationPeer) |
| ShowContextMenuCore() |
在 Microsoft UI 自动化 客户端调用 ShowContextMenu 或等效的 Microsoft UI 自动化客户端 API 时提供对等方的行为。 (继承自 AutomationPeer) |
| UnregisterPropertyChangedCallback(DependencyProperty, Int64) |
取消以前通过调用 RegisterPropertyChangedCallback 注册的更改通知。 (继承自 DependencyObject) |