共用方式為


ISelectionProvider2 介面 (uiautomationcore.h)

擴充 ISelectionItemProvider 介面,以提供所選專案的相關信息。

繼承

ISelectionProvider2 介面繼承自 ISelectionProvider 介面。

方法

ISelectionProvider2 介面具有這些方法。

 
ISelectionProvider2::get_CurrentSelectedItem

取得目前選取的專案。
ISelectionProvider2::get_FirstSelectedItem

取得所選項目群組中的第一個專案。
ISelectionProvider2::get_ItemCount

取得選取的項目數目。
ISelectionProvider2::get_LastSelectedItem

取得所選項目群組中的最後一個專案。

備註

此介面是由 Microsoft 使用者介面自動化 提供者所實作。

當容器中的選取專案大幅變更時,提供者應該引發類型 為 UIA_Selection_InvalidatedEventId 的事件。

從清單或 2D 方格中選取時,AT 想要更清楚地閱讀給終端使用者的主要資訊片段。 使用 Excel 作為主要範例,AT 需要 4 個主要資訊,以提供良好的體驗:

  • 選取範圍中的第一個單元格
  • 選取範圍中的最後一個儲存格
  • 選取時目前的專案
  • 總計計數
Excel 電子表格的影像,其中顯示已選取多個單元格。選取範圍會從儲存格 F5 的右上方開始,並在儲存格 D7 的左下角結束。 上圖說明 2D 選取項目的結束狀態:
  • 使用者在 F5 儲存格中啟動 (請注意,這是焦點輸入的保留位置,因為如果您輸入的數據落地)
  • 用戶選取數據行到儲存格 F7
  • 然後,用戶選取左側儲存格 D7

規格需求

需求
最低支援的用戶端 Windows 10 版本 1709 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2016 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 uiautomationcore.h (包含 UIAutomation.h)

另請參閱

ISelectionItemProvider

UI 自動化提供者概觀