• Intro
• Downloads
• Community
• Development
• News
• TALK

Qt4 Hildon/Qt Hildon Widgets

Revision as of 09:22, 29 September 2009

Qt for Hildon won't provide a set of composite widgets similar to those provided in Gtk Hildon. They will be part of an extra library.

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:

• Hildon 2.2 UI Style Guide
• Hildon 2.2 Widget UI Specification
• Fremantle Master Layout Guide

• Maemo 5 Human Interface Guidelines
• 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 sizeHint is 48px]
• 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. [Checkable QPushButton have to be themed or this will be part of an extra lib]
• 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? [At moment there is no sizeHint, Developer have to set it to 65px]
• Text input fields [Style is okay]
• text areas(?)

Following important Hildon widgets need the respective Qt Hildon widget (in priority order):

• Sub views (description) - HildonStackableWindow ([1])
• 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 [This could be part of our Qt Hildon Extra lib]
• Action buttons for pannable lists (example) - hildon_tree_view_get_action_area_box etc. in Maemo GtkTreeview[will be part of the extra Qt lib or you can use a QPushButton and load the "+" icon by yourself]
• Picker buttons (description, see also HildonTouchSelector) - HildonPickerButton[will be part of the extra Qt lib]
• list selectors (description, single column, multi column, single selection, multiselection, picker with entry, with images) - HildonTouchSelector[will be part of the extra Qt lib]
• Date picker (description, including column re-layout based on locale data) - HildonDateButton[will be part of the extra Qt lib]
• Time picker (description, including AM/PM support based on user setting) - HildonTimeButton[will be part of the extra Qt lib]
• hildon banner [will be part of the extra Qt lib]
• 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.

• QColorDialog [Qt dialog has been modified in order to be usable with fingers]
• QFontDialog [Qt dialog has been modified in order to be usable with fingers]
• ...

These links may be of use:

• Discussion thread starting about here
• http://maemomm.garage.maemo.org/docs_unstable/tutorial/figures/
• https://bugs.maemo.org/show_bug.cgi?id=4625
• https://git.maemo.org/projects/hildon/gitweb?p=hildon;a=summary
• Using Fremantle Widgets and the talk page