Debian Codegraph @

help/C/howto_whereami.page

raw
1 <page xmlns="http://projectmallard.org/1.0/" type="topic" id="howto_whereami">
2 <info>
3 <link type="guide" xref="index#reviewing"/>
4 <link type="next" xref="howto_flat_review" />
5 <title type="sort">1. Where Am I</title>
6 <desc>
7 Learning about your location
8 </desc>
9 <credit type="author">
10 <name>Joanmarie Diggs</name>
11 <email>[email protected]</email>
12 </credit>
13 <license>
14 <p>Creative Commons Share Alike 3.0</p>
15 </license>
16 </info>
17 <title>Where Am I</title>
18 <p>
19 In addition to dedicated commands for reading the title bar and the
20 status bar, Orca provides two context-sensitive Where Am I commands:
21 Basic Where Am I and Detailed Where Am I. Basic Where Am I is implemented
22 for all objects. Detailed Where Am I is implemented just for those objects
23 for which there is a significant amount of information you may wish to know,
24 but likely will not wish to know all of the time.
25 </p>
26 <p>
27 The best way to become familiar with what Where Am I will present is to
28 give the <link xref="commands_where_am_i">Where Am I commands</link> a
29 try. However, to give you a better idea of the context-sensitive nature
30 of <app>Orca</app>'s Where Am I feature, consider the following:
31 </p>
32 <p>
33 For most widgets, you will at least be told the label and/or name, the
34 type or role of the widget, and the mnemonic and/or accelerator key if
35 they happen to exist. In addition:
36 </p>
37 <list>
38 <item>
39 <p>
40 If the widget is text, and you perform a basic Where Am I, you will be
41 told the current line if no text is selected. If text is selected,
42 however, a basic Where Am I will tell you what text is selected. A
43 detailed Where Am I within the text will also include the text
44 attributes.
45 </p>
46 </item>
47 <item>
48 <p>
49 If the widget can be checked, as is the case with checkboxes and
50 radio buttons, the checked state will be included.
51 </p>
52 </item>
53 <item>
54 <p>
55 If the widget is a list or list-like object, such as a combo box, radio
56 button group, or page tab list, the position of the current item will be
57 included.
58 </p>
59 </item>
60 <item>
61 <p>
62 If the widget is hierarchical, such as a tree, and you are on an
63 expandable node, you will be told if that node is expanded or not.
64 And if it is expanded, you will also be told how many children it
65 contains. In addition, the nesting level will also be provided.
66 </p>
67 </item>
68 <item>
69 <p>
70 If the widget is a progress bar or a slider, you will be told the
71 current percent.
72 </p>
73 </item>
74 <item>
75 <p>
76 If the widget is an icon within an icon group, a basic Where Am I
77 will include the object you are in, the item you are on, and the
78 number of items which are selected. In a detailed Where Am I, you
79 will also be told which items are selected.
80 </p>
81 </item>
82 <item>
83 <p>
84 If you are on a link, the type of link (same site, different site,
85 FTP link, etc.) will be included.
86 </p>
87 </item>
88 <item>
89 <p>
90 If you are in a table cell, the coordinates of that cell and the cell
91 headers will be included.
92 </p>
93 </item>
94 <item>
95 <p>
96 If you are in the spell checker of an application where <app>Orca</app>
97 provides enhanced support, a basic Where Am I will repeat the error
98 respecting your <link xref="preferences_spellcheck">spell check
99 preferences</link>. A detailed Where Am I will cause <app>Orca</app> to
100 present the full details of the error.
101 </p>
102 </item>
103 </list>
104 <p>
105 And so on. Again, the goal of <app>Orca</app>'s Where Am I is to provide
106 you with the details you are most likely interested in knowing about the
107 object you are currently in. To give Where Am I a try, see the list of
108 <link xref="commands_where_am_i">Where Am I commands</link>.
109 </p>
110 </page>