/**

* purple_action_menu_new:

* @label: The text label to display for this action.

* the selected item.

* @data: Additional data to be passed to the callback.

* @children: (element-type PurpleActionMenu) (transfer full): Menu actions to

*

* Creates a new PurpleActionMenu.

*

*/

PurpleActionMenu *purple_action_menu_new(const gchar *label, GCallback callback, gpointer data, GList *children);

*

* Returns the callback of the PurpleActionMenu.

*

*/

GCallback purple_action_menu_get_callback(const PurpleActionMenu *act);

/**

* purple_action_menu_set_callback:

* @act: The menu action.

*

* Set the callback that will be used by the PurpleActionMenu.

*/

*

* Gets current conversation's E2EE state.

*

*/

PurpleE2eeState *

purple_conversation_get_e2ee_state(PurpleConversation *conv);

* This is used to connect to

* <link linkend="chapter-signals-core">core signals</link>.

*

*/

PurpleCore *purple_get_core(void);

*

* State objects are global (shared between multiple conversations).

*

*/

PurpleE2eeState *

purple_e2ee_state_new(PurpleE2eeProvider *provider);

*

* If the reference count reaches zero, the state will be freed.

*

*/

PurpleE2eeState *

purple_e2ee_state_unref(PurpleE2eeState *state);

*

* Gets the provider of specified E2EE state.

*

*/

PurpleE2eeProvider *

purple_e2ee_state_get_provider(PurpleE2eeState *state);

*

* Creates new E2EE provider.

*

*/

PurpleE2eeProvider *

purple_e2ee_provider_new(void);

*

* Gets main E2EE provider.

*

*/

PurpleE2eeProvider *

purple_e2ee_provider_get_main(void);

*

* Reads settings from current keyring.

*

* purple_request_fields_destroy).

*/

PurpleRequestFields *

*

* Gets the source from a session

*

*/

GstElement *purple_media_get_src(PurpleMedia *media, const gchar *sess_id);

*

* Gets the tee from a given session/stream.

*

*/

GstElement *purple_media_get_tee(PurpleMedia *media,

const gchar *session_id, const gchar *participant);

*

* Gets an optional parameter based on the values given.

*

*/

PurpleKeyValuePair *purple_media_codec_get_optional_parameter(

PurpleMediaCodec *codec, const gchar *name,

* poking) for IPv6-only listeners (if an IPv6 socket supports v4-mapped

* addresses, a mapping is done).

*

* the pending listener, or %NULL if unable to obtain a local

* socket to listen on.

*/

* poking) for IPv6-only listeners (if an IPv6 socket supports v4-mapped

* addresses, a mapping is done).

*

* the pending listener, or %NULL if unable to obtain a local

* socket to listen on.

*/

*

* Returns a newly created search results object.

*

*/

PurpleNotifySearchResults *purple_notify_searchresults_new(void);

* Returns a newly created search result column object. The column defaults

* to being visible.

*

*/

PurpleNotifySearchColumn *purple_notify_searchresults_column_new(const char *title);

* purple_notify_user_info_prepend_pair_plaintext() are convenience

* methods for creating entries and adding them to a PurpleNotifyUserInfo.

*

*/

PurpleNotifyUserInfoEntry *purple_notify_user_info_entry_new(const char *label, const char *value);

*

* Create a new plugin preference frame

*

*/

PurplePluginPrefFrame *purple_plugin_pref_frame_new(void);

*

* Create a new plugin preference

*

*/

PurplePluginPref *purple_plugin_pref_new(void);

*

* Create a new plugin preference with name

*

*/

PurplePluginPref *purple_plugin_pref_new_with_name(const char *name);

*

* Create a new plugin preference with label

*

*/

PurplePluginPref *purple_plugin_pref_new_with_label(const char *label);

*

* Create a new plugin preference with name and label

*

*/

PurplePluginPref *purple_plugin_pref_new_with_name_and_label(const char *name, const char *label);

*

* Get the choices for a choices plugin pref

*

*/

GList *purple_plugin_pref_get_choices(PurplePluginPref *pref);

* Returns a callback that gives extra information about a plugin. You must

* free the string returned by this callback.

*

*/

PurplePluginExtraCb

purple_plugin_info_get_extra_cb(PurplePluginInfo *info);

* Returns the callback that retrieves the preferences request handle for a

* plugin, set via the "pref-request-cb" property of the plugin info.

*

*/

PurplePluginPrefRequestCb

purple_plugin_info_get_pref_request_cb(PurplePluginInfo *info);

*

* Creates a new buddy pounce.

*

*/

PurplePounce *purple_pounce_new(const char *ui_type, PurpleAccount *pouncer,

const char *pouncee, PurplePounceEvent event,

*

* Finds a pounce with the specified event(s) and buddy.

*

*/

PurplePounce *purple_find_pounce(PurpleAccount *pouncer,

const char *pouncee, PurplePounceEvent events);

*

* Returns the whiteboard ops of a protocol.

*

*/

PurpleWhiteboardOps *purple_protocol_get_whiteboard_ops(const PurpleProtocol *protocol);

*

* Creates a newly allocated copy of @option.

*

*

* Since: 3.0.0

*/

*

* Creates new Datasheet.

*

*/

PurpleRequestDatasheet *

purple_request_datasheet_new(void);

*

* Creates new datasheet action.

*

*/

PurpleRequestDatasheetAction *

purple_request_datasheet_action_new(void);

/**

* purple_request_datasheet_action_set_cb:

* @act: The action.

* @user_data: The data to be passed to the callback function.

*

* Sets the callback for the action.

/**

* purple_request_datasheet_action_set_sens_cb:

* @act: The action.

* @user_data: The data to be passed to the callback function.

*

* Sets the sensitivity checker for the action.

*

* Returns the datasheet of a record.

*

*/

PurpleRequestDatasheet *

purple_request_datasheet_record_get_datasheet(

*

* Looks up for a record in datasheet.

*

*/

PurpleRequestDatasheetRecord *

purple_request_datasheet_record_find(PurpleRequestDatasheet *sheet,

*

* If the specified key already exists in datasheet, old record is returned.

*

*/

PurpleRequestDatasheetRecord *

purple_request_datasheet_record_add(PurpleRequestDatasheet *sheet,

* Creates new parameters set for the request, which may or may not be used by

* the UI to display the request.

*

*/

PurpleRequestCommonParameters *

purple_request_cpar_new(void);

*

* Creates new parameters set initially bound with the #PurpleConnection.

*

*/

PurpleRequestCommonParameters *

purple_request_cpar_from_connection(PurpleConnection *gc);

*

* Creates new parameters set initially bound with the #PurpleAccount.

*

*/

PurpleRequestCommonParameters *

purple_request_cpar_from_account(PurpleAccount *account);

*

* Creates new parameters set initially bound with the #PurpleConversation.

*

*/

PurpleRequestCommonParameters *

purple_request_cpar_from_conversation(PurpleConversation *conv);

*

* The object will be destroyed when this reaches 0.

*

*/

PurpleRequestCommonParameters *

purple_request_cpar_unref(PurpleRequestCommonParameters *cpar);

/**

* purple_request_cpar_set_help_cb:

* @cpar: The parameters set.

* @user_data: The data to be passed to the callback.

*

* Sets the callback for the Help button.

*

* Gets the callback for the Help button.

*

*/

PurpleRequestHelpCb

purple_request_cpar_get_help_cb(PurpleRequestCommonParameters *cpar,

*

* Gets extra actions for the PurpleRequestFields dialog.

*

* setter).

*/

GSList *

*

* Creates a list of fields to pass to purple_request_fields().

*

*/

PurpleRequestFields *purple_request_fields_new(void);

*

* Return the field with the specified ID.

*

*/

PurpleRequestField *purple_request_fields_get_field(

const PurpleRequestFields *fields, const char *id);

*

* Creates a fields group with an optional title.

*

*/

PurpleRequestFieldGroup *purple_request_field_group_new(const char *title);

*

* Creates a field of the specified type.

*

*/

PurpleRequestField *purple_request_field_new(const char *id, const char *text,

PurpleRequestFieldType type);

*

* Returns the group for the field.

*

*/

PurpleRequestFieldGroup *purple_request_field_get_group(const PurpleRequestField *field);

/**

* purple_request_field_set_validator:

* @field: The field.

* @user_data: The data to pass to the callback.

*

* Sets validator for a single field.

/**

* purple_request_field_set_sensitivity_cb:

* @field: The field.

*

* Sets the callback, used to determine if the field should be editable.

*/

*

* Creates a string request field.

*

*/

PurpleRequestField *purple_request_field_string_new(const char *id,

const char *text,

*

* Creates an integer field.

*

*/

PurpleRequestField *purple_request_field_int_new(const char *id,

const char *text, int default_value, int lower_bound, int upper_bound);

*

* This is often represented as a checkbox.

*

*/

PurpleRequestField *purple_request_field_bool_new(const char *id,

const char *text,

*

* This is often represented as a group of radio buttons.

*

*/

PurpleRequestField *

purple_request_field_choice_new(const char *id, const char *text,

*

* Returns a list of elements in a choice field.

*

*/

GList *

purple_request_field_choice_get_elements(const PurpleRequestField *field);

*

* Creates a multiple list item field.

*

*/

PurpleRequestField *purple_request_field_list_new(const char *id, const char *text);

*

* Creates a label field.

*

*/

PurpleRequestField *purple_request_field_label_new(const char *id,

const char *text);

*

* Creates an image field.

*

*/

PurpleRequestField *purple_request_field_image_new(const char *id, const char *text,

const char *buf, gsize size);

*

* By default, this field will not show offline accounts.

*

*/

PurpleRequestField *purple_request_field_account_new(const char *id,

const char *text,

/**

* purple_request_field_account_set_filter:

* @field: The account field.

*

* Sets the account filter function in an account field.

*

* This function will determine which accounts get displayed and which

* don't.

*

*/

PurpleFilterAccountFunc purple_request_field_account_get_filter(

const PurpleRequestField *field);

*

* Creates a datasheet item field.

*

*/

PurpleRequestField *purple_request_field_datasheet_new(const char *id,

const gchar *text, PurpleRequestDatasheet *sheet);

* Use "html", for example, to allow the user to enter HTML.

* @ok_text: The text for the <literal>OK</literal> button, which may not

* be %NULL.

* not be %NULL.

* @cancel_text: The text for the <literal>Cancel</literal> button, which may

* not be %NULL.

* may be %NULL.

* @cpar: The #PurpleRequestCommonParameters object, which gets

* unref'ed after this call.

* listed in the varargs.

* @ok_text: The text for the <literal>OK</literal> button, which may not

* be %NULL.

* not be %NULL.

* @cancel_text: The text for the <literal>Cancel</literal> button, which may

* not be %NULL.

* %NULL to do nothing.

* @cpar: The #PurpleRequestCommonParameters object, which gets

* unref'ed after this call.

* listed in the varargs.

* @ok_text: The text for the <literal>OK</literal> button, which may not

* be %NULL.

* not be %NULL.

* @cancel_text: The text for the <literal>Cancel</literal> button, which may

* not be %NULL.

* %NULL to do nothing.

* @cpar: The #PurpleRequestCommonParameters object, which gets

* unref'ed after this call.

* @secondary: Secondary information, or %NULL if there is none.

* @with_progress: %TRUE, if we want to display progress bar, %FALSE

* otherwise

* may be %NULL.

* @cpar: The #PurpleRequestCommonParameters object, which gets

* unref'ed after this call.

* @fields: The list of fields.

* @ok_text: The text for the <literal>OK</literal> button, which may not be

* %NULL.

* not be

* %NULL.

* @cancel_text: The text for the <literal>Cancel</literal> button, which may

* not be %NULL.

* may be %NULL.

* @cpar: The #PurpleRequestCommonParameters object, which gets

* unref'ed after this call.

* @filename: The default filename (may be %NULL)

* @savedialog: True if this dialog is being used to save a file. False if

* it is being used to open a file.

* may be %NULL.

* @cpar: The #PurpleRequestCommonParameters object, which gets unref'ed

* after this call.

* purple_request_input().

* @title: The title of the message, or %NULL if it should have no title.

* @dirname: The default directory name (may be %NULL)

* may be %NULL.

* @cpar: The #PurpleRequestCommonParameters object, which gets unref'ed

* after this call.

*

* Get the substatus for an account in a saved status.

*

* the given account does not have a substatus that

* differs from the default status of this PurpleSavedStatus.

*/

* purple_signal_register:

* @instance: The instance to register the signal for.

* @signal: The signal name.

* @ret_type: The return type, or G_TYPE_NONE for no return type.

* @num_values: The number of values to be passed to the callbacks.

* @...: The types of the parameters for the callbacks.

* @instance: The instance to connect to.

* @signal: The name of the signal to connect.

* @handle: The handle of the receiver.

* @data: The data to pass to the callback function.

* @priority: The priority with which the handler should be called. Signal

* handlers are called in ascending numerical order of

* @instance: The instance to connect to.

* @signal: The name of the signal to connect.

* @handle: The handle of the receiver.

* @data: The data to pass to the callback function.

*

* Connects a signal handler to a signal for a particular object.

* @instance: The instance to connect to.

* @signal: The name of the signal to connect.

* @handle: The handle of the receiver.

* @data: The data to pass to the callback function.

* @priority: The priority with which the handler should be called. Signal

* handlers are called in ascending numerical order of

* @instance: The instance to connect to.

* @signal: The name of the signal to connect.

* @handle: The handle of the receiver.

* @data: The data to pass to the callback function.

*

* Connects a signal handler to a signal for a particular object.

* @instance: The instance to disconnect from.

* @signal: The name of the signal to disconnect.

* @handle: The handle of the receiver.

*

* Disconnects a signal handler from a signal on an object.

*

* purple_status_set_active_with_attrs_list:

* @status: The status.

* @active: The active state.

* composed of key/value pairs, where each key is a valid

* attribute name for this PurpleStatusType. The list is

* not modified or freed by this function.

* Creates an immutable reference-counted string object. The newly

* created object will have a reference count of 1.

*

* of 1.

*/

PurpleStringref *purple_stringref_new(const char *value);

* not referenced before the next iteration of the mainloop it will

* be freed at that time.

*

* of zero.

*/

PurpleStringref *purple_stringref_new_noref(const char *value);

*

* Increase the reference count of the given stringref.

*

*/

PurpleStringref *purple_stringref_ref(PurpleStringref *stringref);

* is already done. Otherwise the callback is called when the discovery is over

* and NULL is returned.

*

* of NAT or NULL if discovery would block

*/

PurpleStunNatDiscovery *purple_stun_discover(PurpleStunCallback cb);

* this purple client. Essentially, this function takes care of the port

* forwarding so things like file transfers can work behind NAT firewalls

*

* cancel

*/

PurpleUPnPMappingAddRemove *purple_upnp_set_port_mapping(unsigned short portmap, const gchar* protocol,

* port forwarding after they have completed a connection so another client on

* the local network can take advantage of the port forwarding

*

* cancel

*/

PurpleUPnPMappingAddRemove *purple_upnp_remove_port_mapping(unsigned short portmap,

* @title: The text to be displayed as the dropdown label

* @type: The type of preference to be stored in the dropdown

* @key: The key of the pref that will be represented by the dropdown

* be paired as label/value

*

* Add a new dropdown representing a preference of the specified type

*

* Returns pirgin's main file transfer dialog.

*

*/

PidginXferDialog *pidgin_get_xfer_dialog(void);

/**

* pidgin_account_chooser_set_filter_func:

* @chooser: The account chooser combo box.

* can be %NULL to remove any filter.

*

* Set the filter function used to determine which accounts to show.