PyMaemo/UI tutorial/Controls - Revision history

amigadave: add C documentation references

amigadave — Thu, 07 Oct 2010 11:37:08 GMT

add C documentation references

← Older revision		Revision as of 11:37, 7 October 2010
Line 1:		Line 1:
		+	{{main\|Legacy Maemo 5 Documentation/Graphical UI Tutorial/Controls}}
		+
	Hildon provides a set of controls specially designed for touchscreens that allows to build simple and easy-to-use interfaces. This chapter explains how to use these widgets.		Hildon provides a set of controls specially designed for touchscreens that allows to build simple and easy-to-use interfaces. This chapter explains how to use these widgets.

amigadave: use and


amigadave — Wed, 23 Jun 2010 09:01:16 GMT
use <source> and <code>
Show changes



amigadave: Category:Python
amigadave — Thu, 11 Feb 2010 15:54:27 GMT
Category:Python

		
		
		
		
		
		
		← Older revision
		Revision as of 15:54, 11 February 2010
		
		Line 291:
Line 291:
          if response == gtk.RESPONSE_DELETE_EVENT:           if response == gtk.RESPONSE_DELETE_EVENT:
              print "show_information_note: gtk.RESPONSE_DELETE_EVENT"               print "show_information_note: gtk.RESPONSE_DELETE_EVENT"
  + 
  + [[Category:Python]]




danielwilms: PyMaemo/UITutorial/Controls moved to PyMaemo/UI tutorial/Controls
danielwilms — Mon, 01 Feb 2010 11:14:21 GMT
PyMaemo/UITutorial/Controls moved to PyMaemo/UI tutorial/Controls

		
		
		
		
		
		
		← Older revision
		Revision as of 11:14, 1 February 2010
		
		



renatofilho: /* Confirmation Notes */
renatofilho — Fri, 09 Oct 2009 17:53:20 GMT
Confirmation Notes
Show changes


renatofilho: /* Information Notes */
renatofilho — Fri, 09 Oct 2009 17:47:14 GMT
Information Notes

		
		
		
		
		
		
		← Older revision
		Revision as of 17:47, 9 October 2009
		
		Line 251:
Line 251:
 '''Example 7.6. Example of a Hildon information note'''  '''Example 7.6. Example of a Hildon information note'''
  
-  <tt><span>'''<span><font color="#0000FF">static</font></span>'''</span> <span><font color="#009900">void</font></span> +     def show_information_note(parent):
-  <span>'''<span><font color="#000000">show_information_note</font></span>'''</span>                          <span><font color="#990000">(</font></span>GtkWidget <span><font color="#990000"><nowiki>*</nowiki></font></span>parent<span><font color="#990000">)</font></span> +         note = hildon.hildon_note_new_information(parent, \
-  <span><font color="#FF0000">{</font></span> +             "Lorem ipsum dolor sit amet, consectetur adipiscing elit." \
-    GtkWidget <span><font color="#990000"><nowiki>*</nowiki></font></span>window<span><font color="#990000">,</font></span> <span><font color="#990000"><nowiki>*</nowiki></font></span>note<span><font color="#990000"><nowiki>;</nowiki></font></span> +             "Maecenas tristique dictum est. Aenean rhoncus aliquam mi." \
-    gint response<span><font color="#990000"><nowiki>;</nowiki></font></span> +             "In hac habitasse platea dictumst.")
-    note <span><font color="#990000"><nowiki>=</nowiki></font></span> <span>'''<span><font color="#000000">hildon_note_new_information</font></span>'''</span> <span><font color="#990000">(</font></span>NULL<span><font color="#990000">,</font></span> +     
-      <span><font color="#FF0000">"Lorem ipsum dolor sit amet, consectetur adipiscing elit."</font></span> +         response = gtk.Dialog.run(note)
-      <span><font color="#FF0000">"Maecenas tristique dictum est. Aenean rhoncus aliquam mi."</font></span> +     
-      <span><font color="#FF0000">"In hac habitasse platea dictumst."</font></span><span><font color="#990000">);</font></span> +         if response == gtk.RESPONSE_DELETE_EVENT:
-    response <span><font color="#990000"><nowiki>=</nowiki></font></span> <span>'''<span><font color="#000000">gtk_dialog_run</font></span>'''</span> <span><font color="#990000">(</font></span><span>'''<span><font color="#000000">GTK_DIALOG</font></span>'''</span> <span><font color="#990000">(</font></span>note<span><font color="#990000">));</font></span> +             print "show_information_note: gtk.RESPONSE_DELETE_EVENT"
-    <span>'''<span><font color="#0000FF">if</font></span>'''</span> <span><font color="#990000">(</font></span>response <span><font color="#990000"><nowiki>==</nowiki></font></span> GTK_RESPONSE_DELETE_EVENT<span><font color="#990000">)</font></span> + 
-      <span>'''<span><font color="#000000">g_debug</font></span>'''</span> <span><font color="#990000">(</font></span><span><font color="#FF0000">"%s: GTK_RESPONSE_DELETE_EVENT"</font></span><span><font color="#990000">,</font></span> __FUNCTION__<span><font color="#990000">);</font></span> + 
-    <span>'''<span><font color="#000000">gtk_object_destroy</font></span>'''</span> <span><font color="#990000">(</font></span><span>'''<span><font color="#000000">GTK_OBJECT</font></span>'''</span> <span><font color="#990000">(</font></span>note<span><font color="#990000">));</font></span> + 
-  <span><font color="#FF0000">}</font></span> + 
-  </tt> + 
  
 ====Confirmation Notes====  ====Confirmation Notes====




renatofilho: /* Notes */
renatofilho — Fri, 09 Oct 2009 17:45:55 GMT
Notes

		
		
		
		
		
		
		← Older revision
		Revision as of 17:45, 9 October 2009
		
		Line 236:
Line 236:
 The HildonNote widget provides functions to create and show different types of notes: information notes, confirmation notes and cancel notes.  The HildonNote widget provides functions to create and show different types of notes: information notes, confirmation notes and cancel notes.
  
-  <tt>GtkWidget<span><font color="#990000"><nowiki>*</nowiki></font></span>  <span>'''<span><font color="#000000">hildon_note_new_information</font></span>'''</span>     <span><font color="#990000">(</font></span>GtkWindow <span><font color="#990000"><nowiki>*</nowiki></font></span>parent<span><font color="#990000">,</font></span> +     def hildon_note_new_information(parent, description)
-                                               <span>'''<span><font color="#0000FF">const</font></span>'''</span> gchar <span><font color="#990000"><nowiki>*</nowiki></font></span>description<span><font color="#990000">);</font></span> +      def hildon_note_new_information_with_icon_name(parent, description, icon_name)
-  GtkWidget<span><font color="#990000"><nowiki>*</nowiki></font></span>  <span>'''<span><font color="#000000">hildon_note_new_confirmation</font></span>'''</span>    <span><font color="#990000">(</font></span>GtkWindow <span><font color="#990000"><nowiki>*</nowiki></font></span>parent<span><font color="#990000">,</font></span> +     def hildon_note_new_confirmation(parent, description)
-                                               <span>'''<span><font color="#0000FF">const</font></span>'''</span> gchar <span><font color="#990000"><nowiki>*</nowiki></font></span>description<span><font color="#990000">);</font></span> +     def hildon_note_new_confirmation_with_icon_name(parent, description,  icon_name)
-  GtkWidget<span><font color="#990000"><nowiki>*</nowiki></font></span>  hildon_note_new_confirmation_add_buttons +     def hildon_note_new_cancel_with_progress_bar(parent, description, progressbar)
-                                              <span><font color="#990000">(</font></span>GtkWindow <span><font color="#990000"><nowiki>*</nowiki></font></span>parent<span><font color="#990000">,</font></span> + 
-                                               <span>'''<span><font color="#0000FF">const</font></span>'''</span> gchar <span><font color="#990000"><nowiki>*</nowiki></font></span>description<span><font color="#990000">,</font></span> + 
-                                               <span><font color="#990000">...);</font></span> + 
-  GtkWidget<span><font color="#990000"><nowiki>*</nowiki></font></span>  hildon_note_new_cancel_with_progress_bar + 
-                                              <span><font color="#990000">(</font></span>GtkWindow <span><font color="#990000"><nowiki>*</nowiki></font></span>parent<span><font color="#990000">,</font></span> + 
-                                               <span>'''<span><font color="#0000FF">const</font></span>'''</span> gchar <span><font color="#990000"><nowiki>*</nowiki></font></span>description<span><font color="#990000">,</font></span> + 
-                                               GtkProgressBar <span><font color="#990000"><nowiki>*</nowiki></font></span>progressbar<span><font color="#990000">);</font></span> + 
-  </tt> + 
  
 Every function to create notes receives as a parameter the parent window of the newly created note. This is important in order to allow the window manager to handle the windows properly.  Every function to create notes receives as a parameter the parent window of the newly created note. This is important in order to allow the window manager to handle the windows properly.




renatofilho: /* Warning */
renatofilho — Fri, 09 Oct 2009 17:42:44 GMT
Warning

		
		
		
		
		
		
		← Older revision
		Revision as of 17:42, 9 October 2009
		
		Line 216:
Line 216:
 The period of time after the banner automatically disappear is stored in the property "timeout" (in miliseconds). A convenience function to set this property is provided:  The period of time after the banner automatically disappear is stored in the property "timeout" (in miliseconds). A convenience function to set this property is provided:
  
-  <tt><span><font color="#009900">void</font></span>        <span>'''<span><font color="#000000">hildon_banner_set_timeout</font></span>'''</span>       <span><font color="#990000">(</font></span>HildonBanner <span><font color="#990000"><nowiki>*</nowiki></font></span>self<span><font color="#990000">,</font></span> + hildon.Banner.set_timeout(timeout)
-                                               guint timeout<span><font color="#990000">);</font></span> + 
-  </tt> + 
  
 Here is a simple example showing how to setup and show an informational banner.  Here is a simple example showing how to setup and show an informational banner.
Line 224:
Line 222:
 '''Example 7.5. Setting up an informational banner'''  '''Example 7.5. Setting up an informational banner'''
  
-  <tt>    GtkWidget<span><font color="#990000"><nowiki>*</nowiki></font></span> banner<span><font color="#990000"><nowiki>;</nowiki></font></span> +     # Create a banner with a markup
-      <span>''<span><font color="#9A1900">/* Create a banner with a markup */</font></span>''</span> +     banner = hildon.Banner.show_information_with_markup(widget, None,   "<b>Information banner</b>")
-      banner <span><font color="#990000"><nowiki>=</nowiki></font></span> <span>'''<span><font color="#000000">hildon_banner_show_information_with_markup</font></span>'''</span> <span><font color="#990000">(</font></span>widget<span><font color="#990000">,</font></span> +     banner.set_timeout(9000)
-                                                           NULL<span><font color="#990000">,</font></span> + 
-                                                           <span><font color="#FF0000">"&lt;b&gt;Information banner&lt;/b&gt;"</font></span><span><font color="#990000">);</font></span> + 
-      <span>'''<span><font color="#000000">hildon_banner_set_timeout</font></span>'''</span> <span><font color="#990000">(</font></span><span>'''<span><font color="#000000">HILDON_BANNER</font></span>'''</span> <span><font color="#990000">(</font></span>banner<span><font color="#990000">),</font></span> <span><font color="#993399">9000</font></span><span><font color="#990000">);</font></span> + 
-  </tt> + 
  
 ===Note===  ===Note===




renatofilho: /* Banners */
renatofilho — Fri, 09 Oct 2009 17:41:59 GMT
Banners

		
		
		
		
		
		
		← Older revision
		Revision as of 17:41, 9 October 2009
		
		Line 209:
Line 209:
 Function <code>show_informationf()</code> shows a banner which displays the text given by the printf-like formated string applied to the parameters that the rest of the function's arguments represent.  Function <code>show_informationf()</code> shows a banner which displays the text given by the printf-like formated string applied to the parameters that the rest of the function's arguments represent.
  
- You can also apply a Pango markup and add some attributes to the displayed text. To do that, either use <code>show_information_with_markup()</code> to create the banner or setup the markup by calling <code>set_markup()</code> after the initialization. [@@COMMENT@@ LINK TO PANGO MARKUP] + You can also apply a Pango markup and add some attributes to the displayed text. To do that, either use <code>show_information_with_markup()</code> to create the banner or setup the markup by calling <code>set_markup()</code> after the initialization
  
 ===Warning===  ===Warning===




renatofilho: /* Banners */
renatofilho — Fri, 09 Oct 2009 17:41:03 GMT
Banners

		
		
		
		
		
		
		← Older revision
		Revision as of 17:41, 9 October 2009
		
		Line 198:
Line 198:
 To create and show a banner, use the following function:  To create and show a banner, use the following function:
  
-  <tt>GtkWidget<span><font color="#990000"><nowiki>*</nowiki></font></span>  <span>'''<span><font color="#000000">hildon_banner_show_information</font></span>'''</span>  <span><font color="#990000">(</font></span>GtkWidget <span><font color="#990000"><nowiki>*</nowiki></font></span>widget<span><font color="#990000">,</font></span> +     banner = hildon.hildon_banner_show_information(widget, icon_name, text)
-                                               <span>'''<span><font color="#0000FF">const</font></span>'''</span> gchar <span><font color="#990000"><nowiki>*</nowiki></font></span>icon_name<span><font color="#990000">,</font></span> +     
-                                               <span>'''<span><font color="#0000FF">const</font></span>'''</span> gchar <span><font color="#990000"><nowiki>*</nowiki></font></span>text<span><font color="#990000">);</font></span> +     banner = hildon.hildon_banner_show_information_with_markup(widget, icon_name, markup)
-  GtkWidget<span><font color="#990000"><nowiki>*</nowiki></font></span>  <span>'''<span><font color="#000000">hildon_banner_show_informationf</font></span>'''</span> <span><font color="#990000">(</font></span>GtkWidget <span><font color="#990000"><nowiki>*</nowiki></font></span>widget<span><font color="#990000">,</font></span> +  
-                                               <span>'''<span><font color="#0000FF">const</font></span>'''</span> gchar <span><font color="#990000"><nowiki>*</nowiki></font></span>icon_name<span><font color="#990000">,</font></span> + 
-                                               <span>'''<span><font color="#0000FF">const</font></span>'''</span> gchar <span><font color="#990000"><nowiki>*</nowiki></font></span>format<span><font color="#990000">,</font></span> + 
-                                               <span><font color="#990000">...);</font></span> + 
-  GtkWidget<span><font color="#990000"><nowiki>*</nowiki></font></span>  hildon_banner_show_information_with_markup + 
-                                              <span><font color="#990000">(</font></span>GtkWidget <span><font color="#990000"><nowiki>*</nowiki></font></span>widget<span><font color="#990000">,</font></span> + 
-                                               <span>'''<span><font color="#0000FF">const</font></span>'''</span> gchar <span><font color="#990000"><nowiki>*</nowiki></font></span>icon_name<span><font color="#990000">,</font></span> + 
-                                               <span>'''<span><font color="#0000FF">const</font></span>'''</span> gchar <span><font color="#990000"><nowiki>*</nowiki></font></span>markup<span><font color="#990000">);</font></span> + 
-  </tt> + 
  
 All functions above require a widget as an argument that must be a pointer to the owner widget of the banner. Usually, the owner is the window that represents the currently displayed view.  All functions above require a widget as an argument that must be a pointer to the owner widget of the banner. Usually, the owner is the window that represents the currently displayed view.
  
- Function <code>hildon_banner_show_information()</code> shows a banner with the given text. + Function <code>show_information()</code> shows a banner with the given text.
  
- Function <code>hildon_banner_show_informationf()</code> shows a banner which displays the text given by the printf-like formated string applied to the parameters that the rest of the function's arguments represent. + Function <code>show_informationf()</code> shows a banner which displays the text given by the printf-like formated string applied to the parameters that the rest of the function's arguments represent.
  
- You can also apply a Pango markup and add some attributes to the displayed text. To do that, either use <code>hildon_banner_show_information_with_markup()</code> to create the banner or setup the markup by calling <code>hildon_banner_set_markup()</code> after the initialization. [@@COMMENT@@ LINK TO PANGO MARKUP] + You can also apply a Pango markup and add some attributes to the displayed text. To do that, either use <code>show_information_with_markup()</code> to create the banner or setup the markup by calling <code>set_markup()</code> after the initialization. [@@COMMENT@@ LINK TO PANGO MARKUP]
  
 ===Warning===  ===Warning===

← Older revision		Revision as of 15:54, 11 February 2010
Line 291:		Line 291:
	if response == gtk.RESPONSE_DELETE_EVENT:		if response == gtk.RESPONSE_DELETE_EVENT:
	print "show_information_note: gtk.RESPONSE_DELETE_EVENT"		print "show_information_note: gtk.RESPONSE_DELETE_EVENT"
		+
		+	[[Category:Python]]

← Older revision		Revision as of 17:47, 9 October 2009
Line 251:		Line 251:
	'''Example 7.6. Example of a Hildon information note'''		'''Example 7.6. Example of a Hildon information note'''

-	~~<tt><span>'''<span><font color="#0000FF">static</font></span>'''</span> <span><font color="#009900">void</font></span>~~	+	def show_information_note(parent):
-	~~<span>'''<span><font color="#000000">~~show_information_note~~</font></span>'''</span> <span><font color="#990000">~~(~~</font></span>GtkWidget <span><font color="#990000"><nowiki>*</nowiki></font></span>~~parent~~<span><font color="#990000">~~)~~</font></span>~~	+	note = hildon.hildon_note_new_information(parent, \
-	~~<span><font color="#FF0000">{</font></span>~~	+	"Lorem ipsum dolor sit amet, consectetur adipiscing elit." \
-	~~GtkWidget <span><font color="#990000"><nowiki></nowiki></font></span>window<span><font color="#990000">,</font></span> <span><font color="#990000"><nowiki></nowiki></font></span>~~note~~<span><font color~~=~~"#990000"><nowiki>;</nowiki></font></span>~~	+	"Maecenas tristique dictum est. Aenean rhoncus aliquam mi." \
-	~~gint response<span><font color="#990000"><nowiki>;</nowiki></font></span>~~	+	"In hac habitasse platea dictumst.")
-	~~note <span><font color="#990000"><nowiki>=</nowiki></font></span> <span>'''<span><font color="#000000">~~hildon_note_new_information~~</font></span>'''</span> <span><font color="#990000">~~(~~</font></span>NULL<span><font color="#990000">~~,~~</font></span>~~	+
-	~~<span><font color="#FF0000">~~"Lorem ipsum dolor sit amet, consectetur adipiscing elit."~~</font></span>~~	+	response = gtk.Dialog.run(note)
-	~~<span><font color="#FF0000">~~"Maecenas tristique dictum est. Aenean rhoncus aliquam mi."~~</font></span>~~	+
-	~~<span><font color="#FF0000">~~"In hac habitasse platea dictumst."~~</font></span><span><font color="#990000">~~)~~;</font></span>~~	+	if response == gtk.RESPONSE_DELETE_EVENT:
-	response ~~<span><font color~~=~~"#990000"><nowiki>=</nowiki></font></span> <span>'''<span><font color="#000000">gtk_dialog_run</font></span>'''</span> <span><font color="#990000">~~(~~</font></span><span>'''<span><font color="#000000">GTK_DIALOG</font></span>'''</span> <span><font color="#990000">(</font></span>~~note~~<span><font color="#990000">~~)~~);</font></span>~~	+	print "show_information_note: gtk.RESPONSE_DELETE_EVENT"
-	~~<span>'''<span><font color="#0000FF">~~if~~</font></span>'''</span> <span><font color="#990000">(</font></span>~~response ~~<span><font color~~=~~"#990000"><nowiki>~~=~~=</nowiki></font></span> GTK_RESPONSE_DELETE_EVENT<span><font color="#990000">)</font></span>~~	+
-	~~<span>'''<span><font color=~~"~~#000000">g_debug</font></span>'''</span> <span><font color="#990000">(</font></span><span><font color="#FF0000">"%s~~: ~~GTK_RESPONSE_DELETE_EVENT~~"~~</font></span><span><font color="#990000">,</font></span> __FUNCTION__<span><font color="#990000">);</font></span>~~	+
-	<span>'''<span><font color="#000000">gtk_object_destroy</font></span>'''</span> <span><font color="#990000">(</font></span><span>'''<span><font color="#000000">GTK_OBJECT</font></span>'''</span> <span><font color="#990000">(</font></span>note<span><font color="#990000">));</font></span>	+
-	~~<span><font color="#FF0000">}</font></span>~~	+
-	~~</tt>~~	+

	====Confirmation Notes====		====Confirmation Notes====

← Older revision		Revision as of 17:45, 9 October 2009
Line 236:		Line 236:
	The HildonNote widget provides functions to create and show different types of notes: information notes, confirmation notes and cancel notes.		The HildonNote widget provides functions to create and show different types of notes: information notes, confirmation notes and cancel notes.

-	~~<tt>GtkWidget<span><font color="#990000"><nowiki></nowiki></font></span> <span>'''<span><font color="#000000">~~hildon_note_new_information~~</font></span>'''</span>~~ ~~<span><font color="#990000">~~(~~</font></span>GtkWindow <span><font color="#990000"><nowiki></nowiki></font></span>~~parent~~<span><font color="#990000">~~,~~</font></span>~~	+	def hildon_note_new_information(parent, description)
-	~~<span>'''<span><font color="#0000FF">const</font></span>'''</span> gchar <span><font color="#990000"><nowiki>*</nowiki></font></span>~~description~~<span><font color="#990000">~~)~~;</font></span>~~	+	def hildon_note_new_information_with_icon_name(parent, description, icon_name)
-	~~GtkWidget<span><font color="#990000"><nowiki></nowiki></font></span> <span>'''<span><font color="#000000">~~hildon_note_new_confirmation~~</font></span>'''</span> <span><font color="#990000">~~(~~</font></span>GtkWindow <span><font color="#990000"><nowiki></nowiki></font></span>~~parent~~<span><font color="#990000">~~,~~</font></span>~~	+	def hildon_note_new_confirmation(parent, description)
-	~~<span>'''<span><font color="#0000FF">const</font></span>'''</span> gchar <span><font color="#990000"><nowiki>*</nowiki></font></span>~~description~~<span><font color="#990000">~~)~~;</font></span>~~	+	def hildon_note_new_confirmation_with_icon_name(parent, description, icon_name)
-	~~GtkWidget<span><font color="#990000"><nowiki>*</nowiki></font></span> hildon_note_new_confirmation_add_buttons~~	+	def hildon_note_new_cancel_with_progress_bar(parent, description, progressbar)
-	~~<span><font color="#990000">~~(~~</font></span>GtkWindow <span><font color="#990000"><nowiki>*</nowiki></font></span>~~parent~~<span><font color="#990000">~~,~~</font></span>~~	+
-	~~<span>'''<span><font color="#0000FF">const</font></span>'''</span> gchar <span><font color="#990000"><nowiki>*</nowiki></font></span>~~description~~<span><font color="#990000">~~,~~</font></span>~~	+
-	~~<span><font color="#990000">...~~)~~;</font></span>~~	+
-	~~GtkWidget<span><font color="#990000"><nowiki>*</nowiki></font></span>~~ hildon_note_new_cancel_with_progress_bar	+
-	~~<span><font color="#990000">~~(~~</font></span>GtkWindow <span><font color="#990000"><nowiki>*</nowiki></font></span>~~parent~~<span><font color="#990000">~~,~~</font></span>~~	+
-	~~<span>'''<span><font color="#0000FF">const</font></span>'''</span> gchar <span><font color="#990000"><nowiki>*</nowiki></font></span>~~description~~<span><font color="#990000">~~,~~</font></span>~~	+
-	~~GtkProgressBar <span><font color="#990000"><nowiki>*</nowiki></font></span>~~progressbar~~<span><font color="#990000">~~)~~;</font></span>~~	+
-	~~</tt>~~	+

	Every function to create notes receives as a parameter the parent window of the newly created note. This is important in order to allow the window manager to handle the windows properly.		Every function to create notes receives as a parameter the parent window of the newly created note. This is important in order to allow the window manager to handle the windows properly.

← Older revision		Revision as of 17:42, 9 October 2009
Line 216:		Line 216:
	The period of time after the banner automatically disappear is stored in the property "timeout" (in miliseconds). A convenience function to set this property is provided:		The period of time after the banner automatically disappear is stored in the property "timeout" (in miliseconds). A convenience function to set this property is provided:

-	~~<tt><span><font color="#009900">void</font></span> <span>'''<span><font color="#000000">hildon_banner_set_timeout</font></span>'''</span> <span><font color="#990000">~~(~~</font></span>HildonBanner <span><font color="#990000"><nowiki>*</nowiki></font></span>self<span><font color="#990000">,</font></span>~~	+	hildon.Banner.set_timeout(timeout)
-	~~guint~~ timeout~~<span><font color="#990000">~~)~~;</font></span>~~	+
-	~~</tt>~~	+

	Here is a simple example showing how to setup and show an informational banner.		Here is a simple example showing how to setup and show an informational banner.
Line 224:		Line 222:
	'''Example 7.5. Setting up an informational banner'''		'''Example 7.5. Setting up an informational banner'''

-	~~<tt> GtkWidget<span><font color="~~#~~990000"><nowiki>*</nowiki></font></span> banner<span><font color="#990000"><nowiki>;</nowiki></font></span>~~	+	# Create a banner with a markup
-	<span>''<span><font color="#9A1900">/* Create a banner with a markup */</font></span>''</span>	+	banner = hildon.Banner.show_information_with_markup(widget, None, "<b>Information banner</b>")
-	banner ~~<span><font color~~=~~"#990000"><nowiki>=</nowiki></font></span> <span>'''<span><font color="#000000">hildon_banner_show_information_with_markup</font></span>'''</span> <span><font color="#990000">~~(~~</font></span>~~widget~~<span><font color="#990000">~~,~~</font></span>~~	+	banner.set_timeout(9000)
-	~~NULL<span><font color=~~"~~#990000">,~~<~~/font~~>~~</span>~~	+
-	~~<span><font color="#FF0000">"<b>~~Information banner~~<~~/b~~>"</font~~>~~</span><span><font color=~~"~~#990000">~~)~~;</font></span>~~	+
-	~~<span>'''<span><font color="#000000">hildon_banner_set_timeout</font></span>'''</span> <span><font color="#990000">~~(</font></span><span>'''<span><font color="#000000">HILDON_BANNER</font></span>'''</span> <span><font color="#990000">(</font></span>banner<span><font color="#990000">),</font></span> <span><font color="#993399">9000~~</font></span><span><font color="#990000">~~)~~;</font></span>~~	+
-	~~</tt>~~	+

	===Note===		===Note===

← Older revision		Revision as of 17:41, 9 October 2009
Line 209:		Line 209:
	Function <code>show_informationf()</code> shows a banner which displays the text given by the printf-like formated string applied to the parameters that the rest of the function's arguments represent.		Function <code>show_informationf()</code> shows a banner which displays the text given by the printf-like formated string applied to the parameters that the rest of the function's arguments represent.

-	You can also apply a Pango markup and add some attributes to the displayed text. To do that, either use <code>show_information_with_markup()</code> to create the banner or setup the markup by calling <code>set_markup()</code> after the initialization~~. [@@COMMENT@@ LINK TO PANGO MARKUP]~~	+	You can also apply a Pango markup and add some attributes to the displayed text. To do that, either use <code>show_information_with_markup()</code> to create the banner or setup the markup by calling <code>set_markup()</code> after the initialization

	===Warning===		===Warning===

← Older revision		Revision as of 17:41, 9 October 2009
Line 198:		Line 198:
	To create and show a banner, use the following function:		To create and show a banner, use the following function:

-	~~<tt>GtkWidget<span><font color~~=~~"#990000"><nowiki></nowiki></font></span> <span>'''<span><font color="#000000">~~hildon_banner_show_information~~</font></span>'''</span> <span><font color="#990000">~~(~~</font></span>GtkWidget <span><font color="#990000"><nowiki></nowiki></font></span>~~widget~~<span><font color="#990000">~~,~~</font></span>~~	+	banner = hildon.hildon_banner_show_information(widget, icon_name, text)
-	~~<span>'''<span><font color="#0000FF">const</font></span>'''</span> gchar <span><font color="#990000"><nowiki>*</nowiki></font></span>~~icon_name~~<span><font color="#990000">~~,~~</font></span>~~	+
-	~~<span>'''<span><font color="#0000FF">const</font></span>'''</span> gchar <span><font color="#990000"><nowiki>*</nowiki></font></span>~~text~~<span><font color="#990000">~~)~~;</font></span>~~	+	banner = hildon.hildon_banner_show_information_with_markup(widget, icon_name, markup)
-	GtkWidget<span><font color="#990000"><nowiki></nowiki></font></span> <span>'''<span><font color="#000000">hildon_banner_show_informationf</font></span>'''</span> <span><font color="#990000">(</font></span>GtkWidget <span><font color="#990000"><nowiki></nowiki></font></span>widget<span><font color="#990000">,</font></span>	+
-	~~<span>'''<span><font color="#0000FF">const</font></span>'''</span> gchar <span><font color="#990000"><nowiki>*</nowiki></font></span>icon_name<span><font color="#990000">,</font></span>~~	+
-	~~<span>'''<span><font color="#0000FF">const</font></span>'''</span> gchar <span><font color="#990000"><nowiki>*</nowiki></font></span>format<span><font color="#990000">,</font></span>~~	+
-	~~<span><font color~~=~~"#990000">~~.~~..);</font></span>~~	+
-	~~GtkWidget<span><font color="#990000"><nowiki>*</nowiki></font></span>~~ hildon_banner_show_information_with_markup	+
-	~~<span><font color="#990000">~~(~~</font></span>GtkWidget <span><font color="#990000"><nowiki>*</nowiki></font></span>~~widget~~<span><font color="#990000">~~,~~</font></span>~~	+
-	~~<span>'''<span><font color="#0000FF">const</font></span>'''</span> gchar <span><font color="#990000"><nowiki>*</nowiki></font></span>~~icon_name~~<span><font color="#990000">~~,~~</font></span>~~	+
-	~~<span>'''<span><font color="#0000FF">const</font></span>'''</span> gchar <span><font color="#990000"><nowiki>*</nowiki></font></span>~~markup~~<span><font color="#990000">~~)~~;</font></span>~~	+
-	~~</tt>~~	+

	All functions above require a widget as an argument that must be a pointer to the owner widget of the banner. Usually, the owner is the window that represents the currently displayed view.		All functions above require a widget as an argument that must be a pointer to the owner widget of the banner. Usually, the owner is the window that represents the currently displayed view.

-	Function <code>~~hildon_banner_show_information~~()</code> shows a banner with the given text.	+	Function <code>show_information()</code> shows a banner with the given text.

-	Function <code>~~hildon_banner_show_informationf~~()</code> shows a banner which displays the text given by the printf-like formated string applied to the parameters that the rest of the function's arguments represent.	+	Function <code>show_informationf()</code> shows a banner which displays the text given by the printf-like formated string applied to the parameters that the rest of the function's arguments represent.

-	You can also apply a Pango markup and add some attributes to the displayed text. To do that, either use <code>~~hildon_banner_show_information_with_markup~~()</code> to create the banner or setup the markup by calling <code>~~hildon_banner_set_markup~~()</code> after the initialization. [@@COMMENT@@ LINK TO PANGO MARKUP]	+	You can also apply a Pango markup and add some attributes to the displayed text. To do that, either use <code>show_information_with_markup()</code> to create the banner or setup the markup by calling <code>set_markup()</code> after the initialization. [@@COMMENT@@ LINK TO PANGO MARKUP]

	===Warning===		===Warning===