/**

* Get the ui-functions.

*

*/

PurpleAccountUiOps *finch_accounts_get_ui_ops(void);

/**

* Show the edit dialog for an account.

*

*/

void finch_account_dialog_show(PurpleAccount *account);

/**

* Get the ui-functions.

*

*/

PurpleBlistUiOps * finch_blist_get_ui_ops(void);

* Get the position of the buddy list.

*

* @param x The x-coordinate is set here if not @ NULL.

*

*/

gboolean finch_blist_get_position(int *x, int *y);

/**

* Get the size of the buddy list.

*

*

*/

gboolean finch_blist_get_size(int *width, int *height);

/**

* Set the size of the buddy list.

*

*/

void finch_blist_set_size(int width, int height);

/**

* Get information about a user. Show immediate feedback.

*

*

*/

gpointer finch_retrieve_user_info(PurpleConnection *conn, const char *name);

/**

* Get the tree list of the buddy list.

*/

GntTree * finch_blist_get_tree(void);

/**

* Add an alternate buddy list manager.

*

*/

void finch_blist_install_manager(const FinchBlistManager *manager);

/**

* Remove an alternate buddy list manager.

*

*/

void finch_blist_uninstall_manager(const FinchBlistManager *manager);

/**

* Find a buddy list manager.

*

*

*/

FinchBlistManager * finch_blist_manager_find(const char *id);

/**

* Request the active buddy list manager to add a node.

*

*/

void finch_blist_manager_add_node(PurpleBlistNode *node);

/**

* Get the ui-functions.

*

*/

PurpleConnectionUiOps *finch_connections_get_ui_ops(void);

/**

* Get the ui-functions.

*

*/

PurpleConversationUiOps *finch_conv_get_ui_ops(void);

/**

* Set a conversation as active in a contactized conversation

*

*/

void finch_conversation_set_active(PurpleConversation *conv);

/**

* Sets the information widget for the conversation window.

*

* the current information widget is removed.

*/

void finch_conversation_set_info_widget(PurpleConversation *conv, GntWidget *widget);

/**

* Get the ui-functions.

*

*/

PurpleDebugUiOps *finch_debug_get_ui_ops(void);

/**

* Returns the GNT idle UI ops.

*

*/

PurpleIdleUiOps *finch_idle_get_ui_ops(void);

/**

* Returns the GNT log subsystem handle.

*

*/

void *finch_log_get_handle(void);

/**

* Add a PurpleMenuAction to a GntMenu.

*

* the PurpleMenuAction's PurpleCallback function.

*/

void gnt_append_menu_action(GntMenu *menu, PurpleMenuAction *action, gpointer ctx);

/**

* Get the ui-functions.

*

*/

PurpleNotifyUiOps *finch_notify_get_ui_ops(void);

* which should be a callback that returns a GntWidget for the plugin's

* preferences (see FinchPluginPrefFrameCb).

*

*

*

* @see purple_plugin_info_new()

*/

/**

* Displays a New Buddy Pounce or Edit Buddy Pounce dialog.

*

*/

void finch_pounce_editor_show(PurpleAccount *account, const char *name,

PurplePounce *cur_pounce);

/**

* Returns the gtkpounces handle

*

*/

void *finch_pounces_get_handle(void);

/**

* Get the ui-functions.

*

*/

PurpleRequestUiOps *finch_request_get_ui_ops(void);

/**

* Create a widget field for a request-field.

*

*

*/

GntWidget *finch_request_field_get_widget(PurpleRequestField *field);

/*@}*/

/**

* Get the ui-functions.

*

*/

PurpleRoomlistUiOps *finch_roomlist_get_ui_ops(void);

/**

* Get the name of the active sound profile.

*

*/

const char *finch_sound_get_active_profile(void);

/**

* Set the active profile. If the profile doesn't exist, nothing is changed.

*

*/

void finch_sound_set_active_profile(const char *name);

/**

* Get a list of available sound profiles.

*

* Caller must free the list (but not the data).

*/

GList *finch_sound_get_profiles(void);

/**

* Determine whether any sound will be played or not.

*

* set to zero.

*/

gboolean finch_sound_is_enabled(void);

/**

* Gets GNT sound UI ops.

*

*/

PurpleSoundUiOps *finch_sound_get_ui_ops(void);

/**

* Show a dialog to edit a status.

*

*/

void finch_savedstatus_edit(PurpleSavedStatus *saved);

/**

* Creates a new file transfer dialog.

*

*/

void finch_xfer_dialog_new(void);

/**

* Displays the file transfer dialog given.

*/

void finch_xfer_dialog_show(void);

/**

* Adds a file transfer to the dialog.

*

*/

void finch_xfer_dialog_add_xfer(PurpleXfer *xfer);

/**

* Removes a file transfer from the dialog.

*

*/

void finch_xfer_dialog_remove_xfer(PurpleXfer *xfer);

/**

* Indicate in a file transfer dialog that a transfer was cancelled.

*

*/

void finch_xfer_dialog_cancel_xfer(PurpleXfer *xfer);

/**

* Updates the information for a transfer in the dialog.

*

*/

void finch_xfer_dialog_update_xfer(PurpleXfer *xfer);

/**

* Returns the UI operations structure for the GNT file transfer UI.

*

*/

PurpleXferUiOps *finch_xfers_get_ui_ops(void);

/**

*

*

*/

GType gnt_skel_get_gtype(void);

/**

*

*

*/

GntWidget * gnt_skel_new();

/**

* Check whether the terminal is capable of UTF8 display.

*

*/

gboolean gnt_ascii_only(void);

* Present a window. If the event was triggered because of user interaction,

* the window is moved to the foreground. Otherwise, the Urgent hint is set.

*

*

* @since 2.0.0 (gnt), 2.1.0 (pidgin)

*/

/**

* Resize a widget.

*

*/

void gnt_screen_resize_widget(GntWidget *widget, int width, int height);

/**

* Move a widget.

*

* @param x The desired x-coordinate.

* @param y The desired y-coordinate.

*/

/**

* Rename a widget.

*

*/

void gnt_screen_rename_widget(GntWidget *widget, const char *text);

/**

* Check whether a widget has focus.

*

*

*/

gboolean gnt_widget_has_focus(GntWidget *widget);

/**

* Set the URGENT hint for a widget.

*

*/

void gnt_widget_set_urgent(GntWidget *widget);

/**

* Register a global action.

*

*/

void gnt_register_action(const char *label, void (*callback)(void));

/**

* Show a menu.

*

*

*/

gboolean gnt_screen_menu_show(gpointer menu);

/**

* Get the global clipboard.

*

*/

GntClipboard * gnt_get_clipboard(void);

/**

* Get the string in the clipboard.

*

*/

gchar * gnt_get_clipboard_string(void);

/**

* Set the contents of the global clipboard.

*

*/

void gnt_set_clipboard_string(const gchar *string);

/**

* Spawn a different application that will consume the console.

*

*

*/

gboolean gnt_giveup_console(const char *wd, char **argv, char **envp,

gint *stin, gint *stout, gint *sterr,

/**

* Check whether a child process is in control of the current terminal.

*

*/

gboolean gnt_is_refugee(void);

/**

*

*

*/

GType gnt_bindable_get_gtype(void);

/**

* Free a bindable action.

*

*/

void gnt_bindable_action_free(GntBindableAction *action);

/**

* Free a GntBindableActionParam.

*

*/

void gnt_bindable_action_param_free(GntBindableActionParam *param);

/**

* Register a bindable action for a class.

*

* list of default parameters.

*/

void gnt_bindable_class_register_action(GntBindableClass *klass, const char *name, GntBindableActionCallback callback, const char *trigger, ...);

/**

* Register a key-binding to an existing action.

*

*/

void gnt_bindable_register_binding(GntBindableClass *klass, const char *name, const char *trigger, ...);

/**

* Perform an action from a keybinding.

*

*

*/

gboolean gnt_bindable_perform_action_key(GntBindable *bindable, const char *keys);

/**

* Discover if a key is bound.

*

*

*/

gboolean gnt_bindable_check_key(GntBindable *bindable, const char *keys);

/**

* Perform an action on a bindable object.

*

*

*/

gboolean gnt_bindable_perform_action_named(GntBindable *bindable, const char *name, ...) G_GNUC_NULL_TERMINATED;

/**

* Returns a GntTree populated with "key" -> "binding" for the widget.

*

*

*/

GntBindable * gnt_bindable_bindings_view(GntBindable *bind);

* Builds a window that list the key bindings for a GntBindable object.

* From this window a user can select a listing to rebind a new key for the given action.

*

*

*/

gboolean gnt_bindable_build_help_window(GntBindable *bindable);

/**

* The GType for GntBox.

*/

GType gnt_box_get_gtype(void);

/**

* Create a new GntBox.

*

*

*/

GntWidget * gnt_box_new(gboolean homo, gboolean vert);

/**

* Add a widget in the box.

*

*/

void gnt_box_add_widget(GntBox *box, GntWidget *widget);

/**

* Set a title for the box.

*

*/

void gnt_box_set_title(GntBox *box, const char *title);

/**

* Set the padding to use between the widgets in the box.

*

*/

void gnt_box_set_pad(GntBox *box, int pad);

* then it will show borders, the title (if set) and shadow (if enabled in

* @e .gntrc)

*

*/

void gnt_box_set_toplevel(GntBox *box, gboolean set);

/**

* Reposition and refresh the widgets in the box.

*

*/

void gnt_box_sync_children(GntBox *box);

/**

* Set the alignment for the widgets in the box.

*

*/

void gnt_box_set_alignment(GntBox *box, GntAlignment alignment);

/**

* Remove a widget from the box. Calling this does NOT destroy the removed widget.

*

*/

void gnt_box_remove(GntBox *box, GntWidget *widget);

/**

* Remove all widgets from the box. This DOES destroy all widgets in the box.

*

*/

void gnt_box_remove_all(GntBox *box);

* Readjust the size of each child widget, reposition the child widgets and

* recalculate the size of the box.

*

*/

void gnt_box_readjust(GntBox *box);

/**

* Set whether the widgets in the box should fill the empty spaces.

*

*/

void gnt_box_set_fill(GntBox *box, gboolean fill);

/**

* Move the focus from one widget to the other.

*

* -1, the focus is moved backwards.

*/

void gnt_box_move_focus(GntBox *box, int dir);

/**

* Give focus to a specific child widget.

*

*/

void gnt_box_give_focus_to_child(GntBox *box, GntWidget *widget);

G_BEGIN_DECLS

/**

*/

GType gnt_button_get_gtype(void);

/**

* Create a new button.

*

*

*/

GntWidget * gnt_button_new(const char *text);

G_BEGIN_DECLS

/**

*/

GType gnt_check_box_get_gtype(void);

/**

* Create a new checkbox.

*

*

*/

GntWidget * gnt_check_box_new(const char *text);

/**

* Set whether the checkbox should be checked or not.

*

*/

void gnt_check_box_set_checked(GntCheckBox *box, gboolean set);

/**

* Return the checked state of the checkbox.

*

*

*/

gboolean gnt_check_box_get_checked(GntCheckBox *box);

G_BEGIN_DECLS

/**

*/

GType gnt_clipboard_get_gtype(void);

/**

* Get the current text from the clipboard.

*

*

* returned value.

*/

gchar * gnt_clipboard_get_string(GntClipboard *clip);

/**

* Set the text in the clipboard.

*

*/

void gnt_clipboard_set_string(GntClipboard *clip, const gchar *string);

/**

* Parse color information from a file.

*

*/

void gnt_colors_parse(GKeyFile *kfile);

/**

* Parse color-pair information from a file.

*

*/

void gnt_color_pairs_parse(GKeyFile *kfile);

/**

* Parse a string color

*

*

*

* @since 2.4.0

*/

* If the terminal doesn't have color support, this returns A_STANDOUT

* when deemed appropriate.

*

*

*

* @since 2.3.0

*/

/**

* Adds a color definition

*

*

*

* @since 2.4.0

*/

G_BEGIN_DECLS

/**

*/

GType gnt_combo_box_get_gtype(void);

/**

* Create a new GntComboBox

*

*/

GntWidget * gnt_combo_box_new(void);

/**

* Add an entry

*

*/

void gnt_combo_box_add_data(GntComboBox *box, gpointer key, const char *text);

/**

* Remove an entry

*

*/

void gnt_combo_box_remove(GntComboBox *box, gpointer key);

/**

* Remove all entries

*

*/

void gnt_combo_box_remove_all(GntComboBox *box);

/**

* Get the data that is currently selected

*

*

*/

gpointer gnt_combo_box_get_selected_data(GntComboBox *box);

/**

* Set the current selection to a specific entry

*

*/

void gnt_combo_box_set_selected(GntComboBox *box, gpointer key);

G_BEGIN_DECLS

/**

*/

GType gnt_entry_get_gtype(void);

/**

* Create a new GntEntry.

*

*

*/

GntWidget * gnt_entry_new(const char *text);

/**

* Set the maximum length of the text in the entry box.

*

*/

void gnt_entry_set_max(GntEntry *entry, int max);

/**

* Set the text in an entry box.

*

*/

void gnt_entry_set_text(GntEntry *entry, const char *text);

/**

* Set flags an entry box.

*

*/

void gnt_entry_set_flag(GntEntry *entry, GntEntryFlag flag);

/**

* Get the text in an entry box.

*

*

*/

const char *gnt_entry_get_text(GntEntry *entry);

/**

* Clear the text in the entry box.

*

*/

void gnt_entry_clear(GntEntry *entry);

/**

* Set whether the text in the entry box should be masked for display.

*

*/

void gnt_entry_set_masked(GntEntry *entry, gboolean set);

* Add a text to the history list for the text. The history length for the

* entry box needs to be set first by gnt_entry_set_history_length.

*

*/

void gnt_entry_add_to_history(GntEntry *entry, const char *text);

/**

* Set the length of history for the entry box.

*

*/

void gnt_entry_set_history_length(GntEntry *entry, int num);

* Set whether the suggestions are for the entire entry box, or for each

* individual word in the entry box.

*

*/

void gnt_entry_set_word_suggest(GntEntry *entry, gboolean word);

* Set whether to always display the suggestions list, or only when the

* tab-completion key is pressed (the TAB key, by default).

*

*/

void gnt_entry_set_always_suggest(GntEntry *entry, gboolean always);

/**

* Add an item to the suggestion list.

*

*/

void gnt_entry_add_suggest(GntEntry *entry, const char *text);

/**

* Remove an entry from the suggestion list.

*

*/

void gnt_entry_remove_suggest(GntEntry *entry, const char *text);

G_BEGIN_DECLS

/**

*/

GType gnt_file_sel_get_gtype(void);

/**

* Create a new file selector.

*

*/

GntWidget * gnt_file_sel_new(void);

/**

* Set the current location of the file selector.

*

*

*/

gboolean gnt_file_sel_set_current_location(GntFileSel *sel, const char *path);

/**

* Set wheter to only allow selecting directories.

*

* can also be selected.

*/

void gnt_file_sel_set_dirs_only(GntFileSel *sel, gboolean dirs);

/**

* Check whether the file selector allows only selecting directories.

*

*

*/

gboolean gnt_file_sel_get_dirs_only(GntFileSel *sel);

/**

* Set whether a selected file must exist.

*

*/

void gnt_file_sel_set_must_exist(GntFileSel *sel, gboolean must);

/**

* Check whether the selector allows selecting non-existent files.

*

*

* file can be selected.

*/

gboolean gnt_file_sel_get_must_exist(GntFileSel *sel);

/**

* Get the selected file in the selector.

*

*

* string.

*/

char * gnt_file_sel_get_selected_file(GntFileSel *sel);

/**

* Get the list of selected files in the selector.

*

*

* contents of the list, and g_list_free the list.

*/

GList * gnt_file_sel_get_selected_multi_files(GntFileSel *sel);

/**

* Allow selecting multiple files.

*

*/

void gnt_file_sel_set_multi_select(GntFileSel *sel, gboolean set);

/**

* Set the suggested file to have selected at startup.

*

*/

void gnt_file_sel_set_suggested_filename(GntFileSel *sel, const char *suggest);

/**

* Set custom functions to read the names of files.

*

*/

void gnt_file_sel_set_read_fn(GntFileSel *sel, gboolean (*read_fn)(const char *path, GList **files, GError **error));

/**

* Create a new GntFile.

*

*

*/

GntFile* gnt_file_new(const char *name, unsigned long size);

/**

* Create a new GntFile for a directory.

*

*

*/

GntFile* gnt_file_new_dir(const char *name);

* Refine input text. This usually looks at what the terminal claims it is,

* and tries to change the text to work around some oft-broken terminfo entries.

*

*/

void gnt_keys_refine(char *text);

/**

* Translate a user-readable representation of an input to a machine-readable representation.

*

*

*/

const char *gnt_key_translate(const char *name);

/**

* Translate a machine-readable representation of an input to a user-readable representation.

*

*

*/

const char *gnt_key_lookup(const char *key);

/**

* Add a key combination to the internal key-tree.

*

*/

void gnt_keys_add_combination(const char *key);

/**

* Remove a key combination from the internal key-tree.

*

*/

void gnt_keys_del_combination(const char *key);

/**

* Find a combination from the given string.

*

*

* of key (can be 0).

*/

int gnt_keys_find_combination(const char *key);

G_BEGIN_DECLS

/**

*/

GType gnt_label_get_gtype(void);

/**

* Create a new GntLabel.

*

*

*/

GntWidget * gnt_label_new(const char *text);

/**

* Create a new label with specified text attributes.

*

*

*/

GntWidget * gnt_label_new_with_format(const char *text, GntTextFormatFlags flags);

/**

* Change the text of a label.

*

*/

void gnt_label_set_text(GntLabel *label, const char *text);

G_BEGIN_DECLS

/**

*/

GType gnt_line_get_gtype(void);

/**

* Create new line

*

*

*/

GntWidget * gnt_line_new(gboolean vertical);

G_BEGIN_DECLS

/**

*/

GType gnt_menu_get_gtype(void);

/**

* Create a new menu.

*

*

*/

GntWidget * gnt_menu_new(GntMenuType type);

/**

* Add an item to the menu.

*

*/

void gnt_menu_add_item(GntMenu *menu, GntMenuItem *item);

/**

* Return the GntMenuItem with the given ID.

*

*

*

* @since 2.3.0

*/

G_BEGIN_DECLS

/**

*/

GType gnt_menuitem_get_gtype(void);

/**

* Create a new menuitem.

*

*

*/

GntMenuItem * gnt_menuitem_new(const char *text);

/**

* Set a callback function for a menuitem.

*

*/

void gnt_menuitem_set_callback(GntMenuItem *item, GntMenuItemCallback callback, gpointer data);

/**

* Set a submenu for a menuitem. A menuitem with a submenu cannot have a callback.

*

*/

void gnt_menuitem_set_submenu(GntMenuItem *item, GntMenu *menu);

/**

* Get the submenu for a menuitem.

*

*

*

* @since 2.3.0

*/

/**

* Set a trigger key for the item.

*

*/

void gnt_menuitem_set_trigger(GntMenuItem *item, char trigger);

/**

* Get the trigger key for a menuitem.

*

*

*

* @see gnt_menuitem_set_trigger

*/

/**

* Set an ID for the menuitem.

*

*

* @since 2.3.0

*/

/**

* Get the ID of the menuitem.

*

*

*

* @since 2.3.0

*/

* Activating the menuitem will first trigger the 'activate' signal for the

* menuitem. Then the callback for the menuitem is triggered, if there is one.

*

*

*

* @since 2.3.0

*/

G_BEGIN_DECLS

/**

*/

GType gnt_menuitem_check_get_gtype(void);

/**

* Create a new menuitem.

*

*

*/

GntMenuItem * gnt_menuitem_check_new(const char *text);

/**

* Check whether the menuitem is checked or not.

*

*

*/

gboolean gnt_menuitem_check_get_checked(GntMenuItemCheck *item);

/**

* Set whether the menuitem is checked or not.

*

*/

void gnt_menuitem_check_set_checked(GntMenuItemCheck *item, gboolean set);

/**

* Get the GType for GntProgressBar

**/

GType

gnt_progress_bar_get_gtype (void);

/**

* Create a new GntProgressBar

**/

GntWidget *

gnt_progress_bar_new (void);

/**

* Set the progress for a progress bar

*

**/

void

gnt_progress_bar_set_fraction (GntProgressBar *pbar, gdouble fraction);

/**

* Set the orientation for a progress bar

*

**/

void

gnt_progress_bar_set_orientation (GntProgressBar *pbar, GntProgressBarOrientation orientation);

/**

* Controls whether the progress value is shown

*

**/

void

gnt_progress_bar_set_show_progress (GntProgressBar *pbar, gboolean show);

/**

* Get the progress that is displayed

*

**/

gdouble

gnt_progress_bar_get_fraction (GntProgressBar *pbar);

/**

* Get the orientation for the progress bar

*

**/

GntProgressBarOrientation

gnt_progress_bar_get_orientation (GntProgressBar *pbar);

/**

* Get a boolean describing if the progress value is shown

*

**/

gboolean

gnt_progress_bar_get_show_progress (GntProgressBar *pbar);

G_BEGIN_DECLS

/**

*

* @since 2.0.0 (gnt), 2.1.0 (pidgin)

*/

/**

* Create a new slider.

*

*

*

* @since 2.0.0 (gnt), 2.1.0 (pidgin)

*/

/**

* Set the range of the slider.

*

*

* @since 2.0.0 (gnt), 2.1.0 (pidgin)

*/

/**

* Sets the amount of change at each step.

*

*

* @since 2.0.0 (gnt), 2.1.0 (pidgin)

*/

/**

* Sets the amount of change a small step.

*

*

* @since 2.2.0

*/

/**

* Sets the amount of change a large step.

*

*

* @since 2.2.0

*/

/**

* Advance the slider forward or backward.

*

* forward, negative to change backward

*

*

* @since 2.0.0 (gnt), 2.1.0 (pidgin)

*/

/**

* Set the current value for the slider.

*

*

* @since 2.0.0 (gnt), 2.1.0 (pidgin)

*/

/**

* Get the current value for the slider.

*

*

*

* @since 2.0.0 (gnt), 2.1.0 (pidgin)

/**

* Update a label with the value of the slider whenever the value changes.

*

*

* @since 2.0.0 (gnt), 2.1.0 (pidgin)

*/

/**

* Read configuration from a file.

*

*/

void gnt_style_read_configure_file(const char *filename);

/**

* Get the user-setting for a style.

*/

const char *gnt_style_get(GntStyle style);

/**

* Get the value of a preference in ~/.gntrc.

*

* will be used first, if available. Otherwise, "general" will be used.

*

*

* @since 2.0.0 (gnt), 2.1.0 (pidgin)

*/

/**

* Get the value of a preference in ~/.gntrc.

*

* will be used first, if available. Otherwise, "general" will be used.

*

*

* @since 2.4.0

*/

/**

* Get the value of a color pair in ~/.gntrc.

*

* will be used first, if available. Otherwise, "general" will be used.

*

*

* @since 2.4.0

*/

/**

* Parse a boolean preference. For example, if 'value' is "false" (ignoring case)

*

*

* @since 2.0.0 (gnt), 2.1.0 (pidgin)

*/

/**

* Get the boolean value for a user-setting.

*

* any value)

*

*/

gboolean gnt_style_get_bool(GntStyle style, gboolean def);

/**

* Read menu-accels from ~/.gntrc

*

*

*/

gboolean gnt_style_read_menu_accels(const char *name, GHashTable *table);

G_BEGIN_DECLS

/**

*/

GType gnt_text_view_get_gtype(void);

/**

* Create a new textview.

*

*/

GntWidget * gnt_text_view_new(void);

/**

* Scroll the textview.

*/

void gnt_text_view_scroll(GntTextView *view, int scroll);

/**

* Append new text in a textview.

*

*/

void gnt_text_view_append_text_with_flags(GntTextView *view, const char *text, GntTextFormatFlags flags);

/**

* Append text in the textview, with some identifier (tag) for the added text.

*

*/

void gnt_text_view_append_text_with_tag(GntTextView *view, const char *text, GntTextFormatFlags flags, const char *tag);