PyMaemo/UI tutorial/Toolbars - Revision history

amigadave: add link to C documentation

amigadave — Thu, 07 Oct 2010 10:59:54 GMT

add link to C documentation

← Older revision		Revision as of 10:59, 7 October 2010
Line 1:		Line 1:
		+	{{main\|Legacy Maemo 5 Documentation/Graphical UI Tutorial/Toolbars}}
		+
	Toolbars usually simplify the customization of widget look and layout by grouping widgets. The Hildon framework provides two specialized toolbars: <code>HildonFindToolbar</code> and <code>HildonEditToolbar</code>. You can also use <code>GtkToolbar</code>s in your Hildon application.		Toolbars usually simplify the customization of widget look and layout by grouping widgets. The Hildon framework provides two specialized toolbars: <code>HildonFindToolbar</code> and <code>HildonEditToolbar</code>. You can also use <code>GtkToolbar</code>s in your Hildon application.

amigadave: use

amigadave — Tue, 22 Jun 2010 14:23:12 GMT

use <source and <code>

Show changes

amigadave: Category:Python

amigadave — Thu, 11 Feb 2010 15:55:39 GMT

Category:Python

← Older revision		Revision as of 15:55, 11 February 2010
Line 323:		Line 323:
	if __name__ == "__main__":		if __name__ == "__main__":
	main()		main()
		+
		+	[[Category:Python]]

danielwilms: PyMaemo/UITutorial/Toolbars moved to PyMaemo/UI tutorial/Toolbars

danielwilms — Mon, 01 Feb 2010 11:11:31 GMT

PyMaemo/UITutorial/Toolbars moved to PyMaemo/UI tutorial/Toolbars

← Older revision

Revision as of 11:11, 1 February 2010

hugo_pl at 16:52, 16 October 2009

hugo_pl — Fri, 16 Oct 2009 16:52:19 GMT

← Older revision		Revision as of 16:52, 16 October 2009
Line 48:		Line 48:
	# "Hildon Tutorial" version 2009-04-28		# "Hildon Tutorial" version 2009-04-28
	# Example 4.1, "Using a Find Toolbar"		# Example 4.1, "Using a Find Toolbar"
-		+
	import sys		import sys
-		+
	import gobject		import gobject
	import gtk		import gtk
	import hildon		import hildon
-		+
	def on_history_append(toolbar, user_data):		def on_history_append(toolbar, user_data):
	# Get last added index		# Get last added index
	index = toolbar.get_last_index()		index = toolbar.get_last_index()
-		+
	# Get the inner list		# Get the inner list
	list = toolbar.get("list")		list = toolbar.get("list")
-		+
	# Get the item		# Get the item
	iter = list.get_iter_from_string("%d" % index)		iter = list.get_iter_from_string("%d" % index)
-		+
	item, = list.get(iter, 0)		item, = list.get(iter, 0)
-		+
	print sys.stderr, "ADDED TO THE LIST : %s" % item		print sys.stderr, "ADDED TO THE LIST : %s" % item
-		+
	def main():		def main():
	program = hildon.Program.get_instance()		program = hildon.Program.get_instance()
	window = hildon.Window()		window = hildon.Window()
-		+
	program.add_window(window)		program.add_window(window)
-		+
	# Create and populate history list model		# Create and populate history list model
	store = gtk.ListStore(gobject.TYPE_STRING)		store = gtk.ListStore(gobject.TYPE_STRING)
-		+
	iter = store.append()		iter = store.append()
	store.set(iter, 0, "Foo")		store.set(iter, 0, "Foo")
-		+
	iter = store.append()		iter = store.append()
	store.set(iter, 0, "Bar")		store.set(iter, 0, "Bar")
-		+
	iter = store.append()		iter = store.append()
	store.set(iter, 0, "Baz")		store.set(iter, 0, "Baz")
-		+
	# Create find toolbar		# Create find toolbar
	toolbar = hildon.FindToolbar("Find", store, 0)		toolbar = hildon.FindToolbar("Find", store, 0)
-		+
	# Set item on index 0 as the current active		# Set item on index 0 as the current active
	toolbar.set_active(0)		toolbar.set_active(0)
-		+
	# Attach a callback to handle "history-append" signal		# Attach a callback to handle "history-append" signal
	toolbar.connect_after("history-append", on_history_append, None)		toolbar.connect_after("history-append", on_history_append, None)
-		+
	# Attach toolbar to window		# Attach toolbar to window
	window.add_toolbar(toolbar)		window.add_toolbar(toolbar)
-		+
	window.show_all()		window.show_all()
-		+
	gtk.main()		gtk.main()
-		+
	if __name__ == "__main__":		if __name__ == "__main__":
	main()		main()

hugo_pl at 16:51, 16 October 2009

hugo_pl — Fri, 16 Oct 2009 16:51:08 GMT

← Older revision		Revision as of 16:51, 16 October 2009
Line 44:		Line 44:

	'''Example 4.1. Using a Find Toolbar'''		'''Example 4.1. Using a Find Toolbar'''
-

	# Based on C code from:		# Based on C code from:
	# "Hildon Tutorial" version 2009-04-28		# "Hildon Tutorial" version 2009-04-28
	# Example 4.1, "Using a Find Toolbar"		# Example 4.1, "Using a Find Toolbar"
-		+
	import sys		import sys
-		+
	import gobject		import gobject
	import gtk		import gtk
	import hildon		import hildon
-		+
	def on_history_append(toolbar, user_data):		def on_history_append(toolbar, user_data):
	# Get last added index		# Get last added index
	index = toolbar.get_last_index()		index = toolbar.get_last_index()
-		+
	# Get the inner list		# Get the inner list
	list = toolbar.get("list")		list = toolbar.get("list")
-		+
	# Get the item		# Get the item
	iter = list.get_iter_from_string("%d" % index)		iter = list.get_iter_from_string("%d" % index)
-		+
	item, = list.get(iter, 0)		item, = list.get(iter, 0)
-		+
	print sys.stderr, "ADDED TO THE LIST : %s" % item		print sys.stderr, "ADDED TO THE LIST : %s" % item
-		+
	def main():		def main():
-	program = hildon.~~hildon_program_get_instance~~()	+	program = hildon.Program.get_instance()
	window = hildon.Window()		window = hildon.Window()
-		+
	program.add_window(window)		program.add_window(window)
-		+
	# Create and populate history list model		# Create and populate history list model
	store = gtk.ListStore(gobject.TYPE_STRING)		store = gtk.ListStore(gobject.TYPE_STRING)
-		+
	iter = store.append()		iter = store.append()
	store.set(iter, 0, "Foo")		store.set(iter, 0, "Foo")
-		+
	iter = store.append()		iter = store.append()
	store.set(iter, 0, "Bar")		store.set(iter, 0, "Bar")
-		+
	iter = store.append()		iter = store.append()
	store.set(iter, 0, "Baz")		store.set(iter, 0, "Baz")
-		+
	# Create find toolbar		# Create find toolbar
	toolbar = hildon.FindToolbar("Find", store, 0)		toolbar = hildon.FindToolbar("Find", store, 0)
-		+
	# Set item on index 0 as the current active		# Set item on index 0 as the current active
	toolbar.set_active(0)		toolbar.set_active(0)
-		+
	# Attach a callback to handle "history-append" signal		# Attach a callback to handle "history-append" signal
	toolbar.connect_after("history-append", on_history_append, None)		toolbar.connect_after("history-append", on_history_append, None)
-		+
	# Attach toolbar to window		# Attach toolbar to window
	window.add_toolbar(toolbar)		window.add_toolbar(toolbar)
-		+
	window.show_all()		window.show_all()
-		+
	gtk.main()		gtk.main()
-		+
	if __name__ == "__main__":		if __name__ == "__main__":
	main()		main()

renatofilho: /* Using GtkToolbars in Hildon applications */

renatofilho — Fri, 16 Oct 2009 14:44:06 GMT

Using GtkToolbars in Hildon applications

← Older revision		Revision as of 14:44, 16 October 2009
Line 286:		Line 286:

	def main():		def main():
-	program = hildon.~~hildon_program_get_instance~~()	+	program = hildon.Program.get_instance()
	gtk.set_application_name("hildon-touch-selector example program")		gtk.set_application_name("hildon-touch-selector example program")

200.184.118.130: /* Edit toolbars */

200.184.118.130 — Thu, 15 Oct 2009 20:18:27 GMT

Edit toolbars

← Older revision		Revision as of 20:18, 15 October 2009
Line 113:		Line 113:

	==Edit toolbars ==		==Edit toolbars ==
-	Edit toolbars are implemented by the widget HildonEditToolbar. This widget is a toolbar to be used as main control and navigation interface for the edit UI mode. The toolbar contains a label and two buttons, being one of them an arrow pointing backwards and the other a button to perform a certain action. It also ~~display~~ a label which explain to the users the action that the button performs and ~~give~~ intructions ~~to user~~ on how to perform the action properly.	+	Edit toolbars are implemented by the widget HildonEditToolbar. This widget is a toolbar to be used as a main control and navigation interface for the edit UI mode. The toolbar contains a label and two buttons, being one of them an arrow pointing backwards and the other a button to perform a certain action. It also displays a label which explain to the users the action that the second button performs and gives intructions on how to perform the action properly.

-	A typical example could be a view to delete several items in a list. The label would ~~advice~~ the user to select the items ~~to delete and those items are~~ deleted by clicking the button.	+	A typical example could be a view to delete several items in a list. The label would advise the user to select the desired items that will be deleted clicking the button.

-	Typically, the toolbar is attached to an edit view~~, meaning~~ a HildonStackableWindow used in the program to perform a certain editing action.	+	Typically the toolbar is attached to an edit view (a HildonStackableWindow) used by the program to perform a certain editing action.

-	The action to be ~~performing~~ by clicking the action button should be implemented in a callback ~~to handle~~ the signal "button-clicked", shown in the example.	+	The action to be performed by clicking the action button should be implemented in a callback that handles the signal "button-clicked". More will be shown in the example.

-	To create a new HildonEditToolbar, use:	+	To create a new HildonEditToolbar use:

	hildon.EditToolbar(label = None, button = None)		hildon.EditToolbar(label = None, button = None)


-	~~The second creation function allows to set the two labels of the widget.~~ If you ~~use~~ the ~~simple creation~~ function, set ~~the labels by~~ using ~~the following functions.~~	+	If you have used the default constructor function you can set label and button label later using:

	def set_label(self, label)		def set_label(self, label)
Line 135:		Line 135:
	def add_toolbar(self, toolbar)		def add_toolbar(self, toolbar)

-	~~Implement the action~~ to ~~be done~~ by clicking the button ~~in a callback attached to~~ the signal "button-clicked". These widgets define also another signal, "arrow-clicked", emitted when users click the arrow. Typically, the callback for the signal "arrow-clicked" destroys the current edit view.	+	The example below shows how to use an edit toolbar. It has a main window containing a list of items plus a button that calls an edit view. The user can select several items and deleted by clicking the action button of the toolbar.

-	The ~~example below shows how~~ to ~~use an edit toolbar. This example builds a main window showing a list of items and~~ a button to go to ~~a edit view where users can select several items and deleted by clicking~~ the ~~action button of~~ the ~~toolbar~~.	+	The action to be done by clicking the button should be implemented in a callback. It has to be attached to the signal "button-clicked". There is also another signal called "arrow-clicked", emitted when users click the arrow (to go back to the previous screen). Typically the callback for this later signal destroys the current edit view.

	[[Image:Edit_toolbar_list_view.png\|400px]]		[[Image:Edit_toolbar_list_view.png\|400px]]
Line 252:		Line 252:


-	~~The most~~ things related to HildonEditToolbar is in the function edit_window. ~~This function~~ creates a edit view~~, meaning that~~ a new HildonStackableWindow ~~is created showing~~ a treeview ~~in which users~~ can select several items.	+	Most of the things related to HildonEditToolbar are in the function edit_window. It creates an edit view (a new HildonStackableWindow) containing a treeview where the user can select several items.

-	Note ~~that~~ the edit window is set to fullscreen ~~and thus displaying the HildonEditToolbar obscures~~ the usual window controls.	+	Note: the edit window is set to fullscreen hiding the usual window controls.

	== Using GtkToolbars in Hildon applications ==		== Using GtkToolbars in Hildon applications ==

renatofilho: /* Using GtkToolbars in Hildon applications */

renatofilho — Fri, 09 Oct 2009 18:09:05 GMT

Using GtkToolbars in Hildon applications

Show changes

renatofilho: /* Edit toolbars */

renatofilho — Fri, 09 Oct 2009 18:07:21 GMT

Edit toolbars

← Older revision		Revision as of 18:07, 9 October 2009
Line 208:		Line 208:
	area = hildon.PannableArea()		area = hildon.PannableArea()
	tree_view = create_treeview(gtk.HILDON_UI_MODE_EDIT)		tree_view = create_treeview(gtk.HILDON_UI_MODE_EDIT)
-		+
	# Add toolbar to the window		# Add toolbar to the window
	window.set_edit_toolbar(toolbar)		window.set_edit_toolbar(toolbar)