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.
-
These widgets may be useful:
+
 
 +
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 app menu (i.e. two column finger sized view menu)
 
-
* hildon time picker (not the legacy one)
 
-
* hildon date picker (not the legacy one)
 
-
* hildon picker button
 
-
* hildon touch selector
 
-
* hildon stackable window
 
* hildon entry (including the possibility for placeholder text)
* hildon entry (including the possibility for placeholder text)
-
* hildon edit toolbar (as used in the edit mode view)
 

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):


These links may be of use: