SelectionItem-Steuerelementmuster

Beschreibt Richtlinien und Konventionen für die Implementierung von ISelectionItemProvider, einschließlich Informationen zu Eigenschaften, Methoden und Ereignissen. Das SelectionItem-Steuerelementmuster wird verwendet, um Steuerelemente zu unterstützen, die als einzelne, auswählbare untergeordnete Elemente von Containersteuerelementen fungieren, die ISelectionProvider implementieren.

Beispiele für Steuerelemente, die dieses Steuerelementmuster implementieren, finden Sie unter Steuerelementtypen und ihre unterstützten Steuerelementmuster.

Dieses Thema enthält folgende Abschnitte:

• Implementierungsrichtlinien und -konventionen
• Erforderliche Member für ISelectionItemProvider
• Zugehörige Themen

Implementierungsrichtlinien und -konventionen

Beachten Sie beim Implementieren des SelectionItem-Steuerelementmusters die folgenden Richtlinien und Konventionen:

• Steuerelemente mit einmaliger Auswahl, die untergeordnete Steuerelemente verwalten, die IRawElementProviderFragmentRoot implementieren, z. B. der Schieberegler Bildschirmauflösung im Dialogfeld Anzeigeeigenschaften für Windows, sollten ISelectionProvider implementieren. Ihre untergeordneten Elemente sollten sowohl IRawElementProviderFragment als auchISelectionItemProvider implementieren.

Erforderliche Member für ISelectionItemProvider

Die folgenden Eigenschaften, Methoden und Ereignisse sind für die Implementierung der ISelectionItemProvider-Schnittstelle erforderlich.

Erforderliche Member	Memberart	Hinweise
AddToSelection	Methode	Keine
Isselected	Eigenschaft	Keine
RemoveFromSelection	Methode	Keine
Select	Methode	Keine
Selectioncontainer	Eigenschaft	Keine
UIA_SelectionItem_ElementAddedToSelectionEventId	Ereignis	Keine
UIA_SelectionItem_ElementRemovedFromSelectionEventId	Ereignis	Keine
UIA_SelectionItem_ElementSelectedEventId	Ereignis	Keine

 

Wenn das Ergebnis eines Select-Elements, einer AddToSelection oder einer RemoveFromSelection ein einzelnes ausgewähltes Element ist, sollte ein ElementSelected-Ereignis (UIA_SelectionItem_ElementSelectedEventId) ausgelöst werden. andernfalls werden die Ereignisse ElementAddedToSelection (UIA_SelectionItem_ElementAddedToSelectionEventId) oder ElementRemovedFromSelection (UIA_SelectionItem_ElementRemovedFromSelectionEventId) nach Bedarf ausgelöst.

Zugehörige Themen

Steuerelementtypen und ihre unterstützten Steuerelementmuster

Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierungs-Struktur