| 1 |
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="howto_flat_review"> |
| 2 |
<info> |
| 3 |
<link type="guide" xref="index#reviewing"/> |
| 4 |
<link type="next" xref="howto_orca_find" /> |
| 5 |
<title type="sort">2. Flat Review</title> |
| 6 |
<desc>Examining a window spatially</desc> |
| 7 |
<credit type="author"> |
| 8 |
<name>Joanmarie Diggs</name> |
| 9 |
<email>[email protected]</email> |
| 10 |
</credit> |
| 11 |
<license> |
| 12 |
<p>Creative Commons Share Alike 3.0</p> |
| 13 |
</license> |
| 14 |
</info> |
| 15 |
<title>Flat Review</title> |
| 16 |
<p> |
| 17 |
<app>Orca</app>'s Flat Review feature allows you to spatially review the |
| 18 |
contents, both text and widgets, of the active window. In this mode, |
| 19 |
<app>Orca</app> treats the window as if it were a two-dimensional sheet of |
| 20 |
text, eliminating any notion of widget hierarchy or other logical grouping |
| 21 |
within the window. |
| 22 |
</p> |
| 23 |
<p> |
| 24 |
The "flattened" contents, also known as the Flat Review context, can be |
| 25 |
<link xref="commands_flat_review">navigated</link> by line, by word, by |
| 26 |
character, and by object. In addition, you can perform a left-click or |
| 27 |
right-click on the object being reviewed. Finally, you can use |
| 28 |
<link xref="howto_orca_find">Orca Find</link>, a Flat-Review-based feature |
| 29 |
to search the active window's contents. |
| 30 |
</p> |
| 31 |
<p> |
| 32 |
Because the Flat Review context is a spatial representation of the active |
| 33 |
window's contents, it is created when you first enter Flat Review and only |
| 34 |
contains those objects which are visible. As a result, you will not be able |
| 35 |
to use Flat Review to access items which are in the window but currently |
| 36 |
off-screen. In addition, if the window's contents change of their own |
| 37 |
accord, the Flat Review context will not automatically be updated. You can |
| 38 |
cause a new context to be built by toggling Flat Review off and back on. |
| 39 |
</p> |
| 40 |
<p> |
| 41 |
Finally, Flat Review by its nature is a mode that cannot be used at the same |
| 42 |
time that <app>Orca</app> is tracking focus. Thus if you are in Flat Review |
| 43 |
and then use the application's navigation commands to move the caret or to |
| 44 |
give focus to another object, you will automatically leave Flat Review. |
| 45 |
</p> |
| 46 |
</page> |