1<?xml version="1.0" encoding="utf-8"?>
2<page xmlns="http://projectmallard.org/1.0/" type="topic" id="interface_viewer_plugin" xml:lang="ca">
3  <info>
4    <link type="guide" xref="index#examining_a11y"/>
5    <title type="sort">2. Connector de visualització d'interfícies</title>
6    <link type="next" xref="validator_plugin"/>
7    <desc>Examineu la vostra implementació de l'accessibilitat</desc>
8    <credit type="author">
9      <name>Eitan Isaacson</name>
10      <email>eitan@ascender.com</email>
11    </credit>
12    <credit type="author">
13      <name>Peter Parente</name>
14      <email>pparent@us.ibm.com</email>
15    </credit>
16    <credit type="author">
17      <name>Aline Bessa</name>
18      <email>alibezz@gmail.com</email>
19    </credit>
20    <license>
21      <p>Creative Commons Compartir Igual 3.0</p>
22    </license>
23
24    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
25      <mal:name>Joan Duran</mal:name>
26      <mal:email>jodufi@gmail.com</mal:email>
27      <mal:years>2007-2009</mal:years>
28    </mal:credit>
29  </info>
30  <title>Connector de visualització d'interfícies</title>
31
32  <p>
33    The Interface Viewer Plugin shows the information and controls provided by the AT-SPI interfaces
34    present in each accessible item from the <link xref="desktop_tree_view">Application Tree View</link>. After
35    selecting an item, you can use this plugin to quickly review its supported interfaces, to retrieve
36    each interface's information, and to manipulate the item through all the interface’s methods.
37  </p>
38
39  <figure>
40    <title>Examining a Menu with the Interface Viewer Plugin</title>
41    <desc>
42      Given a selected item in the Application Tree View, all of its AT-SPI interfaces will be shown as sensitive
43      in the Interface Viewer Plugin. Those unsupported will appear grayed out, such as the Application
44      and Collection interfaces in the figure above.
45    </desc>
46    <media type="image" mime="image/png" width="800" height="450" src="figures/interface_viewer_plugin.png">
47      <p>Given a selected item in the Application Tree View, all of its AT-SPI interfaces will be shown as sensitive
48      in the Interface Viewer Plugin. Those unsupported will appear grayed out, such as the Application and Collection
49      interfaces in the figure above.</p>
50    </media>
51  </figure>
52
53  <section id="running_interface_viewer">
54    <title>Execució del connector de visualització d'interfícies</title>
55    <p>
56      The first step to run the Interface Viewer Plugin is to select an item in the <link xref="desktop_tree_view">
57      Application Tree View</link>. After that, all AT-SPI interfaces covered by the plugin will be listed in the
58      plugin's panel. The interfaces implemented by the selected item will be sensitive, so you can click each one of
59      them to either retrieve their provided information or to interact with available methods. The following interfaces
60      can be explored in <app>Accerciser</app>, assuming the selected item implements them:
61    </p>
62    <list>
63      <item>
64        <p>
65          Accessible - This interface shows the selected item's child count (number of child widgets), description, states,
66          relations, and attributes.
67        </p>
68      </item>
69      <item>
70        <p>
71          Action - This interface shows all the actions that can be performed by the selected item. For each interface,
72          you will see its name, such as "press" or "click", followed by a description and a key binding, if there are
73          any. If you select an action, a "Perform action" button will become sensitive. Press this button to see the
74          item performing the selected action.
75        </p>
76      </item>
77      <item>
78        <p>
79          Application - This interface can be implemented by items with role "application". It is worth to point out that
80          items with role "application" not necessarily implement this interface. If the selected item implements it, the interface
81          will show its ID and, if there are any, its toolkit and version.
82        </p>
83      </item>
84      <item>
85        <p>
86          Component - This interface shows the selected item's absolute position (with respect to the desktop coordinate system), relative           position (with respect to the window coordinate system), size, layer type, MDI-Z-order (a short integer indicating the
87          stacking order of the component in the MDI layer), and alpha (if alpha blending is used).
88        </p>
89      </item>
90      <item>
91        <p>
92          Document - This interface shows the selected item's document attributes and locale description, if there is one.
93        </p>
94      </item>
95      <item>
96        <p>
97          Hypertext - This interface shows a list with all the selected item's hypertext hyperlinks. For each hyperlink, the interface
98          provides its name, URI, start (the index in the hypertext at which the hyperlink begins) and end (the index in the hypertext
99          at which this hyperlink ends).
100        </p>
101      </item>
102      <item>
103        <p>
104          Image - This interface shows the selected item's description (or "no description" if unspecified), size, position
105          (with respect to the desktop coordinate system), and locale, if there is one.
106        </p>
107      </item>
108      <item>
109        <p>
110          Selection - This interface shows all selectable child items of the selected item. If the selected item is a menu bar
111          with options "File", "Edit", "View", and "Help", and all of them are selectable, then they will be listed in this
112          interface. If you click a listed option - "File", for example - and want to clear it, just press the "Clear" button
113          below the list.
114        </p>
115      </item>
116      <item>
117        <p>
118          Streamable Content - This interface shows the selected item's content types and their corresponding URIs.
119        </p>
120      </item>
121      <item>
122        <p>
123          Table - This interface shows the selected item's caption and summary, rows (number of rows), columns (number of columns),
124          selected rows (number of selected rows), and selected columns (number of selected columns). For a selected cell, the
125          interface shows its row's and column's header and extents.
126        </p>
127      </item>
128      <item>
129        <p>
130          Text - This interface shows the selected item's text content, that can be editable, and its attributes. The basic
131          attributes are offset (the number of characters the text has) and justification. To see possible CSS attributes,
132          click the "Include defaults" check box.
133        </p>
134      </item>
135      <item>
136        <p>
137          Value - This interface shows the selected item's current value, minimum allowed value, maximum allowed value, and
138          the minimum increment by which the value may be changed (or zero if this value cannot be determined). The current
139          value can be manually changed via a spin button.
140        </p>
141      </item>
142    </list>
143  </section>
144</page>
145