Strukturansichtssteuerelement (MSAA-UI-Elementreferenz)

  • Artikel

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.

IAccessible-Schnittstelle