Qt4 Hildon/Qt Hildon Widgets

m (Correct maemomm link)
 
(2 intermediate revisions not shown)
Line 1: Line 1:
-
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.
+
[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:
-
 
+
-
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:
+
* [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/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/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://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] (legacy documentation)
 +
* [http://wiki.maemo.org/Documentation/Maemo_5_Developer_Guide/Graphical_UI_Tutorial Maemo 5 Graphical UI Tutorial] (legacy documentation)
-
* [http://wiki.maemo.org/Documentation/Maemo_5_Developer_Guide/Human_Interface_Guidelines Maemo 5 Human Interface Guidelines]
+
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].
-
* [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 sizeHint is 48px] => Visual height should be 70px in Maemo 5.
+
-
* Toolbar icons do not have correct size (HILDON_ICON_SIZE_FINGER)
+
-
* <s>Dialogs do not have finger size buttons (HILDON_SIZE_FINGER_HEIGHT)</s>
+
-
* 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.
+
-
* <s>Dialog buttons should stack on top of each other, but currently they layout themselves horizontally</s>
+
-
* Checkboxes should be embedded into button => Checkboxbutton. [Checkable QPushButton have to be themed or this will be part of an extra lib]
+
-
* <s>keyboard accelerator hints (underscores) are being shown, while Maemo 5 UI Style requires them to be hidden</s>
+
-
* <s>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".<s> The "Cancel" should be removed, as dialogs are cancelled by tapping outside of the dialog.</s>
+
-
* stock "Exit" command should be removed from the menus. It is not allowed in Maemo 5 UI Style. [Legacy menus should not be used]
+
-
* <s>Sliders/Scales</s>
+
-
* <s>Button heights? [minimal pushbutton height sizeHints is set by the style to 65px]</s>
+
-
* <s>Text input fields</s> [Style is okay]
+
-
* text areas(?)
+
-
 
+
-
 
+
-
Following important Hildon widgets need the respective Qt Hildon widget (in priority order):
+
-
* <s>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])</s>
+
-
* <s>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) </s>
+
-
* 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] [This could be part of our Qt Hildon Extra lib]
+
-
* 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][will be part of the extra Qt lib or you can use a QPushButton and load the "+" icon by yourself]
+
-
* 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][will be part of the extra Qt lib]
+
-
* 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][will be part of the extra Qt lib]
+
-
* 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][will be part of the extra Qt lib]
+
-
* 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][will be part of the extra Qt lib]
+
-
* <s>hildon banner</s> [part of the extra lib http://gitorious.org/qt-maemo/qmaemo-ext-libs/commit/f05642e2faa8a0bdef1f7d6f0cc004e825abba8a]
+
-
* hildon confirmation note
+
-
* <s>hildon dialog (with buttons on the bottom right side in landscape)</s>
+
-
* <s>hildon entry (including the possibility for placeholder text)</s>
+
-
 
+
-
 
+
-
Following QT toolkit widgets are not optimized for mobile ui, and consequently are not finger usable on high DPI touchscreens like Nokia N900.
+
-
* <s>QColorDialog</s> [Qt dialog has been modified in order to be usable with fingers]
+
-
* <s>QFontDialog</s> [Qt dialog has been modified in order to be usable with fingers]
+
-
* ...
+
-
 
+
These links may be of use:
These links may be of use:
Line 59: Line 14:
* 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: