Hildon::Helper Namespace Reference

Functions
gulong	set_logical_font (Gtk::Widget &widget, const Glib::ustring &logicalfontname)
	This function assigns a defined logical font to the widget and all its child widgets.
gulong	set_logical_color (Gtk::Widget &widget, Gtk::RcFlags rcflags, Gtk::StateType state, const Glib::ustring &logicalcolorname)
	This function assigns a defined logical color to the widget and all it's child widgets.
bool	event_button_is_finger (GdkEventButton *event)
	Checks if the given button event is a finger event.
void	set_thumb_scrollbar (Gtk::ScrolledWindow &win, bool thumb=true)
	This function enables a thumb scrollbar on a given scrolled window.

---

Function Documentation

bool Hildon::Helper::event_button_is_finger

(

GdkEventButton *

event

)

Checks if the given button event is a finger event.

Parameters:

event

A to check

Returns:

true if the event is a finger event.

gulong Hildon::Helper::set_logical_color	(	Gtk::Widget &	widget,
		Gtk::RcFlags	rcflags,
		Gtk::StateType	state,
		const Glib::ustring &	logicalcolorname
	)

This function assigns a defined logical color to the widget and all it's child widgets.

It also connects to the "style_set" signal which will retrieve & assign the new color for the given logical name each time the theme is changed. The returned signal id can be used to disconnect the signal. When calling multiple times the previous signal (obtained by calling this function) is disconnected automatically and should not be used.

Example : If the style you want to modify is bg[NORMAL] then set rcflags to GTK_RC_BG and state to GTK_STATE_NORMAL.

Parameters:

	widget	A Gtk::Widget to assign this logical font for.
	rcflags	: Flags enumeration defining whether to assign to FG, BG, TEXT or BASE style.
	state	Indicates to which state to assign the logical color
	logicalcolorname	A string with the logical font name to assign to the widget.

Returns:

The signal id that is triggered every time theme is changed. 0 if color set failed.

gulong Hildon::Helper::set_logical_font	(	Gtk::Widget &	widget,
		const Glib::ustring &	logicalfontname
	)

This function assigns a defined logical font to the widget and all its child widgets.

It also connects to the "style_set" signal which will retrieve & assign the new font for the given logical name each time the theme is changed. The returned signal id can be used to disconnect the signal. When calling multiple times the previous signal (obtained by calling this function) is disconnected automatically and should not be used.

Parameters:

	widget	A Gtk::Widget to assign this logical font for.
	logicalfontname	A string with the logical font name to assign to the widget.

Returns:

the signal id that is triggered every time theme is changed. 0 if font set failed.

void Hildon::Helper::set_thumb_scrollbar	(	Gtk::ScrolledWindow &	win,
		bool	thumb = true
	)

This function enables a thumb scrollbar on a given scrolled window.

It'll convert the existing normal scrollbar into a larger, finger-usable scrollbar that works without a stylus. As fingerable list rows are fairly high, consider using the whole available vertical space of your application for the content in order to have as many rows as possible visible on the screen at once.

Finger-Sized scrollbar should always be used together with finger-sized content.

Parameters:

	win,:	A Gtk::ScrolledWindow to use as target.
	thumb	true to enable the thumb scrollbar, false to disable.