Strukturansichtssteuerelement (MSAA UI-Elementreferenz)

Hinweis

In diesem Thema werden Tree View Control-Objekte für die MSAA UI-Elementreferenz beschrieben. Das Erstellen von Strukturansichts-Steuerelementobjekten in verschiedenen Benutzeroberflächenframeworks wird hier nicht beschrieben. Informationen zum verwendeten BENUTZERoberflächenframework finden Sie in der API-Referenzdokumentation.

Ein Strukturansichtssteuerelement zeigt eine hierarchische Liste von Elementen an, die Zeilen verwendet, um verwandte Elemente in einer Hierarchie zu verbinden. Jedes Element besteht aus einer Bezeichnung und einer optionalen Bitmap. Windows Der Explorer verwendet ein Strukturansichtssteuerelement, um Verzeichnisse anzuzeigen.

Der Fensterklassenname für ein Strukturansichtssteuerelement ist WC _ TREEVIEW, das in Commctrl.h als "SysTreeView" definiert ist.

IAccessible-Methoden

Ein Strukturansichtssteuerelement unterstützt die folgenden IAccessible-Methoden:

Methode Kommentare
accDoDefaultAction Das Strukturansichtsobjekt selbst verfügt nicht über eine accDoDefaultAction-Methode. Abhängig von der State-Eigenschaft eines Elements in der Strukturansicht wird das angegebene Element durch accDoDefaultAction entweder erweitert oder reduziert.
accHitTest
accLocation
accNavigate
accSelect

IAccessible-Eigenschaften

Ein Strukturansichtssteuerelement unterstützt die folgenden IAccessible-Eigenschaften:

Eigenschaft Kommentare
get _ accChild
get _ accChildCount Die ChildCount-Eigenschaft für das Strukturansichtsobjekt ist die Anzahl der in der Strukturansicht enthaltenen Elemente. Die ChildCount-Eigenschaft für jedes Strukturansichtselement ist 0 (null).
get _ accDefaultAction Das Strukturansichtsobjekt selbst verfügt nicht über eine DefaultAction-Eigenschaft. Ein Element in der erweiterten Strukturansicht hat "Collapse" als DefaultAction-Eigenschaft, und ein Element, das nicht erweitert ist, hat "Expand" als DefaultAction-Eigenschaft.
get _ accDescription
get _ accFocus
get _ accHelp
get _ accHelpTopic
get _ accKeyboardShortcut
get _ accName Die Name-Eigenschaft für das Strukturansichtsobjekt wird aus dem Fenstertext (oder der Beschriftung) des Steuerelements abgerufen. Dieser Text wird nicht mit dem Strukturansichtssteuerelement angezeigt. Daher müssen Serverentwickler aussagekräftigen Text in der Ressourcendefinitions-Anweisung des Steuerelements bereitstellen, damit Benutzer von Clienthilfsprogrammen das Steuerelement identifizieren können. Die Name-Eigenschaft für ein Element in der Strukturansicht ist der Text, der im Strukturansichtselement angezeigt wird.
get _ accParent Die Parent-Eigenschaft des Strukturansichtsobjekts ist ein Fenster ( ROLE SYSTEM _ _ WINDOW ), das das Steuerelement umschließt und über die gleiche Name-Eigenschaft und den gleichen Fensterklassennamen wie das Steuerelement verfügt. Die Parent-Eigenschaft jedes Elements in der Strukturansicht ist das Strukturansichtsobjekt.
get _ accRole Das Strukturansichtsobjekt verfügt über die Role-Eigenschaft ROLE SYSTEM _ _ OUTLINE. Jedes Element in der Strukturansicht verfügt über die Role-Eigenschaft ROLE SYSTEM _ _ OUTLINEITEM.
get _ accSelection
get _ accState Die State-Eigenschaft für die Strukturansicht ist eine Kombination aus mindestens einem der folgenden Werte: STATE SYSTEM _ _ INVISIBLE | STATE SYSTEM _ _ UNAVAILABLE | STATE SYSTEM _ _ FOCUSED | STATE SYSTEM _ _ FOCUSABLE
Für die Strukturansichtselemente enthält die State-Eigenschaft entweder STATE SYSTEM _ _ EXPANDED oder STATE SYSTEM _ _ COLLAPSED.
Weitere mögliche Werte für die State-Eigenschaft sind:
STATE _ _SYSTEMORIENTIERTES | _ ZUSTANDSSYSTEM _ FOKUSSIERBARES | _ ZUSTANDSSYSTEM _ AUSWÄHLBARES | _ ZUSTANDSSYSTEM _ AUSGEWÄHLTES | _ ZUSTANDSSYSTEM _ HOTTRACKED
get _ accValue Das Strukturansichtsobjekt hat keinen Wert. Die Value-Eigenschaft für jedes Strukturansichtselement ist die Einzugsebene des Elements in der Hierarchie. In Windows Explorer weist das Element "Desktop" beispielsweise die Value-Eigenschaft "0" auf. das Element "Arbeitsplatz", das sich auf der nächsten Ebene in der Hierarchie befindet, hat die Value-Eigenschaft "1"; und jedes der Datenträgerlaufwerke, die sich auf der nächsten Ebene in der Hierarchie befinden, verfügen über die Value-Eigenschaft "2".

Notizen

Die accLocation-Eigenschaft von Strukturansichtselementen gibt nur den Speicherort des Texts im Element zurück. Die von accLocation zurückgegebenen Koordinaten für Strukturansichtselemente enthalten nicht das Symbol links neben dem Text.

IAccessible-Schnittstelle