pidgin/pidginaccountdisplay.h

Mon, 20 Mar 2023 22:25:54 -0500

author
Elliott Sales de Andrade <quantum.analyst@gmail.com>
date
Mon, 20 Mar 2023 22:25:54 -0500
changeset 42165
3c481d9cc840
child 42465
b7d530551c1b
permissions
-rw-r--r--

Split account display from chooser into its own widget

This will allow re-using it elsewhere when we need to display the account.

Testing Done:
Compiled and opened Add a Buddy dialog, Room List, etc. that used the chooser.

Reviewed at https://reviews.imfreedom.org/r/2360/

42165
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
1 /*
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
2 * Pidgin - Internet Messenger
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
3 * Copyright (C) Pidgin Developers <devel@pidgin.im>
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
4 *
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
5 * Pidgin is the legal property of its developers, whose names are too numerous
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
6 * to list here. Please refer to the COPYRIGHT file distributed with this
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
7 * source distribution.
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
8 *
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
9 * This program is free software; you can redistribute it and/or modify
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
10 * it under the terms of the GNU General Public License as published by
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
11 * the Free Software Foundation; either version 2 of the License, or
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
12 * (at your option) any later version.
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
13 *
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
14 * This program is distributed in the hope that it will be useful,
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
17 * GNU General Public License for more details.
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
18 *
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
19 * You should have received a copy of the GNU General Public License
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
20 * along with this program; if not, see <https://www.gnu.org/licenses/>.
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
21 */
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
22
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
23 #if !defined(PIDGIN_GLOBAL_HEADER_INSIDE) && !defined(PIDGIN_COMPILATION)
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
24 # error "only <pidgin.h> may be included directly"
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
25 #endif
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
26
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
27 #ifndef PIDGIN_ACCOUNT_DISPLAY_H
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
28 #define PIDGIN_ACCOUNT_DISPLAY_H
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
29
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
30 #include <gtk/gtk.h>
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
31
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
32 #include <purple.h>
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
33
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
34 G_BEGIN_DECLS
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
35
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
36 #define PIDGIN_TYPE_ACCOUNT_DISPLAY (pidgin_account_display_get_type())
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
37 G_DECLARE_FINAL_TYPE(PidginAccountDisplay, pidgin_account_display, PIDGIN,
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
38 ACCOUNT_DISPLAY, GtkBox)
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
39
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
40 /**
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
41 * pidgin_account_display_new:
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
42 * @account: The account to display.
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
43 *
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
44 * Creates a display for an account.
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
45 *
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
46 * Returns: (transfer full): The account display.
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
47 *
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
48 * Since: 3.0.0
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
49 */
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
50 GtkWidget *pidgin_account_display_new(PurpleAccount *account);
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
51
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
52 /**
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
53 * pidgin_account_display_get_account:
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
54 * @display: The display.
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
55 *
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
56 * Gets the currently displayed account.
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
57 *
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
58 * Returns: (transfer none): Returns the [type@Purple.Account] that is
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
59 * currently displayed.
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
60 *
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
61 * Since: 3.0.0
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
62 */
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
63 PurpleAccount *pidgin_account_display_get_account(PidginAccountDisplay *display);
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
64
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
65 /**
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
66 * pidgin_account_display_set_account:
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
67 * @display: The display.
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
68 * @account: The account to display.
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
69 *
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
70 * Sets the currently displayed account.
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
71 *
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
72 * Since: 3.0.0
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
73 */
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
74 void pidgin_account_display_set_account(PidginAccountDisplay *display, PurpleAccount *account);
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
75
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
76 G_END_DECLS
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
77
3c481d9cc840 Split account display from chooser into its own widget
Elliott Sales de Andrade <quantum.analyst@gmail.com>
parents:
diff changeset
78 #endif /* PIDGIN_ACCOUNT_DISPLAY_H */

mercurial