*

* An implementation of [iface@Purple.IdleUi] for Pidgin.

*

*/

#define PIDGIN_TYPE_IDLE (pidgin_idle_get_type())

*

* Returns: (transfer full): The new instance.

*

*/

PIDGIN_AVAILABLE_IN_3_0

PurpleIdleUi *pidgin_idle_new(void);

*

* Returns: The GTK UI notify operations structure.

*

*/

PIDGIN_AVAILABLE_IN_ALL

PurpleNotifyUiOps *pidgin_notify_get_ui_ops(void);

*

* Initializes the GTK notifications subsystem.

*

*/

PIDGIN_AVAILABLE_IN_2_6

void pidgin_notify_init(void);

*

* Uninitialized the GTK notifications subsystem.

*

*/

PIDGIN_AVAILABLE_IN_2_6

void pidgin_notify_uninit(void);

*

* Returns: The GTK UI request operations structure.

*

*/

PIDGIN_AVAILABLE_IN_ALL

PurpleRequestUiOps *pidgin_request_get_ui_ops(void);

*

* Returns: (transfer none): The dialog window.

*

*/

PIDGIN_AVAILABLE_IN_3_0

GtkWindow *

*

* Returns: The requests subsystem handle.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void *pidgin_request_get_handle(void);

*

* Initializes the GTK requests subsystem.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_request_init(void);

*

* Uninitializes the GTK requests subsystem.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_request_uninit(void);

*

* Initializes the room list subsystem.

*

*/

PIDGIN_AVAILABLE_IN_ALL

void pidgin_roomlist_init(void);

* Returns: TRUE if there are accounts online that support listing

* chat rooms. Otherwise return FALSE.

*

*/

PIDGIN_AVAILABLE_IN_ALL

gboolean pidgin_roomlist_is_showable(void);

*

* Shows a new roomlist dialog.

*

*/

PIDGIN_AVAILABLE_IN_ALL

void pidgin_roomlist_dialog_show(void);

*

* Shows a new room list dialog and fetches the list for the specified account.

*

*/

PIDGIN_AVAILABLE_IN_ALL

void pidgin_roomlist_dialog_show_with_account(PurpleAccount *account);

*

* Get information about a user. Show immediate feedback.

*

*/

PIDGIN_AVAILABLE_IN_2_1

void pidgin_retrieve_user_info(PurpleConnection *conn, const char *name);

*

* Get information about a user in a chat. Show immediate feedback.

*

*/

PIDGIN_AVAILABLE_IN_2_1

void pidgin_retrieve_user_info_in_chat(PurpleConnection *conn, const char *name, int chatid);

* Sets an ATK name for a given widget. Also sets the labelled-by

* and label-for ATK relationships.

*

*/

PIDGIN_AVAILABLE_IN_ALL

void pidgin_set_accessible_label(GtkWidget *w, GtkLabel *l);

*

* Returns: Whether the window was made transient or not.

*

*/

PIDGIN_AVAILABLE_IN_2_4

gboolean pidgin_auto_parent_window(GtkWidget *window);

*

* Returns: (transfer full): A GtkBox already added to the GtkBox containing the GtkLabel and the GtkWidget.

*

*/

PIDGIN_AVAILABLE_IN_2_4

GtkWidget *pidgin_add_widget_to_vbox(GtkBox *vbox, const char *widget_label, GtkSizeGroup *sg, GtkWidget *widget, gboolean expand, GtkWidget **p_label);

*

* Returns: The GtkWhiteboard UI Operations.

*

*/

PIDGIN_AVAILABLE_IN_ALL

PurpleWhiteboardUiOps *pidgin_whiteboard_get_ui_ops(void);

*

* Returns: (transfer full): A new instance of the about dialog.

*

*/

PIDGIN_AVAILABLE_IN_3_0

GtkWidget *pidgin_about_dialog_new(void);

*

* Returns: (transfer full): The account chooser combo box.

*

*/

PIDGIN_AVAILABLE_IN_3_0

GtkWidget *pidgin_account_chooser_new(void);

* Returns: (transfer none): Returns the #GtkFilter that is currently

* displayed.

*

*/

PIDGIN_AVAILABLE_IN_3_0

GtkFilter *pidgin_account_chooser_get_filter(PidginAccountChooser *chooser);

*

* Sets the current list filter for the account chooser.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_account_chooser_set_filter(PidginAccountChooser *chooser, GtkFilter *filter);

* Returns: (transfer full): Returns the #PurpleAccount that is currently

* selected.

*

*/

PIDGIN_AVAILABLE_IN_3_0

PurpleAccount *pidgin_account_chooser_get_selected(PidginAccountChooser *chooser);

*

* Sets the currently selected account for an account combo box.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_account_chooser_set_selected(PidginAccountChooser *chooser,

*

* The account that is currently displayed.

*

*/

properties[PROP_ACCOUNT] = g_param_spec_object(

"account", "Account", "The account that is currently displayed.",

*

* Returns: (transfer full): The account display.

*

*/

PIDGIN_AVAILABLE_IN_3_0

GtkWidget *pidgin_account_display_new(PurpleAccount *account);

* Returns: (transfer none): Returns the [type@Purple.Account] that is

* currently displayed.

*

*/

PIDGIN_AVAILABLE_IN_3_0

PurpleAccount *pidgin_account_display_get_account(PidginAccountDisplay *display);

*

* Sets the currently displayed account.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_account_display_set_account(PidginAccountDisplay *display, PurpleAccount *account);

*

* The account that this editor is modifying.

*

*/

properties[PROP_ACCOUNT] = g_param_spec_object(

"account", "account",

* Whether or not the account settings are valid and it is okay to save the

* account.

*

*/

properties[PROP_VALID] = g_param_spec_boolean(

"valid", "valid",

*

* #PidginAccountEditor is a dialog that allows you to edit an account.

*

*/

G_BEGIN_DECLS

*

* Returns: (transfer full): The new instance.

*

*/

PIDGIN_AVAILABLE_IN_3_0

GtkWidget *pidgin_account_editor_new(PurpleAccount *account);

*

* Returns: (transfer none): The [class@Purple.Account] or %NULL.

*

*/

PIDGIN_AVAILABLE_IN_3_0

PurpleAccount *pidgin_account_editor_get_account(PidginAccountEditor *editor);

* Sets the account that @editor is editing to @account. You can pass %NULL

* to remove the current account or edit a new account.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_account_editor_set_account(PidginAccountEditor *editor, PurpleAccount *account);

* Returns: %TRUE if the account being edited has valid values, otherwise

* %FALSE.

*

*/

PIDGIN_AVAILABLE_IN_3_0

gboolean pidgin_account_editor_get_is_valid(PidginAccountEditor *editor);

* Save the account to disk. If this is a new account, it will be set to match

* the current global status which is "online" in most cases.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_account_editor_save(PidginAccountEditor *editor);

* [class@Pidgin.AccountChooser] or a [iface@Gio.ListModel] that contains

* [class@Purple.Account].

*

*/

#define PIDGIN_TYPE_ACCOUNT_FILTER_CONNECTED pidgin_account_filter_connected_get_type()

*

* Returns: (transfer full): The new #PidginAccountFilterConnected instance.

*

*/

PIDGIN_AVAILABLE_IN_3_0

GtkFilter *pidgin_account_filter_connected_new(void);

* [class@Pidgin.AccountChooser] or a [iface@Gio.ListModel] that contains

* [class@Purple.Account].

*

*/

#define PIDGIN_TYPE_ACCOUNT_FILTER_PROTOCOL pidgin_account_filter_protocol_get_type()

*

* Returns: (transfer full): The new #PidginAccountFilterProtocol instance.

*

*/

PIDGIN_AVAILABLE_IN_3_0

GtkFilter *pidgin_account_filter_protocol_new(const gchar *protocol_id);

*

* Returns: The Protocol ID that @filter is filtering for.

*

*/

PIDGIN_AVAILABLE_IN_3_0

const gchar *pidgin_account_filter_protocol_get_protocol_id(PidginAccountFilterProtocol *filter);

*

* A singleton dialog for managing accounts.

*

*/

#define PIDGIN_TYPE_ACCOUNT_MANAGER (pidgin_account_manager_get_type())

*

* Returns: (transfer full): The dialog.

*

*/

PIDGIN_AVAILABLE_IN_3_0

GtkWidget *pidgin_account_manager_new(void);

* Switches @manager to the overview page. This is useful as @manager might

* already be visible but editing an account.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_account_manager_show_overview(PidginAccountManager *manager);

*

* Opens the account editor in @manager for the given account.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_account_manager_edit_account(PidginAccountManager *manager, PurpleAccount *account);

*

* The account that this row will be representing.

*

*/

properties[PROP_ACCOUNT] = g_param_spec_object(

"account", "account",

*

* A [class@Gtk.ListBoxRow] subclass to display a [class@Purple.Account].

*

*/

#define PIDGIN_TYPE_ACCOUNT_MANAGER_ROW (pidgin_account_manager_row_get_type())

*

* Returns: (transfer full): The new account row.

*

*/

PIDGIN_AVAILABLE_IN_3_0

GtkWidget *pidgin_account_manager_row_new(PurpleAccount *account);

*

* Returns: (transfer none): The account if set otherwise %NULL.

*

*/

PIDGIN_AVAILABLE_IN_3_0

PurpleAccount *pidgin_account_manager_row_get_account(PidginAccountManagerRow *row);

*

* Sets the [class@Purple.Account] for @row to display.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_account_manager_row_set_account(PidginAccountManagerRow *row, PurpleAccount *account);

*

* The [class@Purple.Account] that is selected.

*

*/

properties[PROP_ACCOUNT] = g_param_spec_object(

"account", "account",

*

* The filter to use on the list of accounts.

*

*/

properties[PROP_FILTER] = g_param_spec_object(

"filter", "filter",

* A [class@Adw.ComboRow] subclass that allows the user to select an

* [class@Purple.Account].

*

*/

#define PIDGIN_TYPE_ACCOUNT_ROW (pidgin_account_row_get_type())

*

* Returns: (transfer full): The new instance.

*

*/

PIDGIN_AVAILABLE_IN_3_0

GtkWidget *pidgin_account_row_new(void);

* Returns: (transfer none): The account if one is selected otherwise %NULL if

* the model is empty.

*

*/

PIDGIN_AVAILABLE_IN_3_0

PurpleAccount *pidgin_account_row_get_account(PidginAccountRow *row);

* Sets the selected account in @row to @account. If @account is %NULL, then

* the first item if one exists will be selected.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_account_row_set_account(PidginAccountRow *row, PurpleAccount *account);

*

* Returns: (transfer none) (nullable): The filter being used or %NULL.

*

*/

PIDGIN_AVAILABLE_IN_3_0

GtkFilter *pidgin_account_row_get_filter(PidginAccountRow *row);

* Sets the filter for @row to @filter. If @filter is %NULL, any existing

* filter will be removed.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_account_row_set_filter(PidginAccountRow *row, GtkFilter *filter);

*

* Returns: (transfer full): The new menu instance.

*

*/

PIDGIN_AVAILABLE_IN_3_0

GMenuModel *pidgin_accounts_disabled_menu_new(void);

* A [class@Gio.MenuModel] that automatically updates itself based on what

* accounts are enabled.

*

*/

#define PIDGIN_TYPE_ACCOUNTS_ENABLED_MENU (pidgin_accounts_enabled_menu_get_type())

*

* Returns: (transfer full): The new menu instance.

*

*/

PIDGIN_AVAILABLE_IN_3_0

GMenuModel *pidgin_accounts_enabled_menu_new(void);

* The Pidgin account manager can get opened from multiple actions, so this

* helper manages the singleton.

*

*/

static GtkWidget *

pidgin_application_get_account_manager(void) {

* Presents a window and makes sure its transient parent is set to the currently

* active window of @application.

*

*/

static void

pidgin_application_present_transient_window(PidginApplication *application,

* #PidginApplication is a subclass of #GtkApplication that holds all of the

* application wide actions.

*

*/

#define PIDGIN_TYPE_APPLICATION (pidgin_application_get_type())

*

* Returns: (transfer full): The new #PidginApplication instance.

*

*/

PIDGIN_AVAILABLE_IN_3_0

GApplication *pidgin_application_new(void);

* To remove @action_group from every window, call this function with the same

* prefix, but %NULL for @action_group.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_application_add_action_group(PidginApplication *application, const gchar *prefix, GActionGroup *action_group);

* Returns: (transfer none) (nullable): The active window or %NULL if one could

* not be found.

*

*/

PIDGIN_AVAILABLE_IN_3_0

GtkWindow *pidgin_application_get_active_window(PidginApplication *application);

* max when new items are added if the widget was already scrolled all the

* way to the bottom.

*

*/

#define PIDGIN_TYPE_AUTO_ADJUSTMENT (pidgin_auto_adjustment_get_type())

*

* Returns: (transfer full): The new #PidginAutoAdjustment instance.

*

*/

PIDGIN_AVAILABLE_IN_3_0

GtkAdjustment *pidgin_auto_adjustment_new(void);

*

* Decrements the value of @auto_scroller by a page increment.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_auto_adjustment_decrement(PidginAutoAdjustment *auto_scroller);

*

* Increments the value of @auto_scroller by a page increment.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_auto_adjustment_increment(PidginAutoAdjustment *auto_scroller);

* #PidginAvatar is a widget that displays avatars for contacts or

* conversations.

*

*/

#define PIDGIN_TYPE_AVATAR (pidgin_avatar_get_type())

*

* Returns: (transfer full): The new #PidginAvatar instance.

*

*/

PIDGIN_AVAILABLE_IN_3_0

GtkWidget *pidgin_avatar_new(void);

* non-animated image, changing this will do nothing unless a new animated

* image is set.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_avatar_set_animate(PidginAvatar *avatar, gboolean animate);

*

* Returns: Whether or not @avatar should be animated.

*

*/

PIDGIN_AVAILABLE_IN_3_0

gboolean pidgin_avatar_get_animate(PidginAvatar *avatar);

*

* Sets or unsets the #PurpleBuddy that @avatar should use for display.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_avatar_set_buddy(PidginAvatar *avatar, PurpleBuddy *buddy);

*

* Returns: (transfer none): The #PurpleBuddy that @avatar is using for display.

*

*/

PIDGIN_AVAILABLE_IN_3_0

PurpleBuddy *pidgin_avatar_get_buddy(PidginAvatar *avatar);

* Sets or unsets the #PurpleConversation that @avatar uses to find the

* #PurpleBuddy whose icon to display.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_avatar_set_conversation(PidginAvatar *avatar, PurpleConversation *conversation);

* Returns: (transfer none): The #PurpleConversation that @avatar is using to

* find the #PurpleBuddy whose icon to display.

*

*/

PIDGIN_AVAILABLE_IN_3_0

PurpleConversation *pidgin_avatar_get_conversation(PidginAvatar *avatar);

*

* A dialog for joining channels.

*

*/

#define PIDGIN_TYPE_CHANNEL_JOIN_DIALOG (pidgin_channel_join_dialog_get_type())

*

* Returns: (transfer full): The widget.

*

*/

PIDGIN_AVAILABLE_IN_3_0

GtkWidget *pidgin_channel_join_dialog_new(void);

* in glib is going to take a bit of finesse. Also we'll need to figure out how

* to scale to ginormous Twitch channels which will constantly bust the cache.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_color_calculate_for_text(const gchar *text, GdkRGBA *color);

* Creates a [class@Gtk.PopoverMenu] for @info and displays it at the @x and @y

* coordinates instead of @parent.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_contact_info_menu_popup(PurpleContactInfo *info, PurpleAccount *account, GtkWidget *parent, gdouble x, gdouble y);

* #PidginContactList is a widget that displays the [iface@Gio.ListModel] of

* [class@Purple.Person] from [class@Purple.ContactManager].

*

*/

#define PIDGIN_TYPE_CONTACT_LIST (pidgin_contact_list_get_type())

*

* Returns: (transfer full): The new #PidginContactList instance.

*

*/

PIDGIN_AVAILABLE_IN_3_0

GtkWidget *pidgin_contact_list_new(void);

*

* Returns: %TRUE if a tooltip was set, otherwise %FALSE.

*

*/

static gboolean

pidgin_conversation_set_tooltip_for_timestamp(GtkTooltip *tooltip,

*

* The [class@Purple.Conversation] that this conversation is displaying.

*

*/

properties[PROP_CONVERSATION] = g_param_spec_object(

"conversation", "conversation",

*

* A [class@Gtk.Widget] for displaying a [class@Purple.Conversation].

*

*/

#define PIDGIN_TYPE_CONVERSATION (pidgin_conversation_get_type())

*

* Returns: (transfer full): The new widget.

*

*/

PIDGIN_AVAILABLE_IN_3_0

GtkWidget *pidgin_conversation_new(PurpleConversation *conversation);

* Returns: (transfer none) (nullable): The [class@Pidgin.Conversation] displaying

* @conversation if one exists, otherwise %NULL.

*

*/

PIDGIN_AVAILABLE_IN_3_0

GtkWidget *pidgin_conversation_from_purple_conversation(PurpleConversation *conversation);

* Returns: (transfer none): The [class@Purple.Conversation] that @conversation

* is displaying.

*

*/

PIDGIN_AVAILABLE_IN_3_0

PurpleConversation *pidgin_conversation_get_conversation(PidginConversation *conversation);

* conversation and the user may remain in the conversation if the protocol

* supports it.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_conversation_close(PidginConversation *conversation);

*

* Start pidgin with the given command line arguments.

*

*/

PIDGIN_AVAILABLE_IN_3_0

int pidgin_start(int argc, char *argv[]);

* This must be called early if you want to capture logs at startup, and avoid

* printing them out.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_debug_init_handler(void);

*

* This will print to the console, if Pidgin is run from there.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_debug_set_print_enabled(gboolean enable);

*

* Perform necessary initializations.

*

*/

PIDGIN_AVAILABLE_IN_ALL

void pidgin_debug_init(void);

*

* Perform necessary uninitializations.

*

*/

PIDGIN_AVAILABLE_IN_ALL

void pidgin_debug_uninit(void);

*

* Returns: the handle to the debug system

*

*/

PIDGIN_AVAILABLE_IN_ALL

void *pidgin_debug_get_handle(void);

*

* Shows the debug window.

*

*/

PIDGIN_AVAILABLE_IN_ALL

void pidgin_debug_window_show(void);

*

* Hides the debug window.

*

*/

PIDGIN_AVAILABLE_IN_ALL

void pidgin_debug_window_hide(void);

*

* The [class@Gtk.Widget] that this item is for.

*

*/

properties[PROP_WIDGET] = g_param_spec_object(

"widget", "widget",

* A unique identifier for this item. This is used for things like

* remembering positions and selections.

*

*/

properties[PROP_ID] = g_param_spec_string(

"id", "id",

*

* The title that should be displayed for this item.

*

*/

properties[PROP_TITLE] = g_param_spec_string(

"title", "title",

*

* The icon name to use for this item.

*

*/

properties[PROP_ICON_NAME] = g_param_spec_string(

"icon-name", "icon-name",

*

* Determines whether the item should show that it needs attention or not.

*

*/

properties[PROP_NEEDS_ATTENTION] = g_param_spec_boolean(

"needs-attention", "needs-attention",

* The number that should be shown in the badge. Typically this is an

* unread count. If this is 0 it should not be displayed.

*

*/

properties[PROP_BADGE_NUMBER] = g_param_spec_uint(

"badge-number", "badge-number",

* A [iface@Gio.ListModel] of child items. The type of the model needs to

* be [class@Pidgin.DisplayItem].

*

*/

properties[PROP_CHILDREN] = g_param_spec_object(

"children", "children",

* A class that's used by [class@Pidgin.DisplayWindow] to represent all of the

* displays items.

*

*/

#define PIDGIN_TYPE_DISPLAY_ITEM (pidgin_display_item_get_type())

*

* Returns: (transfer none): The widget.

*

*/

PIDGIN_AVAILABLE_IN_3_0

GtkWidget *pidgin_display_item_get_widget(PidginDisplayItem *item);

*

* Returns: The unique identifier of @item.

*

*/

PIDGIN_AVAILABLE_IN_3_0

const char *pidgin_display_item_get_id(PidginDisplayItem *item);

*

* Returns: (nullable): The title of @item.

*

*/

PIDGIN_AVAILABLE_IN_3_0

const char *pidgin_display_item_get_title(PidginDisplayItem *item);

*

* Sets the title for @item to @title.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_display_item_set_title(PidginDisplayItem *item, const char *title);

*

* Returns: (nullable): The icon name to use.

*

*/

PIDGIN_AVAILABLE_IN_3_0

const char *pidgin_display_item_get_icon_name(PidginDisplayItem *item);

*

* Sets the icon name that should be used when displaying @item.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_display_item_set_icon_name(PidginDisplayItem *item, const char *icon_name);

*

* Returns: %TRUE if @item needs attention otherwise %FALSE.

*

*/

PIDGIN_AVAILABLE_IN_3_0

gboolean pidgin_display_item_get_needs_attention(PidginDisplayItem *item);

*

* Sets whether or not @item needs attention.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_display_item_set_needs_attention(PidginDisplayItem *item, gboolean needs_attention);

*

* Returns: The value to display or %0 to display nothing.

*

*/

PIDGIN_AVAILABLE_IN_3_0

guint pidgin_display_item_get_badge_number(PidginDisplayItem *item);

* Sets the values to be displayed in the badge for @item to @badge_number. A

* value of %0 indicates that the badge should not be displayed.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_display_item_set_badge_number(PidginDisplayItem *item, guint badge_number);

*

* Returns: (transfer none) (nullable): The children of @item if there are any.

*

*/

PIDGIN_AVAILABLE_IN_3_0

GListModel *pidgin_display_item_get_children(PidginDisplayItem *item);

* Sets the children of @item to @children. If @children is not %NULL then the

* model must have an item type of [class@Pidgin.DisplayItem].

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_display_item_set_children(PidginDisplayItem *item, GListModel *children);

*

* #PidginDisplayWindow is a widget that contains #PidginConversations.

*

*/

#define PIDGIN_TYPE_DISPLAY_WINDOW (pidgin_display_window_get_type())

*

* Returns: (transfer full): The new #PidginDisplayWindow instance.

*

*/

PIDGIN_AVAILABLE_IN_3_0

GtkWidget *pidgin_display_window_new(void);

*

* Returns: (transfer none): The default #PidginDisplayWindow.

*

*/

PIDGIN_AVAILABLE_IN_3_0

GtkWidget *pidgin_display_window_get_default(void);

* Adds @conversation to @window. If @conversation is already in @window, this

* does nothing.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_display_window_add(PidginDisplayWindow *window, PurpleConversation *conversation);

* Removes @conversation from @window. If @conversation is not in @window, this

* does nothing.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_display_window_remove(PidginDisplayWindow *window, PurpleConversation *conversation);

*

* Returns: The number of conversations that @window contains.

*

*/

PIDGIN_AVAILABLE_IN_3_0

guint pidgin_display_window_get_count(PidginDisplayWindow *window);

*

* Returns: (transfer full): The selected PurpleConversation or %NULL.

*

*/

PIDGIN_AVAILABLE_IN_3_0

PurpleConversation *pidgin_display_window_get_selected(PidginDisplayWindow *window);

*

* Selects @conversation, making it the active conversation.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_display_window_select(PidginDisplayWindow *window, PurpleConversation *conversation);

*

* If no conversation is selected, the last conversation will be selected.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_display_window_select_previous(PidginDisplayWindow *window);

*

* If no conversation is selected, the first conversation will be selected.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_display_window_select_next(PidginDisplayWindow *window);

* Selects the first conversation in @window. If there are no conversations in

* @window this does nothing.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_display_window_select_first(PidginDisplayWindow *window);

* Selects the last conversation in @window. If there are no conversations in

* @window this does nothing.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_display_window_select_last(PidginDisplayWindow *window);

* Switches to the @nth conversation. @nth is a 0 based index, so the first

* conversation is at index 0.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_display_window_select_nth(PidginDisplayWindow *window, guint nth);

*

* Returns: %TRUE if @conversation is active.

*

*/

PIDGIN_AVAILABLE_IN_3_0

gboolean pidgin_display_window_conversation_is_selected(PidginDisplayWindow *window, PurpleConversation *conversation);

*

* Returns: The icon name to use for @primitive.

*

*/

PIDGIN_AVAILABLE_IN_3_0

const gchar *pidgin_icon_name_from_status_primitive(PurpleStatusPrimitive primitive, const gchar *fallback);

*

* Returns: The icon name to use for @type.

*

*/

PIDGIN_AVAILABLE_IN_3_0

const gchar *pidgin_icon_name_from_status_type(PurpleStatusType *type, const gchar *fallback);

*

* Returns: The icon name to use for @status.

*

*/

PIDGIN_AVAILABLE_IN_3_0

const gchar *pidgin_icon_name_from_status(PurpleStatus *status, const gchar *fallback);

*

* Returns: (nullable): The icon name to use or @fallback.

*

*/

PIDGIN_AVAILABLE_IN_3_0

const char *pidgin_icon_name_from_presence_primitive(PurplePresencePrimitive primitive, const char *fallback);

*

* Returns: The icon name to represent @presence.

*

*/

PIDGIN_AVAILABLE_IN_3_0

const char *pidgin_icon_name_from_presence(PurplePresence *presence, const char *fallback);

*

* A window used to start a new direct message.

*

*/

#define PIDGIN_TYPE_IM_WINDOW (pidgin_im_window_get_type())

* }

* ]|

*

*/

#define PIDGIN_TYPE_INVITE_DIALOG pidgin_invite_dialog_get_type()

*

* Returns: (transfer full): The new #PidginInviteDialog instance.

*

*/

PIDGIN_AVAILABLE_IN_3_0

GtkWidget *pidgin_invite_dialog_new(PurpleChatConversation *conversation);

* used to prepopulate the dialog in cases where you just need to prompt the

* user for an invite message.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_invite_dialog_set_contact(PidginInviteDialog *dialog, const gchar *contact);

*

* Returns: (transfer none): The contact that was entered.

*

*/

PIDGIN_AVAILABLE_IN_3_0

const gchar *pidgin_invite_dialog_get_contact(PidginInviteDialog *dialog);

* Sets the message to be displayed in @dialog. The main use case is to

* prepopulate the message.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_invite_dialog_set_message(PidginInviteDialog *dialog, const gchar *message);

*

* Returns: (transfer none): The message that was entered in @dialog.

*

*/

PIDGIN_AVAILABLE_IN_3_0

const gchar *pidgin_invite_dialog_get_message(PidginInviteDialog *dialog);

* Returns: (transfer none): The #PurpleChatConversation that @dialog was

* created with.

*

*/

PIDGIN_AVAILABLE_IN_3_0

PurpleChatConversation *pidgin_invite_dialog_get_conversation(PidginInviteDialog *dialog);

* #PidginKeypad is a widget that displays a DTMF keypad, with the digits 0-9,

* an asterisk, and a number sign.

*

*/

G_BEGIN_DECLS

*

* Returns: (transfer full): The new instance.

*

*/

PIDGIN_AVAILABLE_IN_3_0

GtkWidget *pidgin_keypad_new(void);

* If key events are handled by the keypad, the DTMF digits will be captured

* and trigger the pressed signal on @keypad.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_keypad_set_key_capture_widget(PidginKeypad *keypad, GtkWidget *widget);

*

* The [type@Purple.Notification] that is being displayed.

*

*/

properties[PROP_NOTIFICATION] = g_param_spec_object(

"notification", "notification",

* notifications from [class@Purple.NotificationManager] for

* [class@Purple.AddContactRequest].

*

*/

#define PIDGIN_TYPE_NOTIFICATION_ADD_CONTACT (pidgin_notification_add_contact_get_type())

* Returns: (transfer full): The new #PidginNotificationAddContact

* instance.

*

*/

PIDGIN_AVAILABLE_IN_3_0

GtkWidget *pidgin_notification_add_contact_new(PurpleNotification *notification);

*

* Returns: (transfer none): The notification.

*

*/

PIDGIN_AVAILABLE_IN_3_0

PurpleNotification *pidgin_notification_add_contact_get_notification(PidginNotificationAddContact *request);

*

* The [type@Purple.AuthorizationRequestInfo] that this notification is for.

*

*/

properties[PROP_NOTIFICATION] = g_param_spec_object(

"notification", "notification",

* notifications from [class@Purple.NotificationManager] for authorization

* requests.

*

*/

#define PIDGIN_TYPE_NOTIFICATION_AUTHORIZATION_REQUEST (pidgin_notification_authorization_request_get_type())

* Returns: (transfer full): The new #PidginNotificationAuthorizationRequest

* instance.

*

*/

PIDGIN_AVAILABLE_IN_3_0

GtkWidget *pidgin_notification_authorization_request_new(PurpleNotification *notification);

*

* Returns: (transfer none): The notification.

*

*/

PIDGIN_AVAILABLE_IN_3_0

PurpleNotification *pidgin_notification_authorization_request_get_notification(PidginNotificationAuthorizationRequest *request);

*

* The [type@Purple.ConnectionErrorInfo] that this notification is for.

*

*/

properties[PROP_NOTIFICATION] = g_param_spec_object(

"notification", "notification",

* #PidginNotificationConnectionError is a widget that displays notifications from

* [class@Purple.NotificationManager].

*

*/

#define PIDGIN_TYPE_NOTIFICATION_CONNECTION_ERROR (pidgin_notification_connection_error_get_type())

* Returns: (transfer full): The new #PidginNotificationConnectionError

* instance.

*

*/

PIDGIN_AVAILABLE_IN_3_0

GtkWidget *pidgin_notification_connection_error_new(PurpleNotification *notification);

*

* Returns: (transfer none): The notification.

*

*/

PIDGIN_AVAILABLE_IN_3_0

PurpleNotification *pidgin_notification_connection_error_get_notification(PidginNotificationConnectionError *error);

* #PidginNotificationList is a widget that displays notifications from

* [class@Purple.NotificationManager].

*

*/

#define PIDGIN_TYPE_NOTIFICATION_LIST (pidgin_notification_list_get_type())

*

* Returns: (transfer full): The new #PidginNotificationList instance.

*

*/

PIDGIN_AVAILABLE_IN_3_0

GtkWidget *pidgin_notification_list_new(void);

*

* A dialog that allows the user to configure their plugins.

*

*/

#define PIDGIN_TYPE_PLUGINS_DIALOG (pidgin_plugins_dialog_get_type())

*

* Returns: (transfer full): The new #PidginPluginsDialog.

*

*/

PIDGIN_AVAILABLE_IN_3_0

GtkWidget *pidgin_plugins_dialog_new(void);

* #PidginPluginsMenu is a [class@Gio.MenuModel] that automatically updates

* itself when plugins are loaded and unloaded.

*

*/

#define PIDGIN_TYPE_PLUGINS_MENU (pidgin_plugins_menu_get_type())

*

* Returns: (transfer full): The new #PidginPluginsMenu instance.

*

*/

PIDGIN_AVAILABLE_IN_3_0

GMenuModel *pidgin_plugins_menu_new(void);

* A #GtkImage subclass that will automatically update when the given presence

* changes.

*

*/

#define PIDGIN_TYPE_PRESENCE_ICON (pidgin_presence_icon_get_type())

*

* Returns: (transfer full): The new presence icon.

*

*/

PIDGIN_AVAILABLE_IN_3_0

GtkWidget *pidgin_presence_icon_new(PurplePresence *presence, const gchar *fallback, GtkIconSize icon_size);

*

* Returns: (transfer none): The #PurplePresence if set otherwise %NULL.

*

*/

PIDGIN_AVAILABLE_IN_3_0

PurplePresence *pidgin_presence_icon_get_presence(PidginPresenceIcon *icon);

*

* Sets the #PurplePresence for @icon to display.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_presence_icon_set_presence(PidginPresenceIcon *icon, PurplePresence *presence);

*

* Returns: The fallback icon name for @icon.

*

*/

PIDGIN_AVAILABLE_IN_3_0

const gchar *pidgin_presence_icon_get_fallback(PidginPresenceIcon *icon);

*

* Sets the fallback icon name for @icon to @fallback.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_presence_icon_set_fallback(PidginPresenceIcon *icon, const gchar *fallback);

*

* Returns: The #GtkIconSize that @icon is using to render.

*

*/

PIDGIN_AVAILABLE_IN_3_0

GtkIconSize pidgin_presence_icon_get_icon_size(PidginPresenceIcon *icon);

*

* Sets the #GtkIconSize that @icon will use to render the icon.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_presence_icon_set_icon_size(PidginPresenceIcon *icon, GtkIconSize icon_size);

*

* This should only be called internally from Pidgin.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_commands_init(void);

*

* This should only be called internally from Pidgin.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_commands_uninit(void);

*

* The protocol which is currently selected.

*

**/

properties[PROP_PROTOCOL] = g_param_spec_object(

"protocol",

*

* Returns: (transfer full): The protocol chooser drop down.

*

*/

PIDGIN_AVAILABLE_IN_3_0

GtkWidget *pidgin_protocol_chooser_new(void);

* Returns: (transfer none): The selected [class@Purple.Protocol] or %NULL if

* nothing is selected.

*

*/

PIDGIN_AVAILABLE_IN_3_0

PurpleProtocol *pidgin_protocol_chooser_get_protocol(PidginProtocolChooser *chooser);

* Sets the currently selected protocol of @chooser to the given

* [class@Purple.Protocol].

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_protocol_chooser_set_protocol(PidginProtocolChooser *chooser, PurpleProtocol *protocol);

*

* Returns: (transfer full) (nullable): The HTML string, which could be empty.

*

*/

PIDGIN_AVAILABLE_IN_3_0

char *pidgin_text_buffer_get_html(GtkTextBuffer *buffer);

*

* Returns: (transfer full) (nullable): The HTML string, which could be empty.

*

*/

PIDGIN_AVAILABLE_IN_3_0

char *pidgin_text_buffer_get_html_range(GtkTextBuffer *buffer, GtkTextIter *start, GtkTextIter *end);

*

* Is a subclass of [class@Purple.Ui] that identifies Pidgin to libpurple.

*

*/

#define PIDGIN_TYPE_UI (pidgin_ui_get_type())

*

* Returns: (transfer full): The new instance.

*

*/

PIDGIN_AVAILABLE_IN_3_0

PurpleUi *pidgin_ui_new(void);

* A macro that evaluates to the current stable version of Pidgin, in a format

* that can be used by the C pre-processor.

*

*/

#define PIDGIN_VERSION_CUR_STABLE \

(G_ENCODE_VERSION(PIDGIN_MAJOR_VERSION, PIDGIN_MINOR_VERSION))

* A macro that evaluates to the 2.0 version of Pidgin, in a format that can be

* used by the C pre-processor.

*

*/

#define PIDGIN_VERSION_2_0 (G_ENCODE_VERSION(2, 0))

* A macro that evaluates to the 2.1 version of Pidgin, in a format that can be

* used by the C pre-processor.

*

*/

#define PIDGIN_VERSION_2_1 (G_ENCODE_VERSION(2, 1))

* A macro that evaluates to the 2.2 version of Pidgin, in a format that can be

* used by the C pre-processor.

*

*/

#define PIDGIN_VERSION_2_2 (G_ENCODE_VERSION(2, 2))

* A macro that evaluates to the 2.3 version of Pidgin, in a format that can be

* used by the C pre-processor.

*

*/

#define PIDGIN_VERSION_2_3 (G_ENCODE_VERSION(2, 3))

* A macro that evaluates to the 2.4 version of Pidgin, in a format that can be

* used by the C pre-processor.

*

*/

#define PIDGIN_VERSION_2_4 (G_ENCODE_VERSION(2, 4))

* A macro that evaluates to the 2.5 version of Pidgin, in a format that can be

* used by the C pre-processor.

*

*/

#define PIDGIN_VERSION_2_5 (G_ENCODE_VERSION(2, 5))

* A macro that evaluates to the 2.6 version of Pidgin, in a format that can be

* used by the C pre-processor.

*

*/

#define PIDGIN_VERSION_2_6 (G_ENCODE_VERSION(2, 6))

* A macro that evaluates to the 2.7 version of Pidgin, in a format that can be

* used by the C pre-processor.

*

*/

#define PIDGIN_VERSION_2_7 (G_ENCODE_VERSION(2, 7))

* A macro that evaluates to the 2.8 version of Pidgin, in a format that can be

* used by the C pre-processor.

*

*/

#define PIDGIN_VERSION_2_8 (G_ENCODE_VERSION(2, 8))

* A macro that evaluates to the 2.9 version of Pidgin, in a format that can be

* used by the C pre-processor.

*

*/

#define PIDGIN_VERSION_2_9 (G_ENCODE_VERSION(2, 9))

* A macro that evaluates to the 2.10 version of Pidgin, in a format that can

* be used by the C pre-processor.

*

*/

#define PIDGIN_VERSION_2_10 (G_ENCODE_VERSION(2, 10))

* A macro that evaluates to the 2.11 version of Pidgin, in a format that can

* be used by the C pre-processor.

*

*/

#define PIDGIN_VERSION_2_11 (G_ENCODE_VERSION(2, 11))

* A macro that evaluates to the 2.12 version of Pidgin, in a format that can

* be used by the C pre-processor.

*

*/

#define PIDGIN_VERSION_2_12 (G_ENCODE_VERSION(2, 12))

* A macro that evaluates to the 2.13 version of Pidgin, in a format that can

* be used by the C pre-processor.

*

*/

#define PIDGIN_VERSION_2_13 (G_ENCODE_VERSION(2, 13))

* A macro that evaluates to the 2.14 version of Pidgin, in a format that can

* be used by the C pre-processor.

*

*/

#define PIDGIN_VERSION_2_14 (G_ENCODE_VERSION(2, 14))

* A macro that evaluates to the 3.0 version of Pidgin, in a format that can be

* used by the C pre-processor.

*

*/

#define PIDGIN_VERSION_3_0 (G_ENCODE_VERSION(3, 0))

* #PidginAwayPrefs is a widget for the preferences window to let users

* choose and configure their away and idle settings.

*

*/

#define PIDGIN_TYPE_AWAY_PREFS (pidgin_away_prefs_get_type())

*

* Returns: (transfer full): The new #PidginAwayPrefs instance.

*

*/

PIDGIN_AVAILABLE_IN_3_0

GtkWidget *pidgin_away_prefs_new(void);

* #PidginConversationPrefs is a widget for the preferences window to let users

* choose and configure their conversation settings.

*

*/

#define PIDGIN_TYPE_CONVERSATION_PREFS (pidgin_conversation_prefs_get_type())

*

* Returns: (transfer full): The new #PidginConversationPrefs instance.

*

*/

PIDGIN_AVAILABLE_IN_3_0

GtkWidget *pidgin_conversation_prefs_new(void);

*

* The standard _get_type macro for #PidginCredentialPrefs.

*

*/

#define PIDGIN_TYPE_CREDENTIAL_PREFS (pidgin_credential_prefs_get_type())

* #PidginCredentialPrefs is a widget for the preferences window to let users

* choose and configure their credential provider.

*

*/

/**

*

* Returns: (transfer full): The new #PidginCredentialPrefs instance.

*

*/

PIDGIN_AVAILABLE_IN_3_0

GtkWidget *pidgin_credential_prefs_new(void);

*

* The standard _get_type macro for #PidginCredentialProviderRow.

*

*/

#define PIDGIN_TYPE_CREDENTIAL_PROVIDER_ROW (pidgin_credential_provider_row_get_type())

* #PidginCredentialProviderRow is a widget for the preferences window to let

* users configure their credential provider.

*

*/

/**

*

* Returns: (transfer full): The new #PidginCredentialProviderRow instance.

*

*/

PIDGIN_AVAILABLE_IN_3_0

GtkWidget *pidgin_credential_provider_row_new(PurpleCredentialProvider *provider);

*

* Returns: (transfer none): The displayed #PurpleCredentialProvider.

*

*/

PIDGIN_AVAILABLE_IN_3_0

PurpleCredentialProvider *pidgin_credential_provider_row_get_provider(PidginCredentialProviderRow *row);

*

* Returns: Whether the row is active.

*

*/

PIDGIN_AVAILABLE_IN_3_0

gboolean pidgin_credential_provider_row_get_active(PidginCredentialProviderRow *row);

*

* Sets whether the row is displayed as active.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_credential_provider_row_set_active(PidginCredentialProviderRow *row, gboolean active);

* #PidginNetworkPrefs is a widget for the preferences window to let users

* choose and configure their network settings.

*

*/

#define PIDGIN_TYPE_NETWORK_PREFS (pidgin_network_prefs_get_type())

*

* Returns: (transfer full): The new #PidginNetworkPrefs instance.

*

*/

PIDGIN_AVAILABLE_IN_3_0

GtkWidget *pidgin_network_prefs_new(void);

*

* Initializes all UI-specific preferences.

*

*/

PIDGIN_AVAILABLE_IN_ALL

void pidgin_prefs_init(void);

*

* Rename legacy prefs and delete some that no longer exist.

*

*/

PIDGIN_AVAILABLE_IN_ALL

void pidgin_prefs_update_old(void);

* #PidginProxyPrefs is a widget for the preferences window to let users

* choose and configure their proxy settings.

*

*/

#define PIDGIN_TYPE_PROXY_PREFS (pidgin_proxy_prefs_get_type())

*

* Returns: (transfer full): The new #PidginProxyPrefs instance.

*

*/

PIDGIN_AVAILABLE_IN_3_0

GtkWidget *pidgin_proxy_prefs_new(void);

* #PidginVVPrefs is a widget for the preferences window to let users

* choose and configure their voice and video settings.

*

*/

#define PIDGIN_TYPE_VV_PREFS (pidgin_vv_prefs_get_type())

*

* Returns: (transfer full): The new #PidginVVPrefs instance.

*

*/

PIDGIN_AVAILABLE_IN_3_0

GtkWidget *pidgin_vv_prefs_new(void);

* Disable any test pipelines that may be playing on this widget. This may be

* used when switching focus or views to a different widget.

*

*/

PIDGIN_AVAILABLE_IN_3_0

void pidgin_vv_prefs_disable_test_pipelines(PidginVVPrefs *prefs);