共用方式為

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

參考