Qt4 Hildon/Qt Hildon Widgets
(Qt widgets page) |
|||
Line 5: | Line 5: | ||
Note that they will not be part of Qt as such, but will be optional widgets to aid developing applications for Maemo. | Note that they will not be part of Qt as such, but will be optional widgets to aid developing applications for Maemo. | ||
- | + | ||
+ | For details about Maemo 5 user experience, see: | ||
+ | * [http://wiki.maemo.org/Documentation/Maemo_5_Developer_Guide/Human_Interface_Guidelines Maemo 5 Human Interface Guidelines] | ||
+ | * [http://wiki.maemo.org/Documentation/Maemo_5_Developer_Guide/Graphical_UI_Tutorial Maemo 5 Graphical UI Tutorial] | ||
+ | |||
+ | |||
+ | Following existing Qt Widgets have issues with Maemo 5 theming/Maemo 5 UI Style: | ||
+ | * Toolbar does not have correct height | ||
+ | * Toolbar icons do not have correct size (HILDON_ICON_SIZE_FINGER) | ||
+ | * Dialogs do not have finger size buttons (HILDON_SIZE_FINGER_HEIGHT) | ||
+ | * Dialogs do not theme dialog buttons as such (different theme from normal buttons) | ||
+ | * Dialogs have type icons (e.g. warning) where has in Maemo 5 use of those icons is not allowed. | ||
+ | * Dialog buttons should stack on top of each other, but currently they layout themselves horizontally | ||
+ | * Checkboxes should be embedded into button => Checkboxbutton. | ||
+ | * overall in many places margins/paddings are not the same as in Maemo 5 UI. | ||
+ | * keyboard accelerator hints (underscores) are being shown, while Maemo 5 UI Style requires them to be hidden | ||
+ | * Stock dialogs use button strings such as "OK" and "Cancel", which are forbidden in Maemo 5 UI Style. "OK" should be replaced with an action string or with "Done". The "Cancel" should be removed, as dialogs are cancelled by tapping outside of the dialog. | ||
+ | * stock "Exit" command should be removed from the menus. It is not allowed in Maemo 5 UI Style. | ||
+ | * Sliders/Scales? | ||
+ | * Button heights? | ||
+ | * Text input fields/text areas(?) | ||
+ | |||
+ | |||
+ | Following important Hildon widgets need the respective Qt Hildon widget (in priority order): | ||
+ | * Sub views ([http://wiki.maemo.org/Documentation/Maemo_5_Developer_Guide/Human_Interface_Guidelines/Windows description]) - [https://git.maemo.org/projects/hildon/gitweb?p=hildon;a=blob;f=hildon/hildon-stackable-window.h;hb=HEAD HildonStackableWindow] ([http://qt.gitorious.org/+qt-maemo-developers/qt/qt-maemo/commits/patch-hildon.stacked.windows-fremantle work in progress in QT]) | ||
+ | * view menu ([http://wiki.maemo.org/Documentation/Maemo_5_Developer_Guide/Human_Interface_Guidelines/View_Menu description], filter buttons) - [https://git.maemo.org/projects/hildon/gitweb?p=hildon;a=blob;f=hildon/hildon-app-menu.h;hb=HEAD HildonAppMenu] (NOTE: this is not at all same widget as the legacy application menu in Gtk or Maemo 4) | ||
+ | * Edit mode toolbar ([http://wiki.maemo.org/Documentation/Maemo_5_Developer_Guide/Human_Interface_Guidelines/Controls#Edit_Toolbar description]) - [https://git.maemo.org/projects/hildon/gitweb?p=hildon;a=blob;f=hildon/hildon-edit-toolbar.h;hb=HEAD HildonEditToolbar] | ||
+ | * Action buttons for pannable lists ([http://wiki.maemo.org/Documentation/Maemo_5_Developer_Guide/Porting_Software/Redesigning_From_Maemo_4_to_Maemo_5#Accounts_view example]) - [https://stage.maemo.org/viewcvs.cgi/projects/haf/trunk/gtk%2B/gtk/gtktreeview.h?root=maemo&view=markup hildon_tree_view_get_action_area_box etc. in Maemo GtkTreeview] | ||
+ | * Picker buttons ([http://wiki.maemo.org/Documentation/Maemo_5_Developer_Guide/Human_Interface_Guidelines/Controls#Picker_Button description], see also HildonTouchSelector) - [https://git.maemo.org/projects/hildon/gitweb?p=hildon;a=blob;f=hildon/hildon-picker-button.h;hb=HEAD HildonPickerButton] | ||
+ | * list selectors ([http://wiki.maemo.org/Documentation/Maemo_5_Developer_Guide/Human_Interface_Guidelines/Controls#Touch_Selectors description], single column, multi column, single selection, multiselection, picker with entry, with images) - [https://git.maemo.org/projects/hildon/gitweb?p=hildon;a=blob;f=hildon/hildon-touch-selector.h;hb=HEAD HildonTouchSelector] | ||
+ | * Date picker ([http://wiki.maemo.org/Documentation/Maemo_5_Developer_Guide/Human_Interface_Guidelines/Controls#Date_Button description], including column re-layout based on locale data) - [https://git.maemo.org/projects/hildon/gitweb?p=hildon;a=blob;f=hildon/hildon-date-button.h;hb=HEAD HildonDateButton] | ||
+ | * Time picker ([http://wiki.maemo.org/Documentation/Maemo_5_Developer_Guide/Human_Interface_Guidelines/Controls#Time_Button description], including AM/PM support based on user setting) - [https://git.maemo.org/projects/hildon/gitweb?p=hildon;a=blob;f=hildon/hildon-time-button.h;hb=HEAD HildonTimeButton] | ||
* hildon banner | * hildon banner | ||
* hildon confirmation note | * hildon confirmation note | ||
* hildon dialog (with buttons on the bottom right side in landscape) | * hildon dialog (with buttons on the bottom right side in landscape) | ||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
* hildon entry (including the possibility for placeholder text) | * hildon entry (including the possibility for placeholder text) | ||
- | |||
Revision as of 10:57, 7 September 2009
Qt for Hildon does not yet provide a set of composite widgets similar to those provided in Gtk Hildon.
This page is intended to link to resources to help the community develop these widgets.
Note that they will not be part of Qt as such, but will be optional widgets to aid developing applications for Maemo.
For details about Maemo 5 user experience, see:
Following existing Qt Widgets have issues with Maemo 5 theming/Maemo 5 UI Style:
- Toolbar does not have correct height
- Toolbar icons do not have correct size (HILDON_ICON_SIZE_FINGER)
- Dialogs do not have finger size buttons (HILDON_SIZE_FINGER_HEIGHT)
- Dialogs do not theme dialog buttons as such (different theme from normal buttons)
- Dialogs have type icons (e.g. warning) where has in Maemo 5 use of those icons is not allowed.
- Dialog buttons should stack on top of each other, but currently they layout themselves horizontally
- Checkboxes should be embedded into button => Checkboxbutton.
- overall in many places margins/paddings are not the same as in Maemo 5 UI.
- keyboard accelerator hints (underscores) are being shown, while Maemo 5 UI Style requires them to be hidden
- Stock dialogs use button strings such as "OK" and "Cancel", which are forbidden in Maemo 5 UI Style. "OK" should be replaced with an action string or with "Done". The "Cancel" should be removed, as dialogs are cancelled by tapping outside of the dialog.
- stock "Exit" command should be removed from the menus. It is not allowed in Maemo 5 UI Style.
- Sliders/Scales?
- Button heights?
- Text input fields/text areas(?)
Following important Hildon widgets need the respective Qt Hildon widget (in priority order):
- Sub views (description) - HildonStackableWindow (work in progress in QT)
- view menu (description, filter buttons) - HildonAppMenu (NOTE: this is not at all same widget as the legacy application menu in Gtk or Maemo 4)
- Edit mode toolbar (description) - HildonEditToolbar
- Action buttons for pannable lists (example) - hildon_tree_view_get_action_area_box etc. in Maemo GtkTreeview
- Picker buttons (description, see also HildonTouchSelector) - HildonPickerButton
- list selectors (description, single column, multi column, single selection, multiselection, picker with entry, with images) - HildonTouchSelector
- Date picker (description, including column re-layout based on locale data) - HildonDateButton
- Time picker (description, including AM/PM support based on user setting) - HildonTimeButton
- hildon banner
- hildon confirmation note
- hildon dialog (with buttons on the bottom right side in landscape)
- hildon entry (including the possibility for placeholder text)
These links may be of use: