| 1 |
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="howto_orca_find"> |
| 2 |
<info> |
| 3 |
<link type="guide" xref="index#reviewing"/> |
| 4 |
<link type="next" xref="howto_mouse_review" /> |
| 5 |
<title type="sort">3. Orca Find</title> |
| 6 |
<desc>Searching a window for objects</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>Orca Find</title> |
| 16 |
<p> |
| 17 |
<app>Orca</app>'s Find feature is a |
| 18 |
<link xref="howto_flat_review">Flat-Review</link>-based search designed to |
| 19 |
help you quickly locate objects that are visible on-screen within the |
| 20 |
current window. |
| 21 |
</p> |
| 22 |
<note style="tip"> |
| 23 |
<title>Activating Orca Find</title> |
| 24 |
<p> |
| 25 |
To open the Orca <gui>Find</gui> dialog, use the following command based |
| 26 |
on your chosen <link xref="howto_keyboard_layout">keyboard layout</link>: |
| 27 |
</p> |
| 28 |
<list> |
| 29 |
<item> |
| 30 |
<p>Desktop: <keyseq><key>KP Delete</key></keyseq></p> |
| 31 |
</item> |
| 32 |
<item> |
| 33 |
<p>Laptop: |
| 34 |
<keyseq><key>Orca Modifier</key><key>Left Bracket</key></keyseq> |
| 35 |
</p> |
| 36 |
</item> |
| 37 |
</list> |
| 38 |
<p> |
| 39 |
For a list of additional tasks you can perform, see the |
| 40 |
<link xref="commands_find">Orca Find commands</link> |
| 41 |
</p> |
| 42 |
</note> |
| 43 |
<p> |
| 44 |
When you activate Orca Find, you will be placed in a dialog box. |
| 45 |
</p> |
| 46 |
<p> |
| 47 |
Here you can specify the following items: |
| 48 |
</p> |
| 49 |
<list> |
| 50 |
<item> |
| 51 |
<p>The text to find</p> |
| 52 |
</item> |
| 53 |
<item> |
| 54 |
<p> |
| 55 |
The location from which to begin the search, which can either be |
| 56 |
the current location or the top of the window |
| 57 |
</p> |
| 58 |
<p> |
| 59 |
Default value of <gui>Start from</gui>: <gui>Current location</gui> |
| 60 |
</p> |
| 61 |
</item> |
| 62 |
<item> |
| 63 |
<p> |
| 64 |
Whether or not capitalization should be taken into account when seeking |
| 65 |
a match |
| 66 |
</p> |
| 67 |
<p> |
| 68 |
Default value of <gui>Match case</gui>: not checked |
| 69 |
</p> |
| 70 |
</item> |
| 71 |
<item> |
| 72 |
<p> |
| 73 |
Whether or not to limit matches to those which match the entire word |
| 74 |
or phrase |
| 75 |
</p> |
| 76 |
<p> |
| 77 |
Default value of <gui>Match entire word only</gui>: not checked |
| 78 |
</p> |
| 79 |
</item> |
| 80 |
<item> |
| 81 |
<p> |
| 82 |
Whether Find should look down and/or to the right for the next |
| 83 |
match or up and/or to the left. |
| 84 |
</p> |
| 85 |
<p> |
| 86 |
Default value of <gui>Search backwards</gui>: not checked |
| 87 |
</p> |
| 88 |
</item> |
| 89 |
<item> |
| 90 |
<p> |
| 91 |
Whether or not Find should wrap around to the top/bottom of the window |
| 92 |
if there is no match found from the starting location in the direction |
| 93 |
of the search. |
| 94 |
</p> |
| 95 |
<p> |
| 96 |
Default value of <gui>Wrap around</gui>: checked |
| 97 |
</p> |
| 98 |
</item> |
| 99 |
</list> |
| 100 |
<p> |
| 101 |
Having performed a search, you can quickly search for the next or previous |
| 102 |
match without having to return to the Orca Find dialog box. |
| 103 |
</p> |
| 104 |
<p> |
| 105 |
Because it is a <link xref="howto_flat_review">Flat Review</link> feature, |
| 106 |
when there is a match, Flat Review will automatically be activated and the |
| 107 |
matching item or text will become the current review item. Note that focus |
| 108 |
within the application will not be modified, nor will the caret be |
| 109 |
repositioned. If you need to accomplish either, please see |
| 110 |
<link xref="commands_mouse">Orca's Mouse/Pointer-Related Commands</link>. |
| 111 |
</p> |
| 112 |
</page> |