pidgin/prefs/pidginprefs.h

changeset 42192
82dbf36ac6db
parent 42072
606edc665dc2
child 42464
5de142a471e0
equal deleted inserted replaced
42191:68380e709c16 42192:82dbf36ac6db
43 * Initializes all UI-specific preferences. 43 * Initializes all UI-specific preferences.
44 */ 44 */
45 void pidgin_prefs_init(void); 45 void pidgin_prefs_init(void);
46 46
47 /** 47 /**
48 * pidgin_prefs_checkbox:
49 * @title: The text to be displayed as the checkbox label
50 * @key: The key of the purple bool pref that will be represented by the checkbox
51 * @page: The page to which the new checkbox will be added
52 *
53 * Add a new checkbox for a boolean preference
54 *
55 * Returns: (transfer full): The new checkbox
56 */
57 GtkWidget *pidgin_prefs_checkbox(const char *title, const char *key,
58 GtkWidget *page);
59
60 /**
61 * pidgin_prefs_labeled_spin_button:
62 * @page: The page to which the spin button will be added
63 * @title: The text to be displayed as the spin button label
64 * @key: The key of the int pref that will be represented by the spin button
65 * @min: The minimum value of the spin button
66 * @max: The maximum value of the spin button
67 * @sg: If not NULL, the size group to which the spin button will be added
68 *
69 * Add a new spin button representing an int preference
70 *
71 * Returns: (transfer full): An hbox containing both the label and the spinner. Can be
72 * used to set the widgets to sensitive or insensitive based on the
73 * value of a checkbox.
74 */
75 GtkWidget *pidgin_prefs_labeled_spin_button(GtkWidget *page,
76 const gchar *title, const char *key, int min, int max, GtkSizeGroup *sg);
77
78 /**
79 * pidgin_prefs_dropdown:
80 * @page: The page to which the dropdown will be added
81 * @title: The text to be displayed as the dropdown label
82 * @type: The type of preference to be stored in the generated dropdown
83 * @key: The key of the pref that will be represented by the dropdown
84 * @...: The choices to be added to the dropdown, choices should be
85 * paired as label/value
86 *
87 * Add a new dropdown representing a preference of the specified type
88 *
89 * Returns: (transfer full): The new dropdown.
90 */
91 GtkWidget *pidgin_prefs_dropdown(GtkWidget *page, const gchar *title,
92 PurplePrefType type, const char *key, ...);
93
94 /**
95 * pidgin_prefs_dropdown_from_list:
96 * @page: The page to which the dropdown will be added
97 * @title: The text to be displayed as the dropdown label
98 * @type: The type of preference to be stored in the dropdown
99 * @key: The key of the pref that will be represented by the dropdown
100 * @menuitems: (element-type PurpleKeyValuePair): The choices to be added to the dropdown, choices should
101 * be paired as label/value
102 *
103 * Add a new dropdown representing a preference of the specified type
104 *
105 * Returns: (transfer full): The new dropdown.
106 */
107 GtkWidget *pidgin_prefs_dropdown_from_list(GtkWidget *page,
108 const gchar * title, PurplePrefType type, const char *key,
109 GList *menuitems);
110
111 /**
112 * pidgin_prefs_update_old: 48 * pidgin_prefs_update_old:
113 * 49 *
114 * Rename legacy prefs and delete some that no longer exist. 50 * Rename legacy prefs and delete some that no longer exist.
115 */ 51 */
116 void pidgin_prefs_update_old(void); 52 void pidgin_prefs_update_old(void);

mercurial