Qt4 Hildon/Qt Hildon Widgets

Revision as of 18:31, 20 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 (Done 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) ( Mostly done in Qt )
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)

Following QT toolkit widgets are not optimized for mobile ui, and consequently are not finger usable on high DPI touchscreens like Nokia N900.

These links may be of use:

@@ Line 7: / Line 7: @@
 For details about Maemo 5 user experience, see:
+* [http://www.forum.nokia.com/info/sw.nokia.com/id/eb8a68ba-6225-4d84-ba8f-a00e4a05ff6f/Hildon_2_2_UI_Style_Guide.html Hildon 2.2 UI Style Guide]
+* [http://www.forum.nokia.com/info/sw.nokia.com/id/019c2b31-3777-49a0-9257-970d79580756/Hildon_2_2_Widget_UI_Specification.html Hildon 2.2 Widget UI Specification]
+* [http://www.forum.nokia.com/info/sw.nokia.com/id/e778ba1f-2507-4672-be45-798359a3aea7/Fremantle_Master_Layout_Guide.html Fremantle Master Layout Guide]
 * [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]