Debian Codegraph @

help/C/howto_flat_review.page

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