Strukturansicht-Steuerelement (MSAA UI-Elementreferenz)
Anmerkung
In diesem Thema werden Strukturansichtssteuerelement Objekte für MSAA-UI-Elementreferenz beschrieben. Das Erstellen Strukturansichtssteuerelements Objekte in verschiedenen Benutzeroberflächenframeworks wird hier nicht beschrieben. Weitere Informationen finden Sie in der API-Referenzdokumentation für das von Ihnen verwendete Benutzeroberflächenframework.
Ein Strukturansichtssteuerelement zeigt eine hierarchische Liste von Elementen mithilfe von Zeilen an, um verwandte Elemente in einer Hierarchie zu verbinden. Jedes Element besteht aus einer Beschriftung und einer optionalen Bitmap. Windows Explorer verwendet ein Strukturansichtssteuerelement zum Anzeigen von Verzeichnissen.
Der Name der Fensterklasse für ein Strukturansichtssteuerelement ist WC_TREEVIEW, der 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. Je nach State-Eigenschaft eines Elements in der Strukturansicht accDoDefaultAction das angegebene Element entweder erweitert oder reduziert. |
| accHitTest- | |
| accLocation- | |
| accNavigate- | |
| accSelect- |
IAccessible-Eigenschaften
Ein Strukturansichtssteuerelement unterstützt die folgenden IAccessible Eigenschaften:
| Eigentum | Kommentare |
|---|---|
| get_accChild | |
| get_accChildCount | Die ChildCount-Eigenschaft für das Strukturansichtsobjekt ist die Anzahl der Elemente in der Strukturansicht. Die ChildCount-Eigenschaft für jedes Strukturansichtselement ist Null. |
| get_accDefaultAction | Das Strukturansichtsobjekt selbst verfügt nicht über eine DefaultAction--Eigenschaft. Ein Element in der Strukturansicht, das erweitert wird, hat "Collapse" als DefaultAction--Eigenschaft, und ein Element, das nicht erweitert wird, 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, sodass Serverentwickler aussagekräftigen Text in der Ressourcendefinitionsanweisung des Steuerelements bereitstellen müssen, damit Benutzer von Clienthilfsprogrammen das Steuerelement identifizieren können. Der Name Eigenschaft für ein Element in der Strukturansicht ist der Text, der im Strukturansichtselement angezeigt wird. |
| get_accParent | Die Übergeordnete-Eigenschaft des Strukturansichtsobjekts ist ein Fenster ( ROLE_SYSTEM_WINDOW ), das das Steuerelement umgibt und denselben Name Eigenschaft und Fensterklassennamen wie das Steuerelement aufweist. Die Übergeordnete 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 einem oder mehreren der folgenden Werte: STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE Für die Strukturansichtselemente enthält die eigenschaft State entweder STATE_SYSTEM_EXPANDED oder STATE_SYSTEM_COLLAPSED. Weitere mögliche Werte für die eigenschaft State umfassen: STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_SELECTABLE | STATE_SYSTEM_SELECTED | STATE_SYSTEM_HOTTRACKED |
| get_accValue | Das Strukturansichtsobjekt besitzt keinen Wert. Die Value-Eigenschaft für jedes Strukturansichtselement ist die Einzugsebene des Elements in der Hierarchie. Beispielsweise weist das Element "Desktop" in Windows Explorer eine Value-Eigenschaft von "0" auf; das Element "Mein Computer", das sich auf der nächsten Ebene in der Hierarchie befindet, verfügt über eine Value-Eigenschaft von "1"; und jedes der Datenträgerlaufwerke, die sich auf der nächsten Ebene in der Hierarchie befinden, weisen eine Value-Eigenschaft von "2" auf. |
Notizen
Die accLocation- Eigenschaft von Strukturansichtselementen gibt die Position nur des Texts im Element zurück. Die von accLocation- für Strukturansichtselemente zurückgegebenen Koordinaten enthalten nicht das Symbol links neben dem Text.