Freigeben über

ExpandCollapse-Steuerelementmuster

  • Artikel

Beschreibt Richtlinien und Konventionen für die Implementierung von IExpandCollapseProvider-, einschließlich Informationen zu Eigenschaften, Methoden und Ereignissen. Das ExpandCollapse Steuerelementmusters wird verwendet, um Steuerelemente zu unterstützen, die visuell erweitert werden, um mehr Inhalte anzuzeigen und inhalte auszublenden.

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

Dieses Thema enthält die folgenden Abschnitte.

Implementierungsrichtlinien und -konventionen

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

  • Aggregierte Steuerelemente, die mit untergeordneten Objekten erstellt werden, die der Benutzeroberfläche Funktionen zum Erweitern/Reduzieren bieten, müssen das ExpandCollapse Steuerelementmuster unterstützen, während ihre untergeordneten Elemente nicht. Ein Kombinationsfeld-Steuerelement wird beispielsweise mit einer Kombination aus Listenfeld-, Schaltflächen- und Bearbeitungssteuerelementen erstellt, aber es ist nur das übergeordnete Kombinationsfeld, das das ExpandCollapse Steuerelementmuster unterstützen muss.

    Anmerkung

    Eine Ausnahme ist das Menüsteuerelement, bei dem es sich um ein Aggregat einzelner Menüelementobjekte handelt. Die Menüelementobjekte können das ExpandCollapse Steuerelementmuster unterstützen, das übergeordnete Menüsteuerelement kann jedoch nicht verwendet werden. Eine ähnliche Ausnahme gilt für die Struktur- und Strukturelementsteuerelemente.

     

  • Wenn die IExpandCollapseProvider::ExpandCollapseState eines Steuerelements auf ExpandCollapseState_LeafNodefestgelegt ist, ist jede ExpandCollapse Funktionalität für das Steuerelement derzeit inaktiv und die einzigen Informationen, die mithilfe dieses Steuerelementmusters abgerufen werden können, ist das ExpandCollapseState. Wenn anschließend untergeordnete Objekte hinzugefügt werden, wird die ExpandCollapseState geändert und ExpandCollapse Funktionalität aktiviert.

  • ExpandCollapseState- bezieht sich nur auf die Sichtbarkeit von unmittelbaren untergeordneten Objekten; sie bezieht sich nicht auf die Sichtbarkeit aller untergeordneten Objekte.

  • IExpandCollapseProvider::Expand und Collapse Funktionalität ist steuerelementspezifisch. Im Folgenden sind Beispiele für dieses Verhalten aufgeführt.

    • Das Persönliche Office-Menü kann ein Menüelement mit drei Status ("Erweitert", "Reduziert" und "TeilweiseExpanded") sein, in dem das Steuerelement den Status angibt, der angenommen werden soll, wenn Expand oder Collapse aufgerufen wird.
    • Das Aufrufen von Erweitern für ein Strukturelement kann alle untergeordneten Elemente oder nur direkte untergeordnete Elemente anzeigen.
    • Wenn das Aufrufen von Expand oder Collapse für ein Steuerelement den Status seiner Nachfolger verwaltet, sollte ein Sichtbarkeitsänderungsereignis gesendet werden, kein Zustandsänderungsereignis. Wenn das übergeordnete Steuerelement den Status seiner Nachfolger nicht bei einem Reduzierten behält, zerstört das Steuerelement möglicherweise alle untergeordneten Elemente, die nicht mehr sichtbar sind, und löst ein zerstörtes Ereignis aus. oder es kann die ExpandCollapseState für jedes untergeordnete Element ändern und ein Sichtbarkeitsänderungsereignis auslösen.

  • Um die Navigation zu gewährleisten, ist es wünschenswert, dass sich ein Objekt in der Microsoft-Benutzeroberflächenautomatisierungs-Struktur (mit entsprechendem Sichtbarkeitszustand) befindet, unabhängig von seinen übergeordneten ExpandCollapseState-. Wenn Nachfolger bei Bedarf generiert werden, werden sie möglicherweise erst nach der ersten Anzeige oder nur während der Anzeige in der Benutzeroberflächenautomatisierungsstruktur angezeigt.

Erforderliche Elemente für IExpandCollapseProvider

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

Erforderliche Mitglieder Elementtyp Notizen
ExpandCollapseState- Eigentum Nichts
erweitern Methode Nichts
reduzieren Methode Nichts
IUIAutomationPropertyChangedEventHandler Ereignis Dieses Steuerelement hat keine zugeordneten Ereignisse; verwenden Sie diesen generischen Ereignishandler.

 

Steuerelementtypen und deren unterstützte Steuerelementmuster

Übersicht über Steuerelementmuster für die Benutzeroberflächenautomatisierung

übersicht über Benutzeroberflächenautomatisierungsstruktur