| 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> |