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.