Strukturansichtssteuerelement (MSAA-UI-Elementreferenz)
Hinweis
In diesem Thema werden Strukturansichtssteuerelementobjekte für zwecke der MSAA-UI-Elementreferenz beschrieben. Das Erstellen von Strukturansichtssteuerelementobjekten in verschiedenen Benutzeroberflächenframeworks ist hier nicht beschrieben. Informationen zum verwendeten BENUTZERoberflächenframework finden Sie in der API-Referenzdokumentation.
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 Bezeichnung und einer optionalen Bitmap. Windows Explorer verwendet ein Strukturansichtssteuerelement zum Anzeigen von Verzeichnissen.
Der Name der Fensterklasse 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 erweitert oder reduziert accDoDefaultAction das angegebene Element. |
| 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 elemente, die in der Strukturansicht enthalten sind. 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 erweiterten Strukturansicht weist "Collapse" als DefaultAction-Eigenschaft auf, 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 des Steuerelements (oder Untertitel) abgerufen. Dieser Text wird nicht mit dem Strukturansichtssteuerelement angezeigt, sodass Serverentwickler aussagekräftigen Text in der Ressourcendefinitionsanweisung des Steuerelements bereitstellen müssen, um Benutzern von Clienthilfsprogrammen bei der Identifizierung des Steuerelements zu helfen. 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 umgibt und denselben Name-Eigenschafts - und Fensterklassennamen wie das Steuerelement aufweist. 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 Eigenschaft RoleROLE_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 State-Eigenschaft entweder STATE_SYSTEM_EXPANDED oder STATE_SYSTEM_COLLAPSED. Weitere mögliche Werte für die State-Eigenschaft sind: | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_SELECTABLE | STATE_SYSTEM_SELECTED STATE_SYSTEM_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 "Mein Computer", 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, weist die Value-Eigenschaft "2" auf. |
Hinweise
Die accLocation-Eigenschaft von Strukturansichtselementen gibt nur die Position des Texts im Element zurück. Die von accLocation für Strukturansichtselemente zurückgegebenen Koordinaten enthalten nicht das Symbol links neben dem Text.