SelectionItem 控制項模式

描述實作 ISelectionItemProvider的指導方針和慣例,包括屬性、方法和事件的相關資訊。 SelectionItem控制項模式可用來支援做為實作ISelectionProvider之容器控制項的個別可選取子專案。

如需實作此控制項模式的控制項範例,請參閱 控制項類型及其支援的控制項模式

本主題包含下列各節。

實作方針和慣例

實作 SelectionItem 控制項模式時,請注意下列指導方針和慣例:

ISelectionItemProvider的必要成員

實作 ISelectionItemProvider 介面時,需要下列屬性、方法和事件。

必要成員 成員類型 備註
AddToSelection 方法
IsSelected 屬性
RemoveFromSelection 方法
選取 方法
SelectionContainer 屬性
UIA_SelectionItem_ElementAddedToSelectionEventId 事件
UIA_SelectionItem_ElementRemovedFromSelectionEventId 事件
UIA_SelectionItem_ElementSelectedEventId 事件

 

如果 SelectAddToSelectionRemoveFromSelection 的結果是單一選取的專案,應該引發 ElementSelected 事件 (UIA_SelectionItem_ElementSelectedEventId) ;否則,請視需要引發 ElementAddedToSelection (UIA_SelectionItem_ElementAddedToSelectionEventId) ElementRemovedFromSelection ( UIA_SelectionItem_ElementRemovedFromSelectionEventId) 事件。

控制項類型及其支援的控制項模式

UI 自動化控制項模式概觀

UI 自動化樹狀目錄概觀