|
Home · All Namespaces · All Classes · Grouped Classes · Modules · Functions | |
This document describes the guidelines to be followed when designing a Qt Extended application. The focus is on consistency, think very carefully before departing from the preferred style.
The following are described in this document:
with further detailed information available in:
| Document | Content |
|---|---|
| Application Design | Outlines the styles that should be followed when creating a new Qt Extended application including navigational flow, lists, and viewing items. |
| Naming Conventions | Outlines the conventions for the use of capitals, abbreviations, acronyms and the formatting of labels. |
| Widgets | Outlines the styles that should be followed when creating or modifying widgets. |
| Online Help | Outlines the styles that should be followed when creating or modifying online help files. |
Qt Extended requires the following keys:
| Name | Alternative representations | Usual binding |
|---|---|---|
| Previous | Left, Up, or Down Arrow* | Previous item or value |
| Next | Right, Down, or Up Arrow* | Next item or value |
| Select | Yes, OK | Activate item or confirm changes |
| Menu | Soft-key 1 | Invoke context menu. |
| Back | No, Cancel, Soft-key 2 | Delete text or close window |
| 1 | 1 or space or text input function | |
| 2..9 | Digits with phone key lettering | |
| 0 | 0 or text input function | |
| * | * or text input function | |
| # | # or text input function |
Qt Extended supports the following additional keys:
| Name | Alternative representations | Usual binding |
|---|---|---|
| Up | Up Arrow | Item physically above or to left |
| Down | Down Arrow | Item physically below or to right |
| Left | Left Arrow | Tab or global function to left |
| Right | Right Arrow | Tab or global function to right |
| Delete | Cancel, Clear | Delete item |
| Jog | Wheel up/down | Scroll view or values |
| Fx | Function keys | Invoke global operation |
In some phone designs, two keys represent both vertical and horizontal directions of suggested motion. Sometimes these are a Left/Up button and a Right/Down button, at other times they are a Left/Down button and a Right/Up button. Qt Extended can be configured to handle such designs.
In addition, Qt Extended can support standard full-keyboard interfaces supported by Linux, such as a keyboard connected via USB or Bluetooth.
Qt Extended includes a large number of standard icons, found in the pics/icons/ directory.
These should be used whenever there is a good correspondence between the semantics of the icon in a new application and the semantics in existing applications. Mere visual appearance should not be considered, since these icons can be varied by OEMs and even end-users through the installation of alternative themes. Similarly, the standard icons should not be avoided simply because of their visual appearance (i.e. if you don't like them, ship a custom set of icons themed as you like).
A number of icons have very well defined semantics, and these are listed below:
| Icon | Component | Filename | Description of Use |
|---|---|---|---|
| Context Bar | icon/back | Done: Finished using the current screen and wish to return to previous window. |
| Context Bar | icon/backspace | Delete text: Deletes (backspace) 1 character. |
| Context Bar | icon/cancel | Cancel: Removes all changes performed on the current item (transaction). |
| Context Bar | icon/ok | Accept: Accepts and disengages the current information/data in the currently selected widget. |
| Context Bar | icon/options | Open/Close Menu: Displays the current window's context menu. |
| Context Bar | icon/select | Engage/Select: Selects the current item, widget or grouping. |
| Context Bar | icon/view | More Information: Selects and displays information about the currently focused item. |
| Context Menu | icon/beam | Beam: Sends the currently viewed item via IR. |
| Any | icon/bell | Bell: Indicates that an alarm is associated with the indicated item. |
| Any | icon/color | Color: Allows a color choice to be made. |
| Context Menu | icon/edit | Edit: Edits the currently viewed item. |
| Context Menu | icon/find | Find/Search: Locates an item. |
| Context Menu | icon/help | Help: Displays the help documentation for the current window. |
| Context Menu | icon/new | New: Creates a new item. |
| Context Menu | icon/trash | Delete item: Deletes the currently viewed item. |
| Copyright © 2009 Trolltech | Trademarks | Qt Extended 4.4.3 |
