實作 UI 自動化 SelectionItem 控制項模式

注意事項
這份文件適用於想要使用 System.Windows.Automation 命名空間中定義之 Managed UI Automation 類別的 .NET Framework 開發人員。如需 UI Automation 的最新資訊，請參閱 Windows Automation API：使用者介面自動化 (英文)。

本主題將介紹實作 ISelectionItemProvider 的方針和慣例，包括屬性、方法和事件的相關資訊。 其他參考的連結列於概觀的結尾部分。

SelectionItemPattern 控制項模式是用來支援實作 ISelectionProvider 之容器控制項其中做為個別可選取子項目的控制項。 如需實作 SelectionItem 控制項模式的控制項範例，請參閱 UI 自動化用戶端的控制項模式對應

這個主題包含下列章節。

• 實作方針和慣例
• ISelectionItemProvider 的必要成員
• 例外狀況
• 相關主題

實作方針和慣例

實作 Selection Item 控制項模式時，請注意下列方針和慣例：

• 若單一選取控制項有實作 IRawElementProviderFragmentRoot 的子控制項，例如 [顯示內容] 對話方塊中的 [螢幕解析度] 滑桿，則該控制項應實作 ISelectionProvider，而其子項應實作 IRawElementProviderFragment 和 ISelectionItemProvider。

ISelectionItemProvider 的必要成員

實作 ISelectionItemProvider 時需要使用下列屬性、方法和事件。

必要成員	成員類型	備註
CanSelectMultiple	屬性	無
IsSelectionRequired	屬性	無
GetSelection	方法	無
InvalidatedEvent	事件	當容器中的選項大幅變更，需要傳送比 InvalidateLimit 常數所允許更多的 ElementSelectedEvent 和 ElementRemovedFromSelectionEvent 事件時，會引發此事件

• 如果 Select、AddToSelection 或 RemoveFromSelection 的結果是單一選取的項目，則應引發 ElementSelectedEvent，否則應視情況傳送 ElementAddedToSelectionEvent/ ElementRemovedFromSelectionEvent。

例外狀況

提供者必須擲回下列例外狀況。

例外狀況類型	條件
InvalidOperationException	當嘗試下列任一項時： 在 IsSelectionRequiredProperty = true 且已選取項目的單一選取容器上呼叫 RemoveFromSelection。 在 IsSelectionRequiredProperty = true 且只選取一個項目的多重選取容器上呼叫 RemoveFromSelection。 在 CanSelectMultipleProperty = false 且已選取另一個項目的單一選取容器上呼叫 AddToSelection。

請參閱

工作

支援 UI 自動化提供者的控制項模式

使用 UI 自動化中的快取

Fragment Provider Sample

概念

UI 自動化控制項模式概觀

用戶端的 UI 自動化控制項模式

實作 UI 自動化 Selection 控制項模式

UI 自動化樹狀目錄概觀