Legacy Maemo 5 Documentation/Graphical UI Tutorial/Data selection - Revision history

imported_>amigadave: wikify slightly

2010-10-15T14:34:51Z

wikify slightly

imported_>amigadave: {{Legacy documentation}}

2010-02-12T09:44:10Z

← Older revision		Revision as of 09:44, 12 February 2010
Line 1:		Line 1:
			{{Legacy documentation}}

	= Data selection =		= Data selection =
	Hildon provides a set of widgets for data selection specially designed for touchscreens that allows to build simple and easy-to-use interfaces.		Hildon provides a set of widgets for data selection specially designed for touchscreens that allows to build simple and easy-to-use interfaces.

imported_>b0unc3: /* Custom columns */

2010-01-20T11:46:24Z

Custom columns

← Older revision		Revision as of 11:46, 20 January 2010
Line 196:		Line 196:
	<span>''<span><font color="#9A1900">/* Set the selection mode */</font></span>''</span>		<span>''<span><font color="#9A1900">/* Set the selection mode */</font></span>''</span>
	<span>'''<span><font color="#000000">hildon_touch_selector_set_column_selection_mode</font></span>'''</span> <span><font color="#990000">(</font></span><span>'''<span><font color="#000000">HILDON_TOUCH_SELECTOR</font></span>'''</span> <span><font color="#990000">(</font></span>selector<span><font color="#990000">),</font></span>		<span>'''<span><font color="#000000">hildon_touch_selector_set_column_selection_mode</font></span>'''</span> <span><font color="#990000">(</font></span><span>'''<span><font color="#000000">HILDON_TOUCH_SELECTOR</font></span>'''</span> <span><font color="#990000">(</font></span>selector<span><font color="#990000">),</font></span>
	HILDON_TOUCH_SELECTOR_SELECTION_MODE_MULTIPLE<span><font color="#990000">);</font></span>		<span>'''<span><font color="#000000">HILDON_TOUCH_SELECTOR_SELECTION_MODE_MULTIPLE</font></span>'''</span><span><font color="#990000">);</font></span>
	<span>''<span><font color="#9A1900">/* Set the property "text-column" that indicates the column</font></span>''</span>		<span>''<span><font color="#9A1900">/* Set the property "text-column" that indicates the column</font></span>''</span>
	<span>''<span><font color="#9A1900"> * of the model to get the string from */</font></span>''</span>		<span>''<span><font color="#9A1900"> * of the model to get the string from */</font></span>''</span>

imported_>b0unc3: /* Custom columns */

2010-01-16T11:50:06Z

Custom columns

← Older revision		Revision as of 11:50, 16 January 2010
Line 146:		Line 146:
	This section explains how to build a selector within a column displaying stock icons. Firstly, let us take a look on the function which used for appending new columns to a touchable selector.		This section explains how to build a selector within a column displaying stock icons. Firstly, let us take a look on the function which used for appending new columns to a touchable selector.

	<tt>HildonTouchSelectorColumn<span><font color="#990000"><nowiki>*</nowiki></font></span> hildon_touch_selector_append_column		<tt>HildonTouchSelectorColumn<span><font color="#990000"><nowiki></nowiki></font></span><span>'''<span><font color="#000000"> hildon_touch_selector_append_column</font></span>'''</span> <span><font color="#990000">(</font></span>HildonTouchSelector <span><font color="#990000"><nowiki></nowiki></font></span>selector<span><font color="#990000">,</font></span>
	<span><font color="#990000">(</font></span>HildonTouchSelector <span><font color="#990000"><nowiki>*</nowiki></font></span>selector<span><font color="#990000">,</font></span>		GtkTreeModel <span><font color="#990000"><nowiki>*</nowiki></font></span>model<span><font color="#990000">,</font></span>
	GtkTreeModel <span><font color="#990000"><nowiki>*</nowiki></font></span>model<span><font color="#990000">,</font></span>		GtkCellRenderer <span><font color="#990000"><nowiki>*</nowiki></font></span>cell_renderer<span><font color="#990000">,</font></span>
	GtkCellRenderer <span><font color="#990000"><nowiki>*</nowiki></font></span>cell_renderer<span><font color="#990000">,</font></span>		<span><font color="#990000"> ...);</font></span>
	<span><font color="#990000">...);</font></span>
	</tt>		</tt>

imported_>b0unc3: /* Text Columns Example */

2010-01-16T11:45:58Z

Text Columns Example

← Older revision		Revision as of 11:45, 16 January 2010
Line 123:		Line 123:
	You can set the desired selection with the function. In the example, the mode was set to allow multiple selection.		You can set the desired selection with the function. In the example, the mode was set to allow multiple selection.

	<tt><span><font color="#009900">void</font></span> hildon_touch_selector_set_column_selection_mode		<tt><span><font color="#009900">void</font></span> <span>'''<span><font color="#000000">hildon_touch_selector_set_column_selection_mode</font></span>'''</span> <span><font color="#990000">(</font></span>HildonTouchSelector <span><font color="#990000"><nowiki>*</nowiki></font></span>selector<span><font color="#990000">,</font></span>
	<span><font color="#990000">(</font></span>HildonTouchSelector <span><font color="#990000"><nowiki>*</nowiki></font></span>selector<span><font color="#990000">,</font></span>		HildonTouchSelectorSelectionMode mode<span><font color="#990000">);</font></span>
	HildonTouchSelectorSelectionMode mode<span><font color="#990000">);</font></span>
	</tt>		</tt>

imported_>tapio: fix for https://bugs.maemo.org/show_bug.cgi?id=7603 (also changed code example in garage)

2010-01-05T10:40:00Z

fix for https://bugs.maemo.org/show_bug.cgi?id=7603 (also changed code example in garage)

← Older revision		Revision as of 10:40, 5 January 2010
Line 20:		Line 20:
	#include <hildon/hildon.h>		#include <hildon/hildon.h>

	void selection_changed (HildonTouchSelector * selector, gpointer user_data);		void selection_changed (HildonTouchSelector * selector, gint column, gpointer user_data);
	static GtkWidget *create_simple_selector ();		static GtkWidget *create_simple_selector ();

	void		void
	selection_changed (HildonTouchSelector * selector,		selection_changed (HildonTouchSelector * selector, gint column,
	gpointer user_data)		gpointer user_data)
	{		{
Line 31:		Line 31:
	current_selection = hildon_touch_selector_get_current_text (selector);		current_selection = hildon_touch_selector_get_current_text (selector);
	g_debug ("Current selection : %s", current_selection);		g_debug ("Current selection : %s", current_selection);
			g_debug ("User data=%s\n", (gchar*) user_data);
	}		}

Line 43:		Line 44:

	g_signal_connect (G_OBJECT (selector), "changed",		g_signal_connect (G_OBJECT (selector), "changed",
	G_CALLBACK (selection_changed), ~~NULL~~);		G_CALLBACK (selection_changed), (gpointer) "some data");

	/* Populate selector */		/* Populate selector */

imported_>b0unc3: /* Text Columns Example */

2009-12-16T12:10:21Z

Text Columns Example

← Older revision		Revision as of 12:10, 16 December 2009
Line 18:		Line 18:
	[[Image:example-single-text-column-selector.png\|400px]]		[[Image:example-single-text-column-selector.png\|400px]]

	#include <hildon/hildon.h>		#include <hildon/hildon.h>

	void selection_changed (HildonTouchSelector * selector, gpointer user_data);		void selection_changed (HildonTouchSelector * selector, gpointer user_data);
	static GtkWidget *create_simple_selector ();		static GtkWidget *create_simple_selector ();

imported_>b0unc3: /* Touch selector entry */

2009-12-15T22:35:43Z

Touch selector entry

imported_>b0unc3: /* Pre-built selectors */

2009-12-15T22:29:39Z

Pre-built selectors

← Older revision		Revision as of 22:29, 15 December 2009
Line 403:		Line 403:
	'''Example 6.5. Example of a Hildon date button'''		'''Example 6.5. Example of a Hildon date button'''

	#include <hildon/hildon.h>		#include <hildon/hildon.h>

	int		int

192.100.124.219: /* Text Columns Example */

2009-11-11T12:47:00Z

Text Columns Example

← Older revision		Revision as of 12:47, 11 November 2009
Line 20:		Line 20:
	#include <hildon/hildon.h>		#include <hildon/hildon.h>

	void selection_changed (HildonTouchSelector * selector, gpointer *user_data);		void selection_changed (HildonTouchSelector * selector, gpointer user_data);
	static GtkWidget *create_simple_selector ();		static GtkWidget *create_simple_selector ();

	void		void
	selection_changed (HildonTouchSelector * selector,		selection_changed (HildonTouchSelector * selector,
	gpointer *user_data)		gpointer user_data)
	{		{
	gchar *current_selection = NULL;		gchar *current_selection = NULL;

← Older revision		Revision as of 22:35, 15 December 2009
Line 339:		Line 339:
	'''Example 6.4. Example of a Hildon picker button with a selector entry'''		'''Example 6.4. Example of a Hildon picker button with a selector entry'''

	<tt><span>'''<span><font color="#000080"><nowiki>#include</nowiki></font></span>'''</span> <span><font color="#FF0000"><hildon/hildon.h></font></span>		<tt><span>'''<span><font color="#000080"><nowiki>#include</nowiki></font></span>'''</span> <span><font color="#FF0000"><hildon/hildon.h></font></span>
	<span>'''<span><font color="#0000FF">static</font></span>'''</span> <span>'''<span><font color="#0000FF">const</font></span>'''</span> gchar<span><font color="#990000"><nowiki>*</nowiki></font></span> artists <span><font color="#990000">[]</font></span> <span><font color="#990000"><nowiki>=</nowiki></font></span> <span><font color="#FF0000">{</font></span>		<span>'''<span><font color="#0000FF">static</font></span>'''</span> <span>'''<span><font color="#0000FF">const</font></span>'''</span> gchar<span><font color="#990000"><nowiki>*</nowiki></font></span> artists <span><font color="#990000">[]</font></span> <span><font color="#990000"><nowiki>=</nowiki></font></span> <span><font color="#FF0000">{</font></span>
	<span><font color="#FF0000">"AC/DC"</font></span><span><font color="#990000">,</font></span>		<span><font color="#FF0000">"AC/DC"</font></span><span><font color="#990000">,</font></span>
	<span><font color="#FF0000">"Aerosmith"</font></span><span><font color="#990000">,</font></span>		<span><font color="#FF0000">"Aerosmith"</font></span><span><font color="#990000">,</font></span>
Line 352:		Line 352:
	NULL		NULL
	<span><font color="#FF0000">}</font></span><span><font color="#990000"><nowiki>;</nowiki></font></span>		<span><font color="#FF0000">}</font></span><span><font color="#990000"><nowiki>;</nowiki></font></span>
	<span><font color="#009900">int</font></span>		<span><font color="#009900">int</font></span>
	<span>'''<span><font color="#000000">main</font></span>'''</span> <span><font color="#990000">(</font></span><span><font color="#009900">int</font></span> argc<span><font color="#990000">,</font></span> <span><font color="#009900">char</font></span> <span><font color="#990000"><nowiki>**</nowiki></font></span>argv<span><font color="#990000">)</font></span>		<span>'''<span><font color="#000000">main</font></span>'''</span> <span><font color="#990000">(</font></span><span><font color="#009900">int</font></span> argc<span><font color="#990000">,</font></span> <span><font color="#009900">char</font></span> <span><font color="#990000"><nowiki>**</nowiki></font></span>argv<span><font color="#990000">)</font></span>
	<span><font color="#FF0000">{</font></span>		<span><font color="#FF0000">{</font></span>
Line 392:		Line 392:

	You can also use custom columns in a HildonTouchableEntry but at least one column must be a text column. The text column is indicated by the property "text_column" which you set with <code>hildon_touch_selector_entry_set_text_column()</code>.		You can also use custom columns in a HildonTouchableEntry but at least one column must be a text column. The text column is indicated by the property "text_column" which you set with <code>hildon_touch_selector_entry_set_text_column()</code>.


	==Pre-built selectors ==		==Pre-built selectors ==