Auswahlsteuerelementmuster

  • Artikel

Beschreibt Richtlinien und Konventionen für die Implementierung von ISelectionProvider, einschließlich Informationen zu Eigenschaften, Methoden und Ereignissen. Das Auswahl-Steuerelementmuster wird verwendet, um Steuerelemente zu unterstützen, die als Container für eine Sammlung auswählbarer untergeordneter Elemente fungieren. Die untergeordneten Elemente dieses Elements müssen ISelectionItemProvider implementieren.

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

Dieses Thema enthält folgende Abschnitte:

Implementierungsrichtlinien und -konventionen

Beachten Sie bei der Implementierung des Selection-Steuerelementmusters die folgenden Richtlinien und Konventionen:

  • Steuerelemente, die ISelectionProvider implementieren, ermöglichen die Auswahl einzelner oder mehrerer untergeordneter Elemente. Beispielsweise unterstützen Listenfelder, Listenansichten und Strukturansichten mehrere Auswahlmöglichkeiten, während Kombinationsfelder, Schieberegler und Optionsfeldgruppen eine einzelne Auswahl unterstützen.

  • Steuerelemente mit einem minimalen, maximalen und kontinuierlichen Bereich, z. B. das Schiebereglersteuerelement Volume eines Media Player, sollten IRangeValueProvider anstelle von ISelectionProvider implementieren.

  • Einzelne Auswahlsteuerelemente, die untergeordnete Steuerelemente verwalten, die IRawElementProviderFragmentRoot implementieren, z. B. der Bildschirmauflösungsschieberegler im Dialogfeld Anzeigeeigenschaften für Windows oder das Auswahlsteuerelement farbauswahl von Microsoft Word (siehe folgende Abbildung), sollten ISelectionProvider implementieren. Ihre untergeordneten Elemente sollten sowohl IRawElementProviderFragment als auchISelectionItemProvider implementieren.

    Abbildung eines Beispiels für die Farbfeldzeichenfolgenzuordnung

  • Menüs unterstützen das Steuerelementmuster Auswahl nicht. Wenn Sie mit Menüelementen arbeiten, die Grafiken und Text enthalten (z. B. die Vorschaubereichselemente im Menü Ansicht in Microsoft Outlook) und den Zustand übermitteln müssen, sollten Sie IToggleProvider implementieren.

Erforderliche Elemente für ISelectionProvider

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

Erforderliche Member Memberart Hinweise
CanSelectMultiple Eigenschaft Keine
IsSelectionRequired Eigenschaft Keine
GetSelection Methode Keine
UIA_Selection_InvalidatedEventId Ereignis Lösen Sie dieses Ereignis aus, wenn sich eine Auswahl in einem Container erheblich geändert hat.

 

Die Eigenschaften ISelectionProvider::IsSelectionRequired und CanSelectMultiple können dynamisch sein. Beispielsweise sind für den Anfangszustand eines Steuerelements möglicherweise standardmäßig keine Elemente ausgewählt, was angibt, dass IsSelectionRequired auf false festgelegt ist. Nach dem Auswählen eines Elements muss für das Steuerelement jedoch immer mindestens ein Element ausgewählt sein. Auf ähnliche Weise kann ein Steuerelement in seltenen Fällen bei der Initialisierung die Mehrfachauswahl von Elementen gestatten, während anschließend nur noch die Einfachauswahl zulässig ist.

Steuerelementtypen und deren unterstützte Steuerelementmuster

SelectionItem-Steuerelementmuster

Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierungs-Struktur