pidgin/prefs/pidginprefs.h

changeset 41397
91e5ee47f5a1
parent 41197
1fbba07f21cf
child 42072
606edc665dc2
equal deleted inserted replaced
41396:2ef3d6eeffb3 41397:91e5ee47f5a1
1 /* pidgin 1 /*
2 * Pidgin - Internet Messenger
3 * Copyright (C) Pidgin Developers <devel@pidgin.im>
2 * 4 *
3 * Pidgin is the legal property of its developers, whose names are too numerous 5 * Pidgin is the legal property of its developers, whose names are too numerous
4 * to list here. Please refer to the COPYRIGHT file distributed with this 6 * to list here. Please refer to the COPYRIGHT file distributed with this
5 * source distribution. 7 * source distribution.
6 * 8 *
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of 15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details. 17 * GNU General Public License for more details.
16 * 18 *
17 * You should have received a copy of the GNU General Public License 19 * You should have received a copy of the GNU General Public License
18 * along with this program; if not, write to the Free Software 20 * along with this program; if not, see <https://www.gnu.org/licenses/>.
19 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02111-1301 USA
20 *
21 */ 21 */
22 22
23 #if !defined(PIDGIN_GLOBAL_HEADER_INSIDE) && !defined(PIDGIN_COMPILATION) 23 #if !defined(PIDGIN_GLOBAL_HEADER_INSIDE) && !defined(PIDGIN_COMPILATION)
24 # error "only <pidgin.h> may be included directly" 24 # error "only <pidgin.h> may be included directly"
25 #endif 25 #endif
26 26
27 #ifndef PIDGIN_PREFS_H 27 #ifndef PIDGIN_PREFS_H
28 #define PIDGIN_PREFS_H 28 #define PIDGIN_PREFS_H
29 29
30 #include <glib.h>
30 #include <purple.h> 31 #include <purple.h>
32 #include <gtk/gtk.h>
31 33
32 G_BEGIN_DECLS 34 G_BEGIN_DECLS
33 35
34 #define PIDGIN_TYPE_PREFS_WINDOW (pidgin_prefs_window_get_type()) 36 #define PIDGIN_TYPE_PREFS_WINDOW (pidgin_prefs_window_get_type())
35 G_DECLARE_FINAL_TYPE(PidginPrefsWindow, pidgin_prefs_window, PIDGIN, PREFS_WINDOW, GtkDialog) 37 G_DECLARE_FINAL_TYPE(PidginPrefsWindow, pidgin_prefs_window, PIDGIN,
38 PREFS_WINDOW, GtkDialog)
36 39
37 /** 40 /**
38 * pidgin_prefs_init: 41 * pidgin_prefs_init:
39 * 42 *
40 * Initializes all UI-specific preferences. 43 * Initializes all UI-specific preferences.
78 */ 81 */
79 GtkWidget *pidgin_prefs_labeled_spin_button(GtkWidget *page, 82 GtkWidget *pidgin_prefs_labeled_spin_button(GtkWidget *page,
80 const gchar *title, const char *key, int min, int max, GtkSizeGroup *sg); 83 const gchar *title, const char *key, int min, int max, GtkSizeGroup *sg);
81 84
82 /** 85 /**
83 * pidgin_prefs_labeled_entry:
84 * @page: The page to which the entry will be added
85 * @title: The text to be displayed as the entry label
86 * @key: The key of the string pref that will be represented by the entry
87 * @sg: If not NULL, the size group to which the entry will be added
88 *
89 * Add a new entry representing a string preference
90 *
91 * Returns: (transfer full) :An hbox containing both the label and the entry. Can be used to set
92 * the widgets to sensitive or insensitive based on the value of a
93 * checkbox.
94 */
95 GtkWidget *pidgin_prefs_labeled_entry(GtkWidget *page, const gchar *title,
96 const char *key, GtkSizeGroup *sg);
97
98 /**
99 * pidgin_prefs_labeled_password:
100 * @page: The page to which the entry will be added
101 * @title: The text to be displayed as the entry label
102 * @key: The key of the string pref that will be represented by the entry
103 * @sg: If not NULL, the size group to which the entry will be added
104 *
105 * Add a new entry representing a password (string) preference
106 * The entry will use a password-style text entry (the text is substituted)
107 *
108 * Returns: (transfer full): An hbox containing both the label and the entry. Can be used to set
109 * the widgets to sensitive or insensitive based on the value of a
110 * checkbox.
111 */
112 GtkWidget *pidgin_prefs_labeled_password(GtkWidget *page, const gchar *title,
113 const char *key, GtkSizeGroup *sg);
114
115 /**
116 * pidgin_prefs_dropdown: 86 * pidgin_prefs_dropdown:
117 * @page: The page to which the dropdown will be added 87 * @page: The page to which the dropdown will be added
118 * @title: The text to be displayed as the dropdown label 88 * @title: The text to be displayed as the dropdown label
119 * @type: The type of preference to be stored in the generated dropdown 89 * @type: The type of preference to be stored in the generated dropdown
120 * @key: The key of the pref that will be represented by the dropdown 90 * @key: The key of the pref that will be represented by the dropdown

mercurial