| Guidelines | |||||||||||
|
Basics Menus Toolbar Statusbar Content Area Dialogs Keys
Drag and Drop printable version (ps)/(pdf) |
| Links |
|
Icon Style Guide |
 |
Keys
Completion
When the user needs to fill in an entry field in the UI, the application is often able to offer an educated guess after the user has provided only a part of the actual information.
|
When a user has typed the first few characters of an e-mail address, the application can often guess the rest based on prior e-mails sent or an addressbook, etc. |
All KDE applications that provide a completion feature should follow the guidelines given here. The functionality provided by this feature will, of course, be different on a per application basis.
| No agreement has yet been reached on a single completion mechanism. Two mechanisms are nominated: auto-completion and end of line completion. |
This completion mechanism is only available when the caret is positioned at the end of the input line. When the user now presses either the Right arrow key or the End key the application will try to find a completion based on the current contents of the input line.
- If no suitable completion is found a Beep is sounded. The caret is not moved.
- If a single suitable completion is found, the completion is inserted in the input line and the caret is placed at the end of the line.
- If multiple completions are found, a list of possible completions is shown.
(The caret is also known as the text-cursor. Note that the mouse-pointer is also referred to as cursor. This is the reason the term cursor is avoided in this document.)
|
This style guide only covers completion for QLineEdit like entry fields. It does not cover multi-line edit widgets. |
Previous