Trädvykontroll (referens för MSAA-gränssnittselement)
Not
I det här avsnittet beskrivs Trädvykontroll objekt i syfte att använda MSAA UI-elementreferens. Hur du skapar Trädvykontroll objekt i olika gränssnittsramverk beskrivs inte här. Se API-referensdokumentationen för det användargränssnittsramverk som du använder.
En trädvykontroll visar en hierarkisk lista över objekt som använder rader för att ansluta relaterade objekt i en hierarki. Varje objekt består av en etikett och en valfri bitmapp. Utforskaren använder en trädvykontroll för att visa kataloger.
Fönstrets klassnamn för en trädvykontroll är WC_TREEVIEW, som definieras som "SysTreeView" i Commctrl.h.
IAccessible-metoder
En trädvykontroll stöder följande IAccessible- metoder:
| Metod | Kommentarer |
|---|---|
| accDoDefaultAction | Själva trädvyobjektet har ingen accDoDefaultAction--metod. Beroende på egenskapen State för ett objekt i trädvyn accDoDefaultAction antingen expanderar eller döljer det angivna objektet. |
| accHitTest | |
| accLocation | |
| accNavigate | |
| accSelect |
IAccessible-egenskaper
En trädvykontroll stöder följande egenskaper för IAccessible:
| Egenskap | Kommentarer |
|---|---|
| get_accChild | |
| get_accChildCount | Egenskapen ChildCount för trädvyobjektet är antalet objekt som finns i trädvyn. Egenskapen ChildCount för varje trädvyobjekt är noll. |
| get_accDefaultAction | Själva trädvyobjektet har ingen egenskapen DefaultAction. Ett objekt i trädvyn som expanderas har "Dölj" som egenskap DefaultAction, och ett objekt som inte expanderas har "Expandera" som egenskap DefaultAction. |
| get_accDescription | |
| get_accFocus | |
| get_accHelp | |
| get_accHelpTopic | |
| get_accKeyboardShortcut | |
| get_accName | Egenskapen Name för trädvyobjektet hämtas från kontrollens fönstertext (eller bildtext). Den här texten visas inte med trädvisningskontrollen, så serverutvecklare måste tillhandahålla meningsfull text i kontrollens resursdefinitionsuttryck för att hjälpa användare av klientverktyg att identifiera kontrollen. Egenskapen Name för ett objekt i trädvyn är texten som visas i trädvyobjektet. |
| get_accParent | Egenskapen Parent för trädvyobjektet är ett fönster ( ROLE_SYSTEM_WINDOW ) som omger kontrollen och har samma Namn egenskap och fönsterklassnamn som kontrollen. Egenskapen Överordnad för varje objekt i trädvyn är trädvyobjektet. |
| get_accRole | Trädvyobjektet har egenskapen RoleROLE_SYSTEM_OUTLINE. Varje objekt i trädvyn har egenskapen RollROLE_SYSTEM_OUTLINEITEM. |
| get_accSelection | |
| get_accState | Egenskapen State för trädvyn är en kombination av ett eller flera av följande värden: STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE För trädvyobjekten innehåller egenskapen State antingen STATE_SYSTEM_EXPANDED eller STATE_SYSTEM_COLLAPSED. Ytterligare möjliga värden för egenskapen State är: STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_SELECTABLE | STATE_SYSTEM_SELECTED | STATE_SYSTEM_HOTTRACKED |
| get_accValue | Trädvyobjektet har inget värde. Egenskapen Value för varje trädvyobjekt är objektets indragsnivå i hierarkin. I Utforskaren i Utforskaren har objektet "Desktop" till exempel en Value-egenskapen "0"; objektet "Min dator", som ligger på nästa nivå i hierarkin, har egenskapen Value för "1"; och var och en av diskenheterna, som ligger på nästa nivå i hierarkin, har egenskapen Value egenskapen "2". |
Anteckningar
Egenskapen accLocation för trädvyobjekt returnerar endast platsen för texten i objektet. Koordinaterna som returneras av accLocation för trädvyobjekt innehåller inte ikonen till vänster om texten.