Qt4 Hildon/Qt Hildon Widgets

 
(10 intermediate revisions not shown)
Line 1: Line 1:
-
Qt for Hildon does not yet provide a set of composite widgets similar to those provided in Gtk Hildon.
+
[http://qt.nokia.com/developer/qt-for-maemo-developers Qt for Maemo 5] provides Maemo-specific widgets such as PickerButtons and Banners, which are described in the following documentation:
-
 
+
* [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]
-
This page is intended to link to resources to help the community develop these widgets.
+
* [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]
-
Note that they will not be part of Qt as such, but will be optional widgets to aid developing applications for Maemo.
+
* [http://wiki.maemo.org/Documentation/Maemo_5_Developer_Guide/Human_Interface_Guidelines Maemo 5 Human Interface Guidelines] (legacy documentation)
-
 
+
* [http://wiki.maemo.org/Documentation/Maemo_5_Developer_Guide/Graphical_UI_Tutorial Maemo 5 Graphical UI Tutorial] (legacy documentation)
-
 
+
-
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 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
+
-
* QFontDialog
+
-
* ...
+
 +
The official Qt documentation provides a list of [http://qt.nokia.com/doc/qt-maemo-4.6/examples-maemo5.html Qt for Maemo 5 examples].
These links may be of use:
These links may be of use:
* Discussion thread starting [http://www.mail-archive.com/maemo-developers@maemo.org/msg20237.html about here]
* Discussion thread starting [http://www.mail-archive.com/maemo-developers@maemo.org/msg20237.html about here]
-
* http://maemomm.garage.maemo.org/docs_unstable/tutorial/figures/
+
* http://maemomm.garage.maemo.org/docs/tutorial/figures/
* https://bugs.maemo.org/show_bug.cgi?id=4625
* https://bugs.maemo.org/show_bug.cgi?id=4625
* https://git.maemo.org/projects/hildon/gitweb?p=hildon;a=summary
* https://git.maemo.org/projects/hildon/gitweb?p=hildon;a=summary
* [[Using Fremantle Widgets]] and the [[Talk:Using Fremantle Widgets|talk]] page
* [[Using Fremantle Widgets]] and the [[Talk:Using Fremantle Widgets|talk]] page
 +
 +
[[Category:Qt]]
 +
[[Category:Development]]

Latest revision as of 15:00, 11 February 2010

Qt for Maemo 5 provides Maemo-specific widgets such as PickerButtons and Banners, which are described in the following documentation:

The official Qt documentation provides a list of Qt for Maemo 5 examples.

These links may be of use: