gtkprefs.h File Reference

GTK+ Preferences. More...

#include "prefs.h"

Include dependency graph for gtkprefs.h:


Functions
void	pidgin_prefs_init (void)
	Initializes all UI-specific preferences.
void	pidgin_prefs_show (void)
	Shows the preferences dialog.
GtkWidget *	pidgin_prefs_checkbox (const char title, const char key, GtkWidget *page)
	Add a new checkbox for a boolean preference.
GtkWidget *	pidgin_prefs_labeled_spin_button (GtkWidget page, const gchar title, const char key, int min, int max, GtkSizeGroup sg)
	Add a new spin button representing an int preference.
GtkWidget *	pidgin_prefs_labeled_entry (GtkWidget page, const gchar title, const char key, GtkSizeGroup sg)
	Add a new entry representing a string preference.
GtkWidget *	pidgin_prefs_labeled_password (GtkWidget page, const gchar title, const char key, GtkSizeGroup sg)
	Add a new entry representing a password (string) preference The entry will use a password-style text entry (the text is substituded).
GtkWidget *	pidgin_prefs_dropdown (GtkWidget page, const gchar title, PurplePrefType type, const char *key,...)
	Add a new dropdown representing a preference of the specified type.
GtkWidget *	pidgin_prefs_dropdown_from_list (GtkWidget page, const gchar title, PurplePrefType type, const char key, GList menuitems)
	Add a new dropdown representing a preference of the specified type.
void	pidgin_prefs_update_old (void)
	Rename legacy prefs and delete some that no longer exist.

Detailed Description

GTK+ Preferences.

Definition in file gtkprefs.h.

GtkWidget* pidgin_prefs_checkbox	(	const char *	title,
		const char *	key,
		GtkWidget *	page
	)

Add a new checkbox for a boolean preference.

Parameters:

	title	The text to be displayed as the checkbox label
	key	The key of the purple bool pref that will be represented by the checkbox
	page	The page to which the new checkbox will be added

GtkWidget* pidgin_prefs_dropdown	(	GtkWidget *	page,
		const gchar *	title,
		PurplePrefType	type,
		const char *	key,
			...
	)

Add a new dropdown representing a preference of the specified type.

Parameters:

	page	The page to which the dropdown will be added
	title	The text to be displayed as the dropdown label
	type	The type of preference to be stored in the generated dropdown
	key	The key of the pref that will be represented by the dropdown
	...	The choices to be added to the dropdown, choices should be paired as label/value

GtkWidget* pidgin_prefs_dropdown_from_list	(	GtkWidget *	page,
		const gchar *	title,
		PurplePrefType	type,
		const char *	key,
		GList *	menuitems
	)

Add a new dropdown representing a preference of the specified type.

Parameters:

	page	The page to which the dropdown will be added
	title	The text to be displayed as the dropdown label
	type	The type of preference to be stored in the dropdown
	key	The key of the pref that will be represented by the dropdown
	menuitems	The choices to be added to the dropdown, choices should be paired as label/value

GtkWidget* pidgin_prefs_labeled_entry	(	GtkWidget *	page,
		const gchar *	title,
		const char *	key,
		GtkSizeGroup *	sg
	)

Add a new entry representing a string preference.

Parameters:

	page	The page to which the entry will be added
	title	The text to be displayed as the entry label
	key	The key of the string pref that will be represented by the entry
	sg	If not NULL, the size group to which the entry will be added

Returns:: An hbox containing both the label and the entry. Can be used to set the widgets to sensitive or insensitive based on the value of a checkbox.

GtkWidget* pidgin_prefs_labeled_password	(	GtkWidget *	page,
		const gchar *	title,
		const char *	key,
		GtkSizeGroup *	sg
	)

Add a new entry representing a password (string) preference The entry will use a password-style text entry (the text is substituded).

Parameters:

	page	The page to which the entry will be added
	title	The text to be displayed as the entry label
	key	The key of the string pref that will be represented by the entry
	sg	If not NULL, the size group to which the entry will be added

Returns:: An hbox containing both the label and the entry. Can be used to set the widgets to sensitive or insensitive based on the value of a checkbox.

GtkWidget* pidgin_prefs_labeled_spin_button	(	GtkWidget *	page,
		const gchar *	title,
		const char *	key,
		int	min,
		int	max,
		GtkSizeGroup *	sg
	)

Add a new spin button representing an int preference.

Parameters:

	page	The page to which the spin button will be added
	title	The text to be displayed as the spin button label
	key	The key of the int pref that will be represented by the spin button
	min	The minimum value of the spin button
	max	The maximum value of the spin button
	sg	If not NULL, the size group to which the spin button will be added

Returns:: An hbox containing both the label and the spinner. Can be used to set the widgets to sensitive or insensitive based on the value of a checkbox.