cajun::gtk_utils Namespace Reference

Functions
gchar *	make_bin_filename_gchar (const gchar *name)
	Retrieve the full path to where binaries are stored for cbsystem. Checks CBHOME.
GString *	make_bin_filename_gstring (const gchar *name)
	Retrieve the full path to where binaries are stored for cbsystem. Checks CBHOME.
gchar *	make_config_filename_gchar (const gchar *name)
	Retrieve the full path to where config files are stored for cbsystem. Checks CBCONF.
GString *	make_config_filename_gstring (const gchar *name)
	Retrieve the full path to where config files are stored for cbsystem. Checks CBCONF.
gchar *	make_bot_config_filename_gchar (const gchar *name)
	Retrieve the full path to where bot config files are stored for cbsystem. Checks CBCONF and CBBOTNAME.
GString *	make_bot_config_filename_gstring (const gchar *name)
	Retrieve the full path to where bot config files are stored for cbsystem. Checks CBCONF and CBBOTNAME.
gchar *	make_docs_filename_gchar (const gchar *name)
	Retrieve the full path to where documentation files are stored for cbsystem. Checks CBHOME.
GString *	make_docs_filename_gstring (const gchar *name)
	Retrieve the full path to where documentation files are stored for cbsystem. Checks CBHOME.
gchar *	make_support_filename_gchar (const gchar progname, const gchar name)
	Retrieve the full path to where support files are stored for cbsystem. Checks CBSUPPORT.
GString *	make_support_filename_gstring (const gchar progname, const gchar name)
	Retrieve the full path to where support files are stored for cbsystem. Checks CBSUPPORT.
gchar *	make_tmp_filename_gchar (const gchar *name)
	Retrieve the full path to where temporary files are stored.
GString *	make_tmp_filename_gstring (const gchar *name)
	Retrieve the full path to where temporary files are stored.
void	sleep (unsigned time)
	Sleep for specified ms but keep GUI events fresh and flushed.
void	flush_events ()
	Process pending events to the GUI.
void	add (GladeXML glade_xml, const gchar parent_container, GtkWidget *child_widget)
	Add a widget to a container.
void	add (GtkContainer parent_container, GtkWidget child_widget)
	Add a widget to a container.
GtkContainer *	get_container (GladeXML glade_xml, const gchar name)
	Retrieve a container from the GladeXML.
GtkWidget *	get_widget (GladeXML glade_xml, const gchar name)
	Retrieve a widget from the GladeXML.
GtkWindow *	get_window (GladeXML glade_xml, const gchar name)
	Retrieve a window from the GladeXML.
GtkComboBox *	get_combo (GladeXML glade_xml, const gchar name)
	Retrieve a combo box from the GladeXML.
GtkCheckButton *	get_checkbutton (GladeXML glade_xml, const gchar name)
	Retrieve a check button from the GladeXML.
GtkLabel *	get_label (GladeXML glade_xml, const gchar name)
	Retrieve a label from the GladeXML.
GtkEntry *	get_entry (GladeXML glade_xml, const gchar name)
	Retrieve a entry textfield from the GladeXML.
GtkProgressBar *	get_progressbar (GladeXML glade_xml, const gchar name)
	Retrieve a progress bar from the GladeXML.
GtkStatusbar *	get_statusbar (GladeXML glade_xml, const gchar name)
	Retrieve a status bar from the GladeXML.
GtkExpander *	get_expander (GladeXML glade_xml, const gchar name)
	Retrieve an expander container from the GladeXML.
GtkTextView *	get_textview (GladeXML glade_xml, const gchar name)
	Retrieve a textview entry from the GladeXML.
GtkTextBuffer *	get_textview_buffer (GladeXML glade_xml, const gchar name)
	Retrieve a textview buffer from the GladeXML.
GtkTreeView *	get_treeview (GladeXML glade_xml, const gchar name)
	Retrieve a treeview from the GladeXML.
GtkHButtonBox *	get_hbuttonbox (GladeXML glade_xml, const gchar name)
	Retrieve an hbuttonbox from the GladeXML.
GnomeDateEdit *	get_gnomedateedit (GladeXML glade_xml, const gchar name)
	Retrieve a gnome date edit widget from the GladeXML.
void	show (GladeXML glade_xml, const gchar name)
	Show a widget.
void	hide (GladeXML glade_xml, const gchar name)
	Hide a widget.
void	show (GtkWidget *w)
	Show a widget.
void	hide (GtkWidget *w)
	Hide a widget.
void	show (GtkWindow *w)
	Show a window.
void	hide (GtkWindow *w)
	Hide a window.
GString *	span_tag (const gchar text, const gchar color)
	Create the string for the span tag, useful for textviews.
GString *	span_tag (const gchar text, const gchar color, const gchar *size)
	Create the string for the span tag, useful for textviews.
const gchar *	gtk_label_get_text (GladeXML glade_xml, const gchar name)
	Retrieve a label's text from the GladeXML.
void	gtk_label_set_text (GladeXML glade_xml, const gchar name, const gchar *text)
	Set a label's text in the GladeXML.
const gchar *	gtk_textview_get_text (GladeXML glade_xml, const gchar textview_name)
	Retrieve a textview's text from the GladeXML.
gboolean	gtk_textview_set_text (GladeXML glade_xml, const gchar name, const gchar *text)
	Set a textview's text in the GladeXML.
const gchar *	gtk_entry_get_text (GladeXML glade_xml, const gchar name)
	Retrieve an entry's text from the GladeXML.
gboolean	gtk_entry_set_text (GladeXML glade_xml, const gchar name, const gchar *text)
	Set an entry's text in the GladeXML.
gint	gtk_combo_box_get_active (GladeXML glade_xml, const gchar name)
	Get the active index for a combo box.
gboolean	gtk_combo_box_set_active (GladeXML glade_xml, const gchar name, gint index)
	Set the active index for a combo box.
const gchar *	gtk_combo_box_get_active_text (GladeXML glade_xml, const gchar name)
	Get the active text at the active index for a combo box.
gboolean	gtk_combo_box_set_active_text (GtkComboBox gtk_cb, const gchar text)
	Set the active text of a combo box.
gboolean	gtk_combo_box_set_active_text (GladeXML glade_xml, const gchar name, const gchar *text)
	Set the active text of a combo box.
gboolean	gtk_combo_box_set_active_text (GtkComboBox gtk_cb, map< string, string > entry_map, const gchar text)
	Set the active (user-friendly) text of a combo box from "configuration" text.
gboolean	gtk_combo_box_set_active_text (GladeXML glade_xml, const gchar name, map< string, string > entry_map, const gchar *text)
	Set the active (user-friendly) text of a combo box from "configuration" text.
void	gtk_combo_box_add_entries (GtkComboBox *gtk_cb, vector< string > entries)
	Add entries to a combo box.
gboolean	gtk_refresh_gnomedateedit (GladeXML glade_xml, const gchar name)
	Update the Gnome date edit to the current system time.
gboolean	gtk_update_progressbar (GladeXML glade_xml, const gchar name)
	Pulse an indeterminant progress bar.
gboolean	gtk_update_progressbar (GladeXML glade_xml, const gchar name, gdouble frac)
	Update a progress bar to a particular percentage.
void	update_progress (GtkProgressBar *bar)
	Pulse an indeterminant progress bar.
void	update_progress (GtkProgressBar *bar, gdouble frac)
	Update a progress bar to a particular percentage.
void	clear_textview (GladeXML glade_xml, const gchar name)
	Clear a textview of any text.

Function Documentation

void cajun::gtk_utils::add	(	GtkContainer *	parent_container,
		GtkWidget *	child_widget
	)

Add a widget to a container.

Parameters:

	parent_container	The container that the widget will be added to.
	child_widget	The widget that needs to be added to the parent.

void cajun::gtk_utils::add	(	GladeXML *	glade_xml,
		const gchar *	parent_container,
		GtkWidget *	child_widget
	)

Add a widget to a container.

Parameters:

	glade_xml	The GladeXML handle used for the GUI.
	parent_container	The container name that the widget will be added to.
	child_widget	The widget that needs to be added to the parent.

References get_container().

void cajun::gtk_utils::clear_textview	(	GladeXML *	glade_xml,
		const gchar *	name
	)

Clear a textview of any text.

Parameters:

	glade_xml	The GladeXML handle used for the GUI.
	name	The name of the widget to use.

References get_textview_buffer().

void cajun::gtk_utils::flush_events ( )

Process pending events to the GUI.

Referenced by sleep(), and update_progress().

GtkCheckButton * cajun::gtk_utils::get_checkbutton	(	GladeXML *	glade_xml,
		const gchar *	name
	)

Retrieve a check button from the GladeXML.

Parameters:

	glade_xml	The GladeXML handle used for the GUI.
	name	The name of the widget to retrieve.

Returns:: The check button associated with the specified name.

References get_widget().

GtkComboBox * cajun::gtk_utils::get_combo	(	GladeXML *	glade_xml,
		const gchar *	name
	)

Retrieve a combo box from the GladeXML.

Parameters:

	glade_xml	The GladeXML handle used for the GUI.
	name	The name of the widget to retrieve.

Returns:: The combo box associated with the specified name.

References get_widget().

Referenced by gtk_combo_box_get_active(), gtk_combo_box_get_active_text(), gtk_combo_box_set_active(), and gtk_combo_box_set_active_text().

GtkContainer * cajun::gtk_utils::get_container	(	GladeXML *	glade_xml,
		const gchar *	name
	)

Retrieve a container from the GladeXML.

Parameters:

	glade_xml	The GladeXML handle used for the GUI.
	name	The name of the widget to retrieve.

Returns:: The container associated with the specified name.

Referenced by add().

GtkEntry * cajun::gtk_utils::get_entry	(	GladeXML *	glade_xml,
		const gchar *	name
	)

Retrieve a entry textfield from the GladeXML.

Parameters:

	glade_xml	The GladeXML handle used for the GUI.
	name	The name of the widget to retrieve.

Returns:: The entry textfield associated with the specified name.

References get_widget().

Referenced by gtk_entry_get_text(), and gtk_entry_set_text().

GtkExpander * cajun::gtk_utils::get_expander	(	GladeXML *	glade_xml,
		const gchar *	name
	)

Retrieve an expander container from the GladeXML.

Parameters:

	glade_xml	The GladeXML handle used for the GUI.
	name	The name of the widget to retrieve.

Returns:: The expander container associated with the specified name.

References get_widget().

GnomeDateEdit * cajun::gtk_utils::get_gnomedateedit	(	GladeXML *	glade_xml,
		const gchar *	name
	)

Retrieve a gnome date edit widget from the GladeXML.

Parameters:

	glade_xml	The GladeXML handle used for the GUI.
	name	The name of the widget to retrieve.

Returns:: The gnome date edit widget associated with the specified name.

References get_widget().

Referenced by gtk_refresh_gnomedateedit().

GtkHButtonBox * cajun::gtk_utils::get_hbuttonbox	(	GladeXML *	glade_xml,
		const gchar *	name
	)

Retrieve an hbuttonbox from the GladeXML.

Parameters:

	glade_xml	The GladeXML handle used for the GUI.
	name	The name of the widget to retrieve.

Returns:: The hbuttonbox associated with the specified name.

References get_widget().

GtkLabel * cajun::gtk_utils::get_label	(	GladeXML *	glade_xml,
		const gchar *	name
	)

Retrieve a label from the GladeXML.

Parameters:

	glade_xml	The GladeXML handle used for the GUI.
	name	The name of the widget to retrieve.

Returns:: The label associated with the specified name.

References get_widget().

Referenced by gtk_label_get_text(), and gtk_label_set_text().

GtkProgressBar * cajun::gtk_utils::get_progressbar	(	GladeXML *	glade_xml,
		const gchar *	name
	)

Retrieve a progress bar from the GladeXML.

Parameters:

	glade_xml	The GladeXML handle used for the GUI.
	name	The name of the widget to retrieve.

Returns:: The progress bar associated with the specified name.

References get_widget().

Referenced by gtk_update_progressbar().

GtkStatusbar * cajun::gtk_utils::get_statusbar	(	GladeXML *	glade_xml,
		const gchar *	name
	)

Retrieve a status bar from the GladeXML.

Parameters:

	glade_xml	The GladeXML handle used for the GUI.
	name	The name of the widget to retrieve.

Returns:: The status bar associated with the specified name.

References get_widget().

GtkTextView * cajun::gtk_utils::get_textview	(	GladeXML *	glade_xml,
		const gchar *	name
	)

Retrieve a textview entry from the GladeXML.

Parameters:

	glade_xml	The GladeXML handle used for the GUI.
	name	The name of the widget to retrieve.

Returns:: The textview entry associated with the specified name.

References get_widget().

GtkTextBuffer * cajun::gtk_utils::get_textview_buffer	(	GladeXML *	glade_xml,
		const gchar *	name
	)

Retrieve a textview buffer from the GladeXML.

Parameters:

	glade_xml	The GladeXML handle used for the GUI.
	name	The name of the widget to retrieve. This is the name of the textview, the associated textview buffer will be retrieved.

Returns:: The textview buffer associated with the specified name of the textview provided.

References get_widget().

Referenced by clear_textview(), gtk_textview_get_text(), and gtk_textview_set_text().

GtkTreeView * cajun::gtk_utils::get_treeview	(	GladeXML *	glade_xml,
		const gchar *	name
	)

Retrieve a treeview from the GladeXML.

Parameters:

	glade_xml	The GladeXML handle used for the GUI.
	name	The name of the widget to retrieve.

Returns:: The treeview associated with the specified name.

References get_widget().

GtkWidget * cajun::gtk_utils::get_widget	(	GladeXML *	glade_xml,
		const gchar *	name
	)

Retrieve a widget from the GladeXML.

Parameters:

	glade_xml	The GladeXML handle used for the GUI.
	name	The name of the widget to retrieve.

Returns:: The widget associated with the specified name.

Referenced by get_checkbutton(), get_combo(), get_entry(), get_expander(), get_gnomedateedit(), get_hbuttonbox(), get_label(), get_progressbar(), get_statusbar(), get_textview(), get_textview_buffer(), get_treeview(), get_window(), hide(), and show().

GtkWindow * cajun::gtk_utils::get_window	(	GladeXML *	glade_xml,
		const gchar *	name
	)

Retrieve a window from the GladeXML.

Parameters:

	glade_xml	The GladeXML handle used for the GUI.
	name	The name of the widget to retrieve.

Returns:: The window associated with the specified name.

References get_widget().

void cajun::gtk_utils::gtk_combo_box_add_entries	(	GtkComboBox *	gtk_cb,
		vector< string >	entries
	)

Add entries to a combo box.

Parameters:

	gtk_cb	The combo box to use.
	entries	A vector of string values to add to the combo box.

gint cajun::gtk_utils::gtk_combo_box_get_active	(	GladeXML *	glade_xml,
		const gchar *	name
	)

Get the active index for a combo box.

Parameters:

	glade_xml	The GladeXML handle used for the GUI.
	name	The name of the widget to get the active index.

Returns:: The active index of the combo box.

References get_combo().

const gchar * cajun::gtk_utils::gtk_combo_box_get_active_text	(	GladeXML *	glade_xml,
		const gchar *	name
	)

Get the active text at the active index for a combo box.

Parameters:

	glade_xml	The GladeXML handle used for the GUI.
	name	The name of the widget to get the active text.

Returns:: The active text at the active index of the combo box.

References get_combo().

Referenced by gtk_combo_box_set_active_text().

gboolean cajun::gtk_utils::gtk_combo_box_set_active	(	GladeXML *	glade_xml,
		const gchar *	name,
		gint	index
	)

Set the active index for a combo box.

Parameters:

	glade_xml	The GladeXML handle used for the GUI.
	name	The name of the widget to set the active index.
	index	The 0-based index to set.

Returns:: True.

References get_combo().

Referenced by gtk_combo_box_set_active_text().

gboolean cajun::gtk_utils::gtk_combo_box_set_active_text	(	GladeXML *	glade_xml,
		const gchar *	name,
		map< string, string >	entry_map,
		const gchar *	text
	)

Set the active (user-friendly) text of a combo box from "configuration" text.

For example, if a combo box has entries in a "user-friendly" form, and a map is used to translate "configuration" values into more user-friendly text, a specified "configuration" value can be pre-selected easily this way.

Parameters:

	glade_xml	The GladeXML handle used for the GUI.
	name	The name of the widget to set the active text on.
	entry_map	A map of "configuration" values to "user-friendly" values.
	text	A "configuration" value which should be pre-selected.

Returns:: True if the specified text was found in the combo box and was made the active selection. Otherwise, the last entry will be selected.

References get_combo(), and gtk_combo_box_set_active_text().

gboolean cajun::gtk_utils::gtk_combo_box_set_active_text	(	GtkComboBox *	gtk_cb,
		map< string, string >	entry_map,
		const gchar *	text
	)

Set the active (user-friendly) text of a combo box from "configuration" text.

For example, if a combo box has entries in a "user-friendly" form, and a map is used to translate "configuration" values into more user-friendly text, a specified "configuration" value can be pre-selected easily this way.

Parameters:

	gtk_cb	The combo box to use.
	entry_map	A map of "configuration" values to "user-friendly" values.
	text	A "configuration" value which should be pre-selected.

Returns:: True if the specified text was found in the combo box and was made the active selection. Otherwise, the last entry will be selected.

References gtk_combo_box_get_active_text(), and gtk_combo_box_set_active().

gboolean cajun::gtk_utils::gtk_combo_box_set_active_text	(	GladeXML *	glade_xml,
		const gchar *	name,
		const gchar *	text
	)

Set the active text of a combo box.

For example, if a combo box has three entries, and a configuration value specifies that one of them should be selected by default, then this function can be used to make that specific entry pre-selected.

Parameters:

	glade_xml	The GladeXML handle used for the GUI.
	name	The name of the widget to set the active text on.
	text	The text to check for and set active.

Returns:: True if the specified text was found in the combo box and was made the active selection. Otherwise, the last entry will be selected.

References get_combo(), and gtk_combo_box_set_active_text().

gboolean cajun::gtk_utils::gtk_combo_box_set_active_text	(	GtkComboBox *	gtk_cb,
		const gchar *	text
	)

Set the active text of a combo box.

For example, if a combo box has three entries, and a configuration value specifies that one of them should be selected by default, then this function can be used to make that specific entry pre-selected.

Parameters:

	gtk_cb	The combo box to use.
	text	The text to search for and make active.

Returns:: True if the specified text was found in the combo box and was made the active selection. Otherwise, the last entry will be selected.

References gtk_combo_box_get_active_text(), and gtk_combo_box_set_active().

Referenced by gtk_combo_box_set_active_text().

const gchar * cajun::gtk_utils::gtk_entry_get_text	(	GladeXML *	glade_xml,
		const gchar *	name
	)

Retrieve an entry's text from the GladeXML.

Parameters:

	glade_xml	The GladeXML handle used for the GUI.
	name	The name of the widget to retrieve the text from.

Returns:: The entry's text associated with the specified name.

References get_entry().

gboolean cajun::gtk_utils::gtk_entry_set_text	(	GladeXML *	glade_xml,
		const gchar *	name,
		const gchar *	text
	)

Set an entry's text in the GladeXML.

Parameters:

	glade_xml	The GladeXML handle used for the GUI.
	name	The name of the widget to set the text for.
	text	The text to set.

Returns:: True.

References get_entry().

const gchar * cajun::gtk_utils::gtk_label_get_text	(	GladeXML *	glade_xml,
		const gchar *	name
	)

Retrieve a label's text from the GladeXML.

Parameters:

	glade_xml	The GladeXML handle used for the GUI.
	name	The name of the widget to retrieve the text from.

Returns:: The label's text associated with the specified name.

References get_label().

void cajun::gtk_utils::gtk_label_set_text	(	GladeXML *	glade_xml,
		const gchar *	name,
		const gchar *	text
	)

Set a label's text in the GladeXML.

Parameters:

	glade_xml	The GladeXML handle used for the GUI.
	name	The name of the widget to set the text for.
	text	The text to set.

References get_label().

gboolean cajun::gtk_utils::gtk_refresh_gnomedateedit	(	GladeXML *	glade_xml,
		const gchar *	name
	)

Update the Gnome date edit to the current system time.

Parameters:

	glade_xml	The GladeXML handle used for the GUI.
	name	The name of the widget to use.

Returns:: True.

References get_gnomedateedit().

const gchar * cajun::gtk_utils::gtk_textview_get_text	(	GladeXML *	glade_xml,
		const gchar *	textview_name
	)

Retrieve a textview's text from the GladeXML.

Parameters:

	glade_xml	The GladeXML handle used for the GUI.
	textview_name	The name of the widget to retrieve the text from.

Returns:: The textview's text associated with the specified name.

References get_textview_buffer().

gboolean cajun::gtk_utils::gtk_textview_set_text	(	GladeXML *	glade_xml,
		const gchar *	name,
		const gchar *	text
	)

Set a textview's text in the GladeXML.

Parameters:

	glade_xml	The GladeXML handle used for the GUI.
	name	The name of the widget to set the text for.
	text	The text to set.

Returns:: True.

References get_textview_buffer().

gboolean cajun::gtk_utils::gtk_update_progressbar	(	GladeXML *	glade_xml,
		const gchar *	name,
		gdouble	frac
	)

Update a progress bar to a particular percentage.

Parameters:

	glade_xml	The GladeXML handle used for the GUI.
	name	The name of the widget to use.
	frac	The percentage that the progress bar should be at.

Returns:: True.

References get_progressbar(), and update_progress().

gboolean cajun::gtk_utils::gtk_update_progressbar	(	GladeXML *	glade_xml,
		const gchar *	name
	)

Pulse an indeterminant progress bar.

Parameters:

	glade_xml	The GladeXML handle used for the GUI.
	name	The name of the widget to use.

Returns:: True.

References get_progressbar(), and update_progress().

void cajun::gtk_utils::hide ( GtkWindow * w )

Hide a window.

Parameters:

w

The window to hide.

void cajun::gtk_utils::hide ( GtkWidget * w )

Hide a widget.

Parameters:

w

The widget to hide.

void cajun::gtk_utils::hide	(	GladeXML *	glade_xml,
		const gchar *	name
	)

Hide a widget.

Parameters:

	glade_xml	The GladeXML handle used for the GUI.
	name	The name of the widget to hide.

References get_widget().

gchar * cajun::gtk_utils::make_bin_filename_gchar ( const gchar * name )

Retrieve the full path to where binaries are stored for cbsystem. Checks CBHOME.

Parameters:

name

The name of a binary in cbsystem.

Returns:: The full path to the binary based on $CBHOME/bin/[name]

GString * cajun::gtk_utils::make_bin_filename_gstring ( const gchar * name )

Retrieve the full path to where binaries are stored for cbsystem. Checks CBHOME.

Parameters:

name

The name of a binary in cbsystem.

Returns:: The full path to the binary based on $CBHOME/bin/[name]

gchar * cajun::gtk_utils::make_bot_config_filename_gchar ( const gchar * name )

Retrieve the full path to where bot config files are stored for cbsystem. Checks CBCONF and CBBOTNAME.

Parameters:

name

The name of a bot config file in cbsystem.

Returns:: The full path to the bot config file based on $CBCONF/$CBBOTNAME/[name]

GString * cajun::gtk_utils::make_bot_config_filename_gstring ( const gchar * name )

Retrieve the full path to where bot config files are stored for cbsystem. Checks CBCONF and CBBOTNAME.

Parameters:

name

The name of a bot config file in cbsystem.

Returns:: The full path to the bot config file based on $CBCONF/$CBBOTNAME/[name]

gchar * cajun::gtk_utils::make_config_filename_gchar ( const gchar * name )

Retrieve the full path to where config files are stored for cbsystem. Checks CBCONF.

Parameters:

name

The name of a config file in cbsystem.

Returns:: The full path to the config file based on $CBCONF/[name]

GString * cajun::gtk_utils::make_config_filename_gstring ( const gchar * name )

Retrieve the full path to where config files are stored for cbsystem. Checks CBCONF.

Parameters:

name

The name of a config file in cbsystem.

Returns:: The full path to the config file based on $CBCONF/[name]

gchar * cajun::gtk_utils::make_docs_filename_gchar ( const gchar * name )

Retrieve the full path to where documentation files are stored for cbsystem. Checks CBHOME.

Parameters:

name

The name of a documentation file in cbsystem.

Returns:: The full path to the documentation file based on $CBHOME/docs/[name]

GString * cajun::gtk_utils::make_docs_filename_gstring ( const gchar * name )

Retrieve the full path to where documentation files are stored for cbsystem. Checks CBHOME.

Parameters:

name

The name of a documentation file in cbsystem.

Returns:: The full path to the documentation file based on $CBHOME/docs/[name]

gchar * cajun::gtk_utils::make_support_filename_gchar	(	const gchar *	progname,
		const gchar *	name
	)

Retrieve the full path to where support files are stored for cbsystem. Checks CBSUPPORT.

Parameters:

	progname	The name of the program the support file is for.
	name	The name of a support file.

Returns:: The full path to the support file based on $CBSUPPORT/share/[progname]/[name]

GString * cajun::gtk_utils::make_support_filename_gstring	(	const gchar *	progname,
		const gchar *	name
	)

Retrieve the full path to where support files are stored for cbsystem. Checks CBSUPPORT.

Parameters:

	progname	The name of the program the support file is for.
	name	The name of a support file.

Returns:: The full path to the support file based on $CBSUPPORT/share/[progname]/[name]

gchar * cajun::gtk_utils::make_tmp_filename_gchar ( const gchar * name )

Retrieve the full path to where temporary files are stored.

Parameters:

name

The name of the temporary file.

Returns:: The full path to the temporary file.

GString * cajun::gtk_utils::make_tmp_filename_gstring ( const gchar * name )

Retrieve the full path to where temporary files are stored.

Parameters:

name

The name of the temporary file.

Returns:: The full path to the temporary file.

void cajun::gtk_utils::show ( GtkWindow * w )

Show a window.

Parameters:

w

The window to show.

void cajun::gtk_utils::show ( GtkWidget * w )

Show a widget.

Parameters:

w

The widget to show.

void cajun::gtk_utils::show	(	GladeXML *	glade_xml,
		const gchar *	name
	)

Show a widget.

Parameters:

	glade_xml	The GladeXML handle used for the GUI.
	name	The name of the widget to show.

References get_widget().

void cajun::gtk_utils::sleep ( unsigned time )

Sleep for specified ms but keep GUI events fresh and flushed.

Parameters:

time

The amount of time to sleep for, in milliseconds.

References flush_events().

GString * cajun::gtk_utils::span_tag	(	const gchar *	text,
		const gchar *	color,
		const gchar *	size
	)

Create the string for the span tag, useful for textviews.

Parameters:

	text	The text contents to wrap.
	color	The color of the text.
	size	The pango-defined size for the text

Returns:: The markup which will color and size the text.

GString * cajun::gtk_utils::span_tag	(	const gchar *	text,
		const gchar *	color
	)

Create the string for the span tag, useful for textviews.

Parameters:

	text	The text contents to wrap.
	color	The color of the text.

Returns:: The markup which will color the text.

void cajun::gtk_utils::update_progress	(	GtkProgressBar *	bar,
		gdouble	frac
	)

Update a progress bar to a particular percentage.

Parameters:

	bar	The progress bar to update.
	frac	The percentage that the progress bar should be at.

References flush_events().

void cajun::gtk_utils::update_progress ( GtkProgressBar * bar )

Pulse an indeterminant progress bar.

Parameters:

bar

The progress bar to pulse.

References flush_events().

Referenced by gtk_update_progressbar().

cajun::gtk_utils Namespace Reference

Functions

Function Documentation