41 lines
1.7 KiB
ReStructuredText
41 lines
1.7 KiB
ReStructuredText
|
|
||
|
.. _search-plugin:
|
||
|
|
||
|
search
|
||
|
======
|
||
|
The search plugin adds search to the Stocks, Animals, Trading, Stockpile,
|
||
|
Noble (assignment candidates), Military (position candidates), Burrows
|
||
|
(unit list), Rooms, Announcements, Job List and Unit List screens.
|
||
|
|
||
|
.. image:: ../images/search.png
|
||
|
|
||
|
Searching works the same way as the search option in :guilabel:`Move to Depot`.
|
||
|
You will see the Search option displayed on screen with a hotkey (usually :kbd:`s`).
|
||
|
Pressing it lets you start typing a query and the relevant list will start
|
||
|
filtering automatically.
|
||
|
|
||
|
Pressing :kbd:`Enter`, :kbd:`Esc` or the arrow keys will return you to browsing the now
|
||
|
filtered list, which still functions as normal. You can clear the filter
|
||
|
by either going back into search mode and backspacing to delete it, or
|
||
|
pressing the "shifted" version of the search hotkey while browsing the
|
||
|
list (e.g. if the hotkey is :kbd:`s`, then hitting :kbd:`Shift`:kbd:`s` will clear any
|
||
|
filter).
|
||
|
|
||
|
Leaving any screen automatically clears the filter.
|
||
|
|
||
|
In the Trade screen, the actual trade will always only act on items that
|
||
|
are actually visible in the list; the same effect applies to the Trade
|
||
|
Value numbers displayed by the screen. Because of this, the :kbd:`t` key is
|
||
|
blocked while search is active, so you have to reset the filters first.
|
||
|
Pressing :kbd:`Alt`:kbd:`C` will clear both search strings.
|
||
|
|
||
|
In the stockpile screen the option only appears if the cursor is in the
|
||
|
rightmost list:
|
||
|
|
||
|
.. image:: ../images/search-stockpile.png
|
||
|
|
||
|
Note that the 'Permit XXX'/'Forbid XXX' keys conveniently operate only
|
||
|
on items actually shown in the rightmost list, so it is possible to select
|
||
|
only fat or tallow by forbidding fats, then searching for fat/tallow, and
|
||
|
using Permit Fats again while the list is filtered.
|