PyMaemo/UI tutorial/Additions to GTK+ - Revision history

imported_>amigadave: /* Hildon Size Types */ add table caption,


2011-03-02T10:52:48Z
Hildon Size Types:  add table caption, <code>

				
				
				
				
				
				← Older revision
				Revision as of 10:52, 2 March 2011
				
Line 11:
Line 11:
Note: these constants are all defined in the <code>gtk</code> module. Note: these constants are all defined in the <code>gtk</code> module.



{| class="wikitable"   {| class="wikitable"
|+ Hildon constants
|- |-
! Constant !! Description ! Constant !! Description
|- |-
| HILDON_SIZE_HALFSCREEN_WIDTH || set to 50% screen width | <code>HILDON_SIZE_HALFSCREEN_WIDTH</code> || set to 50% screen width
|- |-
| HILDON_SIZE_FULLSCREEN_WIDTH || set to 100% screen width | <code>HILDON_SIZE_FULLSCREEN_WIDTH</code> || set to 100% screen width
|- |-
| HILDON_SIZE_AUTO_HEIGHT || set to automatic height | <code>HILDON_SIZE_AUTO_HEIGHT</code> || set to automatic height
|- |-
| HILDON_SIZE_FINGER_HEIGHT || set to finger height | <code>HILDON_SIZE_FINGER_HEIGHT</code> || set to finger height
|- |-
| HILDON_SIZE_THUMB_HEIGHT || set to thumb height | <code>HILDON_SIZE_THUMB_HEIGHT</code> || set to thumb height
|- |-
| HILDON_SIZE_AUTO || set to automatic width and automatic height | <code>HILDON_SIZE_AUTO</code> || set to automatic width and automatic height
|} |}



Line 35:
Line 36:
     hildon_gtk_radio_button_new_from_widget(size, radio_group_member)      hildon_gtk_radio_button_new_from_widget(size, radio_group_member)
</source> </source>

== UI Modes == == UI Modes ==



imported_>amigadave: add C documentation link
2010-10-07T11:37:47Z
add C documentation link

				
				
				
				
				
				← Older revision
				Revision as of 11:37, 7 October 2010
				
Line 1:
Line 1:
{{main|Legacy Maemo 5 Documentation/Graphical UI Tutorial/Additions to GTK+}}

A Hildon application might use any GTK+ widget but in some cases could be needed to adapt those widgets to get that they fit perfectly. A Hildon application might use any GTK+ widget but in some cases could be needed to adapt those widgets to get that they fit perfectly.






imported_>amigadave: use  and 

2010-06-23T09:15:21Z
use <source> and <code>

				
				
				
				
				
				← Older revision
				Revision as of 09:15, 23 June 2010
				
Line 1:
Line 1:
== Additions to GTK+ == A Hildon application might use any GTK+ widget but in some cases could be needed to adapt those widgets to get that they fit perfectly.
  
A Hildon application might use any Gtk widget but in some cases could be needed to adapt those widgets to get that they fit perfectly. 



Hildon provides a set of convenience functions to do that. The next sections explains these additions. Hildon provides a set of convenience functions to do that. The next sections explains these additions.



=== Hildon Size Types === == Hildon Size Types ==



Hildon defines the following sizes to be used as sizes for widgets such as buttons or entries in your Hildon application. Hildon defines the following sizes to be used as sizes for widgets such as buttons or entries in your Hildon application.



Note: these constants are all defined in the gtk module. Note: these constants are all defined in the <code>gtk</code> module.



{| class="wikitable"   {| class="wikitable"  
|- |-
! Const !! Description ! Constant !! Description
|- |-
| HILDON_SIZE_HALFSCREEN_WIDTH || set to 50% screen width | HILDON_SIZE_HALFSCREEN_WIDTH || set to 50% screen width
Line 29:
Line 27:



Hildon widgets allows to set their sizes in their construction functions, but in case you want to set the size of a GTK+ widget, Hildon also provides functions to do that: Hildon widgets allows to set their sizes in their construction functions, but in case you want to set the size of a GTK+ widget, Hildon also provides functions to do that:
  <source lang="python">
     GtkButton(size)      GtkButton(size)
     GtkToggleButton(size)      GtkToggleButton(size)
     GtkRadioButton(type_size, group)      GtkRadioButton(type_size, group)
     hildon_gtk_radio_button_new_from_widget(size, radio_group_member)      hildon_gtk_radio_button_new_from_widget(size, radio_group_member)
  </source>
=== UI Modes === == UI Modes ==
  



Hildon defines two modes in the UI that change the way user interacts with certain widgets. The main purpose of these modes is to enable direct manipulation of items, while still allowing user to select single or multiple items, when it is necessary. The following modes are supported: Hildon defines two modes in the UI that change the way user interacts with certain widgets. The main purpose of these modes is to enable direct manipulation of items, while still allowing user to select single or multiple items, when it is necessary. The following modes are supported:



Normal mode '''Normal mode'''
:It is the default mode. In lists and grids, tapping on an item causes a direct action. In views, this direct action could open a new subview to perform a certain action with the item. :It is the default mode. In lists and grids, tapping on an item causes a direct action. In views, this direct action could open a new subview to perform a certain action with the item.
Edit mode '''Edit mode'''
:Edit mode is used in views. The purpose of this mode is providing multiple selection functionality in list or grid and providing standard UI for editing single content item. :Edit mode is used in views. The purpose of this mode is providing multiple selection functionality in list or grid and providing standard UI for editing single content item.



Hildon provides the following functions to set mode for a treeview or icon view: Hildon provides the following functions to set mode for a treeview or icon view:
  <source lang="python">
     GtkTreeView(mode)      GtkTreeView(mode)
     GtkTreeView(mode, model)      GtkTreeView(mode, model)
Line 54:
Line 51:
     GtkIconView(mode, model)      GtkIconView(mode, model)
     hildon_gtk_icon_view_set_ui_mode(iconview, mode)      hildon_gtk_icon_view_set_ui_mode(iconview, mode)
  </source>
The enum HildonUIMode defines the following flags: The enum HildonUIMode defines the following flags:



* HILDON_UI_MODE_NORMAL * <code>HILDON_UI_MODE_NORMAL</code>
* HILDON_UI_MODE_EDIT * <code>HILDON_UI_MODE_EDIT</code>



When you use a list or grid in edit mode inside a window you should use a hildon.EditToolbar to control the edition and set the window to fullscreen, building an Edit subview. To know more about edit views you can check chapter toolbars. In that chapter you can check an example of HildonToolbar which uses the concepts explained above. When you use a list or grid in edit mode inside a window you should use a <code>hildon.EditToolbar</code> to control the edition and set the window to fullscreen, building an Edit subview. To know more about edit views you can check [[../Toolbars|the toolbar chapter]]. In that chapter you can check an example of <code>HildonToolbar</code> which uses the concepts explained above.



=== Seek bars === == Seek bars ==
  
The seek bars are useful to select a value from a range of predetermined values by adjusting the slider with a finger. These seek bars could be horizontal or vertical and are implemented using GtkVScale and GtkHScale. Thus, you can use this GTK+ widget in your Hildon application as seek bar but you should use following creation function instead of the GTK ones: 



The seek bars are useful to select a value from a range of predetermined values by adjusting the slider with a finger. These seek bars could be horizontal or vertical and are implemented using <code>GtkVScale</code> and <code>GtkHScale</code>. Thus, you can use this GTK+ widget in your Hildon application as seek bar but you should use following creation function instead of the GTK+ ones:
<source lang="python">
     GtkHScale()      GtkHScale()
     GtkVScale()      GtkVScale()
  </source>
Scales created by using these constructors has a hildonized behavior, meaning that when user tap or click in a point of the bar immediately jumps to the desired position. Scales created by using these constructors has a hildonized behavior, meaning that when user tap or click in a point of the bar immediately jumps to the desired position.



Line 76:
Line 73:



Hildon provides the following function to show a progress icon. This function applies to <code>hildon.Window</code> and <code>gtk.Dialog</code>. Hildon provides the following function to show a progress icon. This function applies to <code>hildon.Window</code> and <code>gtk.Dialog</code>.
  <source lang="python">
    def hildon_gtk_window_set_progress_indicator(window, state) def hildon_gtk_window_set_progress_indicator(window, state)
  </source>
The argument state should be 1 to show the indicator and 0 to hide it. The argument state should be 1 to show the indicator and 0 to hide it.



Here, a little example that sets a progress indicator in a GtkDialog. Click outside the dialog to close the example. Here, a little example that sets a progress indicator in a <code>GtkDialog</code>. Click outside the dialog to close the example.
<source lang="python">
# Based on C code from:
# "Hildon Tutorial" version 2009-04-28
# Example 8.1, "Adding a progress indicator to a dialog"



    # Based on C code from: import gtk
    # "Hildon Tutorial" version 2009-04-28 import hildon
    # Example 8.1, "Adding a progress indicator to a dialog" 
    
    import gtk 
    import hildon 
    
    def main(): 
        dialog = gtk.Dialog() 
        dialog.set_title("Performing a long task") 
        dialog.show_all() 
        hildon.hildon_gtk_window_set_progress_indicator(dialog, 1) 
        dialog.run() 
    
    if __name__ == "__main__": 
        main() 



def main():
    dialog = gtk.Dialog()
    dialog.set_title("Performing a long task")
    dialog.show_all()
    hildon.hildon_gtk_window_set_progress_indicator(dialog, 1)
    dialog.run()



if __name__ == "__main__":
    main()
</source>
Additionally, if you consider that aditional text information should be give to the user you could use an informational banner. Additionally, if you consider that aditional text information should be give to the user you could use an informational banner.






imported_>amigadave: Category:Python
2010-02-11T15:53:44Z
Category:Python

				
				
				
				
				
				← Older revision
				Revision as of 15:53, 11 February 2010
				
Line 104:
Line 104:



Another convenience way to indicate to users that a long operation is being performed is using the <code>gtk.ProgressBar</code> widget. This is the usual way in GTK+ applications and you can use them like you would use them in a GTK+ application. This widget is specially useful if you need to show the status of the operation. Another convenience way to indicate to users that a long operation is being performed is using the <code>gtk.ProgressBar</code> widget. This is the usual way in GTK+ applications and you can use them like you would use them in a GTK+ application. This widget is specially useful if you need to show the status of the operation.

[[Category:Python]]



imported_>danielwilms: PyMaemo/UITutorial/Additions to GTK+ moved to PyMaemo/UI tutorial/Additions to GTK+
2010-02-01T11:15:11Z
PyMaemo/UITutorial/Additions to GTK+ moved to PyMaemo/UI tutorial/Additions to GTK+

				
				← Older revision
				Revision as of 11:15, 1 February 2010
				
(No difference)



imported_>thomasvs: clarify where to find these constants.
2009-12-08T21:17:44Z
clarify where to find these constants.

				
				
				
				
				
				← Older revision
				Revision as of 21:17, 8 December 2009
				
Line 8:
Line 8:



Hildon defines the following sizes to be used as sizes for widgets such as buttons or entries in your Hildon application. Hildon defines the following sizes to be used as sizes for widgets such as buttons or entries in your Hildon application.

Note: these constants are all defined in the gtk module.



{| class="wikitable"   {| class="wikitable"  



imported_>thomasvs: funny typo
2009-12-08T21:14:29Z
funny typo

				
				
				
				
				
				← Older revision
				Revision as of 21:14, 8 December 2009
				
Line 3:
Line 3:
A Hildon application might use any Gtk widget but in some cases could be needed to adapt those widgets to get that they fit perfectly. A Hildon application might use any Gtk widget but in some cases could be needed to adapt those widgets to get that they fit perfectly.



Hildon provides a set of convenience functions to do that. The next sections explains these addictions. Hildon provides a set of convenience functions to do that. The next sections explains these additions.



=== Hildon Size Types === === Hildon Size Types ===



imported_>bruno_araujo: /* Progress indicators */
2009-10-16T13:20:53Z
Progress indicators

				
				
				
				
				
				← Older revision
				Revision as of 13:20, 16 October 2009
				
Line 73:
Line 73:
A convenience way to inform the user that a long-term task is being performed is to show a progress indicator icon in the window or dialog title. A convenience way to inform the user that a long-term task is being performed is to show a progress indicator icon in the window or dialog title.



Hildon provides the following function to show a progress icon. This function applies to hildon.Window and gtk.Dialog. Hildon provides the following function to show a progress icon. This function applies to <code>hildon.Window</code> and <code>gtk.Dialog</code>.



     def hildon_gtk_window_set_progress_indicator(window, state)      def hildon_gtk_window_set_progress_indicator(window, state)
Line 79:
Line 79:
The argument state should be 1 to show the indicator and 0 to hide it. The argument state should be 1 to show the indicator and 0 to hide it.



Here, a little example that sets a progress indicator in a GtkDialog. Here, a little example that sets a progress indicator in a GtkDialog. Click outside the dialog to close the example.



     # Based on C code from:      # Based on C code from:
Line 101:
Line 101:
Additionally, if you consider that aditional text information should be give to the user you could use an informational banner. Additionally, if you consider that aditional text information should be give to the user you could use an informational banner.



Another convenience way to indicate to users that a long operation is being performed is using the gtk.ProgressBar widget. This is the usual way in GTK+ applications and you can use them like you would use them in a GTK+ application. This widget is specially useful if you need to show the status of the operation. Another convenience way to indicate to users that a long operation is being performed is using the <code>gtk.ProgressBar</code> widget. This is the usual way in GTK+ applications and you can use them like you would use them in a GTK+ application. This widget is specially useful if you need to show the status of the operation.



imported_>bruno_araujo: /* UI Modes */
2009-10-09T16:27:05Z
UI Modes

				
				
				
				
				
				← Older revision
				Revision as of 16:27, 9 October 2009
				
Line 55:
Line 55:
The enum HildonUIMode defines the following flags: The enum HildonUIMode defines the following flags:



<code>HILDON_UI_MODE_NORMAL</code> * HILDON_UI_MODE_NORMAL
  * HILDON_UI_MODE_EDIT
<code>HILDON_UI_MODE_EDIT</code> 



When you use a list or grid in edit mode inside a window you should use a hildon.EditToolbar to control the edition and set the window to fullscreen, building an Edit subview. To know more about edit views you can check chapter toolbars. In that chapter you can check an example of HildonToolbar which uses the concepts explained above. When you use a list or grid in edit mode inside a window you should use a hildon.EditToolbar to control the edition and set the window to fullscreen, building an Edit subview. To know more about edit views you can check chapter toolbars. In that chapter you can check an example of HildonToolbar which uses the concepts explained above.




=== Seek bars === === Seek bars ===



imported_>bruno_araujo at 16:20, 9 October 2009
2009-10-09T16:20:21Z


				
				
				
				
				
				← Older revision
				Revision as of 16:20, 9 October 2009
				
Line 59:
Line 59:
<code>HILDON_UI_MODE_EDIT</code> <code>HILDON_UI_MODE_EDIT</code>



When you use a list or grid in edit mode inside a window you should use a <code>hildon.EditToolbar</code> to control the edition and set the window to fullscreen, building an Edit subview. To know more about edit views you can check chapter toolbars. In that chapter you can check an example of HildonToolbar which uses the concepts explained above. When you use a list or grid in edit mode inside a window you should use a hildon.EditToolbar to control the edition and set the window to fullscreen, building an Edit subview. To know more about edit views you can check chapter toolbars. In that chapter you can check an example of HildonToolbar which uses the concepts explained above.
 
 
=== Seek bars ===
 
The seek bars are useful to select a value from a range of predetermined values by adjusting the slider with a finger. These seek bars could be horizontal or vertical and are implemented using GtkVScale and GtkHScale. Thus, you can use this GTK+ widget in your Hildon application as seek bar but you should use following creation function instead of the GTK ones:
 
    GtkHScale()
    GtkVScale()
 
Scales created by using these constructors has a hildonized behavior, meaning that when user tap or click in a point of the bar immediately jumps to the desired position.
 
=== Progress indicators ===
 
A convenience way to inform the user that a long-term task is being performed is to show a progress indicator icon in the window or dialog title.
 
Hildon provides the following function to show a progress icon. This function applies to hildon.Window and gtk.Dialog.
 
    def hildon_gtk_window_set_progress_indicator(window, state)
 
The argument state should be 1 to show the indicator and 0 to hide it.
 
Here, a little example that sets a progress indicator in a GtkDialog.
 
    # Based on C code from:
    # "Hildon Tutorial" version 2009-04-28
    # Example 8.1, "Adding a progress indicator to a dialog"
    
    import gtk
    import hildon
    
    def main():
        dialog = gtk.Dialog()
        dialog.set_title("Performing a long task")
        dialog.show_all()
        hildon.hildon_gtk_window_set_progress_indicator(dialog, 1)
        dialog.run()
    
    if __name__ == "__main__":
        main()
 
 
Additionally, if you consider that aditional text information should be give to the user you could use an informational banner.
 
Another convenience way to indicate to users that a long operation is being performed is using the gtk.ProgressBar widget. This is the usual way in GTK+ applications and you can use them like you would use them in a GTK+ application. This widget is specially useful if you need to show the status of the operation.

← Older revision		Revision as of 10:52, 2 March 2011
Line 11:		Line 11:
	Note: these constants are all defined in the <code>gtk</code> module.		Note: these constants are all defined in the <code>gtk</code> module.

	{\| class="wikitable"		{\| class="wikitable"
			\|+ Hildon constants
	\|-		\|-
	! Constant !! Description		! Constant !! Description
	\|-		\|-
	\| HILDON_SIZE_HALFSCREEN_WIDTH \|\| set to 50% screen width		\| <code>HILDON_SIZE_HALFSCREEN_WIDTH</code> \|\| set to 50% screen width
	\|-		\|-
	\| HILDON_SIZE_FULLSCREEN_WIDTH \|\| set to 100% screen width		\| <code>HILDON_SIZE_FULLSCREEN_WIDTH</code> \|\| set to 100% screen width
	\|-		\|-
	\| HILDON_SIZE_AUTO_HEIGHT \|\| set to automatic height		\| <code>HILDON_SIZE_AUTO_HEIGHT</code> \|\| set to automatic height
	\|-		\|-
	\| HILDON_SIZE_FINGER_HEIGHT \|\| set to finger height		\| <code>HILDON_SIZE_FINGER_HEIGHT</code> \|\| set to finger height
	\|-		\|-
	\| HILDON_SIZE_THUMB_HEIGHT \|\| set to thumb height		\| <code>HILDON_SIZE_THUMB_HEIGHT</code> \|\| set to thumb height
	\|-		\|-
	\| HILDON_SIZE_AUTO \|\| set to automatic width and automatic height		\| <code>HILDON_SIZE_AUTO</code> \|\| set to automatic width and automatic height
	\|}		\|}

Line 35:		Line 36:
	hildon_gtk_radio_button_new_from_widget(size, radio_group_member)		hildon_gtk_radio_button_new_from_widget(size, radio_group_member)
	</source>		</source>

	== UI Modes ==		== UI Modes ==

← Older revision		Revision as of 11:37, 7 October 2010
Line 1:		Line 1:
			{{main\|Legacy Maemo 5 Documentation/Graphical UI Tutorial/Additions to GTK+}}

	A Hildon application might use any GTK+ widget but in some cases could be needed to adapt those widgets to get that they fit perfectly.		A Hildon application might use any GTK+ widget but in some cases could be needed to adapt those widgets to get that they fit perfectly.

← Older revision		Revision as of 09:15, 23 June 2010
Line 1:		Line 1:
	~~== Additions to GTK+ ==~~		A Hildon application might use any GTK+ widget but in some cases could be needed to adapt those widgets to get that they fit perfectly.

	A Hildon application might use any ~~Gtk~~ widget but in some cases could be needed to adapt those widgets to get that they fit perfectly.

	Hildon provides a set of convenience functions to do that. The next sections explains these additions.		Hildon provides a set of convenience functions to do that. The next sections explains these additions.

	=== Hildon Size Types ===		== Hildon Size Types ==

	Hildon defines the following sizes to be used as sizes for widgets such as buttons or entries in your Hildon application.		Hildon defines the following sizes to be used as sizes for widgets such as buttons or entries in your Hildon application.

	Note: these constants are all defined in the gtk module.		Note: these constants are all defined in the <code>gtk</code> module.

	{\| class="wikitable"		{\| class="wikitable"
	\|-		\|-
	! ~~Const~~ !! Description		! Constant !! Description
	\|-		\|-
	\| HILDON_SIZE_HALFSCREEN_WIDTH \|\| set to 50% screen width		\| HILDON_SIZE_HALFSCREEN_WIDTH \|\| set to 50% screen width
Line 29:		Line 27:

	Hildon widgets allows to set their sizes in their construction functions, but in case you want to set the size of a GTK+ widget, Hildon also provides functions to do that:		Hildon widgets allows to set their sizes in their construction functions, but in case you want to set the size of a GTK+ widget, Hildon also provides functions to do that:
			<source lang="python">
	GtkButton(size)		GtkButton(size)
	GtkToggleButton(size)		GtkToggleButton(size)
	GtkRadioButton(type_size, group)		GtkRadioButton(type_size, group)
	hildon_gtk_radio_button_new_from_widget(size, radio_group_member)		hildon_gtk_radio_button_new_from_widget(size, radio_group_member)
			</source>
	=== UI Modes ===		== UI Modes ==


	Hildon defines two modes in the UI that change the way user interacts with certain widgets. The main purpose of these modes is to enable direct manipulation of items, while still allowing user to select single or multiple items, when it is necessary. The following modes are supported:		Hildon defines two modes in the UI that change the way user interacts with certain widgets. The main purpose of these modes is to enable direct manipulation of items, while still allowing user to select single or multiple items, when it is necessary. The following modes are supported:

	Normal mode		'''Normal mode'''
	:It is the default mode. In lists and grids, tapping on an item causes a direct action. In views, this direct action could open a new subview to perform a certain action with the item.		:It is the default mode. In lists and grids, tapping on an item causes a direct action. In views, this direct action could open a new subview to perform a certain action with the item.
	Edit mode		'''Edit mode'''
	:Edit mode is used in views. The purpose of this mode is providing multiple selection functionality in list or grid and providing standard UI for editing single content item.		:Edit mode is used in views. The purpose of this mode is providing multiple selection functionality in list or grid and providing standard UI for editing single content item.

	Hildon provides the following functions to set mode for a treeview or icon view:		Hildon provides the following functions to set mode for a treeview or icon view:
			<source lang="python">
	GtkTreeView(mode)		GtkTreeView(mode)
	GtkTreeView(mode, model)		GtkTreeView(mode, model)
Line 54:		Line 51:
	GtkIconView(mode, model)		GtkIconView(mode, model)
	hildon_gtk_icon_view_set_ui_mode(iconview, mode)		hildon_gtk_icon_view_set_ui_mode(iconview, mode)
			</source>
	The enum HildonUIMode defines the following flags:		The enum HildonUIMode defines the following flags:

	* HILDON_UI_MODE_NORMAL		* <code>HILDON_UI_MODE_NORMAL</code>
	* HILDON_UI_MODE_EDIT		* <code>HILDON_UI_MODE_EDIT</code>

	When you use a list or grid in edit mode inside a window you should use a hildon.EditToolbar to control the edition and set the window to fullscreen, building an Edit subview. To know more about edit views you can check chapter ~~toolbars~~. In that chapter you can check an example of HildonToolbar which uses the concepts explained above.		When you use a list or grid in edit mode inside a window you should use a <code>hildon.EditToolbar</code> to control the edition and set the window to fullscreen, building an Edit subview. To know more about edit views you can check [[../Toolbars\|the toolbar chapter]]. In that chapter you can check an example of <code>HildonToolbar</code> which uses the concepts explained above.

	=== Seek bars ===		== Seek bars ==

	The seek bars are useful to select a value from a range of predetermined values by adjusting the slider with a finger. These seek bars could be horizontal or vertical and are implemented using GtkVScale and GtkHScale. Thus, you can use this GTK+ widget in your Hildon application as seek bar but you should use following creation function instead of the GTK ones:

			The seek bars are useful to select a value from a range of predetermined values by adjusting the slider with a finger. These seek bars could be horizontal or vertical and are implemented using <code>GtkVScale</code> and <code>GtkHScale</code>. Thus, you can use this GTK+ widget in your Hildon application as seek bar but you should use following creation function instead of the GTK+ ones:
			<source lang="python">
	GtkHScale()		GtkHScale()
	GtkVScale()		GtkVScale()
			</source>
	Scales created by using these constructors has a hildonized behavior, meaning that when user tap or click in a point of the bar immediately jumps to the desired position.		Scales created by using these constructors has a hildonized behavior, meaning that when user tap or click in a point of the bar immediately jumps to the desired position.

Line 76:		Line 73:

	Hildon provides the following function to show a progress icon. This function applies to <code>hildon.Window</code> and <code>gtk.Dialog</code>.		Hildon provides the following function to show a progress icon. This function applies to <code>hildon.Window</code> and <code>gtk.Dialog</code>.
			<source lang="python">
	def hildon_gtk_window_set_progress_indicator(window, state)		def hildon_gtk_window_set_progress_indicator(window, state)
			</source>
	The argument state should be 1 to show the indicator and 0 to hide it.		The argument state should be 1 to show the indicator and 0 to hide it.

	Here, a little example that sets a progress indicator in a GtkDialog. Click outside the dialog to close the example.		Here, a little example that sets a progress indicator in a <code>GtkDialog</code>. Click outside the dialog to close the example.
			<source lang="python">
			# Based on C code from:
			# "Hildon Tutorial" version 2009-04-28
			# Example 8.1, "Adding a progress indicator to a dialog"

	~~# Based on C code from:~~		import gtk
	~~# "Hildon Tutorial" version 2009-04-28~~		import hildon
	~~# Example 8.1, "Adding a progress indicator to a dialog"~~

	import gtk
	import hildon

	~~def main():~~
	~~dialog = gtk.Dialog()~~
	~~dialog.set_title("Performing a long task")~~
	~~dialog.show_all()~~
	~~hildon.hildon_gtk_window_set_progress_indicator(dialog, 1)~~
	~~dialog.run()~~

	~~if __name__ == "__main__":~~
	~~main()~~

			def main():
			dialog = gtk.Dialog()
			dialog.set_title("Performing a long task")
			dialog.show_all()
			hildon.hildon_gtk_window_set_progress_indicator(dialog, 1)
			dialog.run()

			if __name__ == "__main__":
			main()
			</source>
	Additionally, if you consider that aditional text information should be give to the user you could use an informational banner.		Additionally, if you consider that aditional text information should be give to the user you could use an informational banner.

← Older revision		Revision as of 15:53, 11 February 2010
Line 104:		Line 104:

	Another convenience way to indicate to users that a long operation is being performed is using the <code>gtk.ProgressBar</code> widget. This is the usual way in GTK+ applications and you can use them like you would use them in a GTK+ application. This widget is specially useful if you need to show the status of the operation.		Another convenience way to indicate to users that a long operation is being performed is using the <code>gtk.ProgressBar</code> widget. This is the usual way in GTK+ applications and you can use them like you would use them in a GTK+ application. This widget is specially useful if you need to show the status of the operation.

			[[Category:Python]]

← Older revision	Revision as of 11:15, 1 February 2010
(No difference)

← Older revision		Revision as of 21:17, 8 December 2009
Line 8:		Line 8:

	Hildon defines the following sizes to be used as sizes for widgets such as buttons or entries in your Hildon application.		Hildon defines the following sizes to be used as sizes for widgets such as buttons or entries in your Hildon application.

			Note: these constants are all defined in the gtk module.

	{\| class="wikitable"		{\| class="wikitable"

← Older revision		Revision as of 21:14, 8 December 2009
Line 3:		Line 3:
	A Hildon application might use any Gtk widget but in some cases could be needed to adapt those widgets to get that they fit perfectly.		A Hildon application might use any Gtk widget but in some cases could be needed to adapt those widgets to get that they fit perfectly.

	Hildon provides a set of convenience functions to do that. The next sections explains these ~~addictions~~.		Hildon provides a set of convenience functions to do that. The next sections explains these additions.

	=== Hildon Size Types ===		=== Hildon Size Types ===

← Older revision		Revision as of 13:20, 16 October 2009
Line 73:		Line 73:
	A convenience way to inform the user that a long-term task is being performed is to show a progress indicator icon in the window or dialog title.		A convenience way to inform the user that a long-term task is being performed is to show a progress indicator icon in the window or dialog title.

	Hildon provides the following function to show a progress icon. This function applies to hildon.Window and gtk.Dialog.		Hildon provides the following function to show a progress icon. This function applies to <code>hildon.Window</code> and <code>gtk.Dialog</code>.

	def hildon_gtk_window_set_progress_indicator(window, state)		def hildon_gtk_window_set_progress_indicator(window, state)
Line 79:		Line 79:
	The argument state should be 1 to show the indicator and 0 to hide it.		The argument state should be 1 to show the indicator and 0 to hide it.

	Here, a little example that sets a progress indicator in a GtkDialog.		Here, a little example that sets a progress indicator in a GtkDialog. Click outside the dialog to close the example.

	# Based on C code from:		# Based on C code from:
Line 101:		Line 101:
	Additionally, if you consider that aditional text information should be give to the user you could use an informational banner.		Additionally, if you consider that aditional text information should be give to the user you could use an informational banner.

	Another convenience way to indicate to users that a long operation is being performed is using the gtk.ProgressBar widget. This is the usual way in GTK+ applications and you can use them like you would use them in a GTK+ application. This widget is specially useful if you need to show the status of the operation.		Another convenience way to indicate to users that a long operation is being performed is using the <code>gtk.ProgressBar</code> widget. This is the usual way in GTK+ applications and you can use them like you would use them in a GTK+ application. This widget is specially useful if you need to show the status of the operation.

← Older revision		Revision as of 16:27, 9 October 2009
Line 55:		Line 55:
	The enum HildonUIMode defines the following flags:		The enum HildonUIMode defines the following flags:

	~~<code>~~HILDON_UI_MODE_NORMAL~~</code>~~		* HILDON_UI_MODE_NORMAL
			* HILDON_UI_MODE_EDIT
	~~<code>~~HILDON_UI_MODE_EDIT~~</code>~~

	When you use a list or grid in edit mode inside a window you should use a hildon.EditToolbar to control the edition and set the window to fullscreen, building an Edit subview. To know more about edit views you can check chapter toolbars. In that chapter you can check an example of HildonToolbar which uses the concepts explained above.		When you use a list or grid in edit mode inside a window you should use a hildon.EditToolbar to control the edition and set the window to fullscreen, building an Edit subview. To know more about edit views you can check chapter toolbars. In that chapter you can check an example of HildonToolbar which uses the concepts explained above.


	=== Seek bars ===		=== Seek bars ===

← Older revision		Revision as of 16:20, 9 October 2009
Line 59:		Line 59:
	<code>HILDON_UI_MODE_EDIT</code>		<code>HILDON_UI_MODE_EDIT</code>

	When you use a list or grid in edit mode inside a window you should use a ~~<code>~~hildon.EditToolbar~~</code>~~ to control the edition and set the window to fullscreen, building an Edit subview. To know more about edit views you can check chapter toolbars. In that chapter you can check an example of HildonToolbar which uses the concepts explained above.		When you use a list or grid in edit mode inside a window you should use a hildon.EditToolbar to control the edition and set the window to fullscreen, building an Edit subview. To know more about edit views you can check chapter toolbars. In that chapter you can check an example of HildonToolbar which uses the concepts explained above.


			=== Seek bars ===

			The seek bars are useful to select a value from a range of predetermined values by adjusting the slider with a finger. These seek bars could be horizontal or vertical and are implemented using GtkVScale and GtkHScale. Thus, you can use this GTK+ widget in your Hildon application as seek bar but you should use following creation function instead of the GTK ones:

			GtkHScale()
			GtkVScale()

			Scales created by using these constructors has a hildonized behavior, meaning that when user tap or click in a point of the bar immediately jumps to the desired position.

			=== Progress indicators ===

			A convenience way to inform the user that a long-term task is being performed is to show a progress indicator icon in the window or dialog title.

			Hildon provides the following function to show a progress icon. This function applies to hildon.Window and gtk.Dialog.

			def hildon_gtk_window_set_progress_indicator(window, state)

			The argument state should be 1 to show the indicator and 0 to hide it.

			Here, a little example that sets a progress indicator in a GtkDialog.

			# Based on C code from:
			# "Hildon Tutorial" version 2009-04-28
			# Example 8.1, "Adding a progress indicator to a dialog"

			import gtk
			import hildon

			def main():
			dialog = gtk.Dialog()
			dialog.set_title("Performing a long task")
			dialog.show_all()
			hildon.hildon_gtk_window_set_progress_indicator(dialog, 1)
			dialog.run()

			if __name__ == "__main__":
			main()


			Additionally, if you consider that aditional text information should be give to the user you could use an informational banner.

			Another convenience way to indicate to users that a long operation is being performed is using the gtk.ProgressBar widget. This is the usual way in GTK+ applications and you can use them like you would use them in a GTK+ application. This widget is specially useful if you need to show the status of the operation.