gtkprefs.h File Reference

GTK+ Preferences

pidgin. More...

#include "prefs.h"

Include dependency graph for gtkprefs.h:

Go to the source code of this file.

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

pidgin.

Pidgin is the legal property of its developers, whose names are too numerous to list here. Please refer to the COPYRIGHT file distributed with this source distribution.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA


Function Documentation

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_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.