Share via

IUIAutomationElement3：：get_CurrentIsPeripheral 方法 (uiautomationclient.h)

  • 项目

检索元素的当前外围 UI 指示器。

此属性为只读。

语法

HRESULT get_CurrentIsPeripheral(
  BOOL *retVal
);

参数

retVal

返回值

无

备注

当 IsPeripheral 属性为 TRUE 时，客户端应用程序不能假定焦点是由 元素获取的，即使它当前是键盘交互的。

此属性与以下控件类型相关：

  • UIA_GroupControlTypeId
  • UIA_MenuControlTypeId
  • UIA_PaneControlTypeId
  • UIA_ToolBarControlTypeId
  • UIA_ToolTipControlTypeId
  • UIA_WindowControlTypeId
  • UIA_CustomControlTypeId
如果外围 UI 支持其中一种相关模式，则外围 UI 的外观通常会触发以下事件之一：
  • WindowOpened (UIA_Window_WindowOpenedEventId)
  • MenuOpened (UIA_MenuOpenedEventId)
  • ToolTipOpened (UIA_ToolTipOpenedEventId)
当作为辅助技术的客户端应用程序处理其中一个事件时，客户端应检查 CurrentIsPeripheral 的值。 如果值为 TRUE，则客户端可能需要提供用户可通过单个操作访问的外围 UI 的替代表示形式，因为客户端不能使用已更改的焦点作为新 UI 或相关 UI 的指示器。 否则，外围 UI 不会存在于控件视图、选项卡序列等中。 客户端保证在整个树中在任何时候都只存在一个外围 UI 项，打开另一个外围 UI 项会自动关闭第一个。

要求

   
最低受支持的客户端 Windows 8.1 [仅限桌面应用]
最低受支持的服务器 Windows Server 2012 R2 [仅限桌面应用]
目标平台 Windows
标头 uiautomationclient.h (包括 UIAutomation.h)

另请参阅

IUIAutomationElement3

引用