53 lines
1.9 KiB
ReStructuredText
53 lines
1.9 KiB
ReStructuredText
.. _search-plugin:
|
|
|
|
search
|
|
======
|
|
|
|
.. dfhack-tool::
|
|
:summary: Adds search capabilities to the UI.
|
|
:tags: untested fort productivity interface
|
|
:no-command:
|
|
|
|
Search options are added to the Stocks, Animals, Trading, Stockpile, Noble
|
|
assignment candidates), Military (position candidates), Burrows (unit list),
|
|
Rooms, Announcements, Job List, and Unit List screens all get hotkeys that allow
|
|
you to dynamically filter the displayed lists.
|
|
|
|
Usage
|
|
-----
|
|
|
|
::
|
|
|
|
enable search
|
|
|
|
.. 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.
|