PyMaemo/UI tutorial/Toolbars - Revision history

imported_>amigadave: add link to C documentation

2010-10-07T10:59:54Z

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.

imported_>amigadave: use

2010-06-22T14:23:12Z

use <source and <code>

Show changes

imported_>amigadave: Category:Python

2010-02-11T15:55:39Z

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]]

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

2010-02-01T11:11:31Z

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

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

imported_>hugo_pl at 16:52, 16 October 2009

2009-10-16T16:52:19Z

← 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()

imported_>hugo_pl at 16:51, 16 October 2009

2009-10-16T16:51:08Z

← 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()

imported_>renatofilho: /* Using GtkToolbars in Hildon applications */

2009-10-16T14:44:06Z

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 */

2009-10-15T20:18:27Z

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 ==

imported_>renatofilho: /* Using GtkToolbars in Hildon applications */

2009-10-09T18:09:05Z

Using GtkToolbars in Hildon applications

Show changes

imported_>renatofilho: /* Edit toolbars */

2009-10-09T18:07:21Z

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)