3.19. XNap's GUI components

XNap offers several GUI elements which enhance existing and well known components with advanced functionality.

3.19.1. HistoryTextField

The HistoryTextField behaves like a usual text field enriching its functionality with an invisible history keeping track of everything you've typed in.

This comes in handy for instance if you want to repeat something you have already written before in a chat conversation.

The HistoryTextField behaves pretty much like a standard UNIX shell:

Up Arrow, C-p

Show the previous element in the history.

Down Arrow, C-n

Show the next element in the history.

Ctrl-HOME, Alt-<

Show the first element in the history.

Ctrl-END, Alt->

Move to the end of the history.

3.19.2. HistoryComboBox

The HistoryComboBox provides a text field where you can enter text and uses its pull-down menu for displaying the history of already entered items.

The HistoryComboBox also provides a context menu which contains a menu item to clear the history and a submenut Text Completion from which you can select your preferred completion mode.

The history entries of all active HistoryComboBoxes can also be cleared globally, see Edit Menu.

3.19.3. Tables

Most of XNap's tables offer the following features:

3.19.4. Completion

Most of the frequently used text input fields support completion of the already entered input.

To change the way completion is done on a specific text field you can right click on the text field to open a context menu which contains a submenu called Text Completion. In this menu you can select one of the following options:

None

Disable completion. What you get is what you type.

Dropdown List

A drop-down window will appear as you type, showing the possible matches to what you have typed so far.

You can use the mouse to select one of the possible matches or use the Down Arrow and Up Arrow to navigate through the list using Enter to select an item.

Automatic

While you are typing possible completions are appended behind your input. The completed text is marked selected so it is automatically deleted if you keep on typing.

Depending on the type of completion (Text Completion or File Completion) the alphabetically first completion is appended.

If the correct completion is appended you can just press Enter to confirm it.

Short Automatic

The completion is appended to the current input like in the Automatic mode, the only difference being that only the longest common prefix of all possible completions is chosen.

Automatic Dropdown

This mode presents a mixture of the Automatic and the Dropdown List mode.

Manual

Completion has to be triggered manually by a special key sequence which can be configured in the Shortcuts preferences panel.

The default shortcut is: Ctrl-t

Only the longest common prefix of all possible completions is actually appended.

Emacs

This completion mode tries to mimic Emacs' (dabbrev-expand).

The default shortcut for cycling forward through all possible completions is: Ctrl-t

The default shortcut for cycling backward is: Ctrl-r

The shortcuts can be changed globally in the Shortcuts preferences panel.

Default

Setting this option makes the input field honor the global default completion mode.

See Default Completion Mode.