Class

PurpleConversation

since: 2.0

Description [src]

final class Purple.Conversation : GObject.Object {
  /* No available fields */
}

A core representation of a conversation between two or more people.

The conversation can be an IM or a chat.

Note: When a conversation is destroyed with the last g_object_unref(), the specified conversation is removed from the parent window. If this conversation is the only one contained in the parent window, that window is also destroyed.

Available since: 2.0

Ancestors

Functions

purple_conversation_present_error

Presents an IM-error to the user.

since: 3.0

Instance methods

purple_conversation_add_member

Looks for an existing PurpleConversationMember for info in conversation and returns it if found. If not, a new PurpleConversationMember is created.

since: 3.0

purple_conversation_find_member

Finds the PurpleConversationMember for info if they are a member of conversation.

since: 3.0

purple_conversation_generate_title

Sets the title for conversation, which must be a DM or Group DM, to a comma separated string of the display names for each PurpleConversationMember.

since: 3.0

purple_conversation_get_account

Returns the specified conversation’s purple_account.

since: 2.0

purple_conversation_get_age_restricted

Gets whether or not conversation is age restricted.

since: 3.0

purple_conversation_get_avatar

Gets the PurpleAvatar from conversation if set.

since: 3.0

purple_conversation_get_connection

Returns the specified conversation’s purple_connection.

since: 3.0

purple_conversation_get_conversation_type

Gets the type of conversation.

since: 3.0

purple_conversation_get_created_on

Gets a GDateTime for when conversation was created.

since: 3.0

purple_conversation_get_creator

Gets the PurpleContactInfo that created conversation.

since: 3.0

purple_conversation_get_description

Gets the description of conversation.

since: 3.0

purple_conversation_get_favorite

Gets whether or not conversation is a favorite conversation.

since: 3.0

purple_conversation_get_features

Get the features supported by the given conversation.

since: 2.0

purple_conversation_get_federated

Gets whether or not conversation is federated.

since: 3.0

purple_conversation_get_id

Gets the opaque identifier from conversation.

since: 3.0

purple_conversation_get_members

Gets the members that are in conversation.

since: 3.0

purple_conversation_get_messages

Gets the list of all messages in conversation.

since: 3.0

purple_conversation_get_name

Returns the specified conversation’s name.

since: 2.0

purple_conversation_get_online

Gets whether or not conversation is online.

since: 3.0

purple_conversation_get_tags

Gets the PurpleTags object from conversation.

since: 3.0

purple_conversation_get_title

Returns the specified conversation’s title.

since: 2.0

purple_conversation_get_title_generated

Gets whether or not the current title was automatically generated via purple_conversation_generate_title().

since: 3.0

purple_conversation_get_topic

Gets the topic for conversation.

since: 3.0

purple_conversation_get_topic_author

Gets the author of the topic for conversation.

since: 3.0

purple_conversation_get_topic_updated

Gets the last time that the topic was updated.

since: 3.0

purple_conversation_get_user_nickname

Gets the nickname for the user in conversation.

since: 3.0

purple_conversation_has_focus

Determines if a conversation has focus.

since: 2.0

purple_conversation_has_member

Checks if info is in conversation. If info is found, position is set to the position of info in PurpleConversation:members if it is not NULL.

since: 3.0

purple_conversation_is_channel

Checks if conversation is a channel or not.

since: 3.0

purple_conversation_is_dm

Checks if conversation is a direct message or not.

since: 3.0

purple_conversation_is_group_dm

Checks if conversation is a group direct message or not.

since: 3.0

purple_conversation_is_thread

Checks if conversation is a thread or not.

since: 3.0

purple_conversation_present

Emits PurpleConversation::present.

since: 2.0

purple_conversation_remove_member

Attempts to remove info from the collection of members in conversation. If found, info is removed and the PurpleConversation::member-removed signal is emitted with announce and message as parameters.

since: 3.0

purple_conversation_send

Sends a message to this conversation. This function calls purple_conversation_send_with_flags() with no additional flags.

since: 3.0

purple_conversation_send_message_async

Sends message to conversation.

since: 3.0

purple_conversation_send_message_finish

Finishes a previous call to purple_conversation_send_message_async().

since: 3.0

purple_conversation_send_with_flags

Sends a message to this conversation with specified flags.

since: 3.0

purple_conversation_set_age_restricted

Sets whether or not conversation is age restricted to the value of age_restricted.

since: 3.0

purple_conversation_set_avatar

Sets the avatar of conversation to avatar.

since: 3.0

purple_conversation_set_created_on

Sets the creation time of conversation to created_on.

since: 3.0

purple_conversation_set_creator

Sets the creator of conversation to creator.

since: 3.0

purple_conversation_set_description

Sets the description of conversation to description.

since: 3.0

purple_conversation_set_favorite

Sets whether or not conversation is a favorite to favorite.

since: 3.0

purple_conversation_set_features

Set the features as supported for the given conversation.

since: 2.0

purple_conversation_set_name

Sets the specified conversation’s name.

since: 2.0

purple_conversation_set_online

Sets whether or not the conversation is online, or able to send and receive messages.

since: 3.0

purple_conversation_set_title

Sets the specified conversation’s title.

since: 2.0

purple_conversation_set_topic

Sets the topic of conversation to topic.

since: 3.0

purple_conversation_set_topic_author

Sets the author of the topic for conversation to author.

since: 3.0

purple_conversation_set_topic_full

Sets everything about the topic all at once.

since: 3.0

purple_conversation_set_topic_updated

Sets the time that the topic was lasted updated for conversation.

since: 3.0

purple_conversation_set_user_nickname

Sets the user’s nickname in conversation to nickname.

since: 3.0

purple_conversation_write_message

Writes to a chat or an IM.

since: 3.0

purple_conversation_write_system_message

Writes a system message to a chat or an IM.

since: 3.0

Methods inherited from GObject (43)

Please see GObject for a full list of methods.

Properties

Purple.Conversation:account

The account this conversation belongs to.

since: 3.0

Purple.Conversation:age-restricted

Whether or not the conversation is age restricted.

since: 3.0

Purple.Conversation:avatar

The PurpleAvatar for the conversation.

since: 3.0

Purple.Conversation:created-on

The GDateTime when this conversation was created. This can be NULL if the value is not known or supported.

since: 3.0

Purple.Conversation:creator

The PurpleContactInfo that created the conversation.

since: 3.0

Purple.Conversation:description

Sets the description of the conversation. This field is typically used to give more information about a conversation than that which would fit in PurpleConversation:topic.

since: 3.0

Purple.Conversation:favorite

Whether or not the conversation has been marked as favorite by the user.

since: 3.0

Purple.Conversation:features

The features that this conversation supports.

since: 3.0

Purple.Conversation:federated

Whether or this conversation is federated.

since: 3.0

Purple.Conversation:id

An opaque identifier for this conversation. Generally speaking this is protocol dependent and should only be used as a unique identifier.

since: 3.0

Purple.Conversation:members

The members that are currently in this conversation.

since: 3.0

Purple.Conversation:messages

A [iface.Gio.ListModel] of all the messages in this conversation.

since: 3.0

Purple.Conversation:name

The name of the conversation.

since: 3.0

Purple.Conversation:online

Whether or not the conversation is able to send and receive messages.

since: 3.0

Purple.Conversation:tags

PurpleTags for the conversation.

since: 3.0

Purple.Conversation:title

The title of the conversation.

since: 3.0

Purple.Conversation:title-generated

Whether or not the title of the conversation was generated by purple_conversation_generate_title().

since: 3.0

Purple.Conversation:topic

The topic of the conversation.

since: 3.0

Purple.Conversation:topic-author

Sets the author of the topic for the conversation.

since: 3.0

Purple.Conversation:topic-updated

Set to the time that the topic was last updated.

since: 3.0

Purple.Conversation:type

A type hint for the conversation. This may be useful for protocols, but libpurple treats all conversations the same.

since: 3.0

Purple.Conversation:user-nickname

The user’s nickname in this conversation.

since: 3.0

Signals

Purple.Conversation::member-added

Emitted when a new member is added to this conversation.

since: 3.0

Purple.Conversation::member-removed

Emitted when member is removed from this conversation.

since: 3.0

Purple.Conversation::present

Emitted by purple_conversation_present() when something wants the conversation presented to the user.

since: 3.0

Signals inherited from GObject (1)
GObject::notify

The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.

Class structure

struct PurpleConversationClass {
  GObjectClass parent_class;
  
}
No description available.
Class members
parent_class: GObjectClass
No description available.