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

Instance methods

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.

unstable 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.

unstable since: 3.0

purple_conversation_get_alias

Gets the libpurple user defined alias for conversation.

unstable since: 3.0

purple_conversation_get_avatar

Gets the PurpleAvatar from conversation if set.

unstable since: 3.0

purple_conversation_get_connection

Returns the specified conversation’s purple_connection.

unstable since: 3.0

purple_conversation_get_conversation_type

Gets the type of conversation.

unstable since: 3.0

purple_conversation_get_created_on

Gets a GDateTime for when conversation was created.

unstable since: 3.0

purple_conversation_get_creator

Gets the PurpleContactInfo that created conversation.

unstable since: 3.0

purple_conversation_get_description

Gets the description of conversation.

unstable since: 3.0

purple_conversation_get_drafting

Gets whether or not the user is currently drafting a message in conversation.

unstable since: 3.0

purple_conversation_get_error

Gets the error of conversation.

unstable since: 3.0

purple_conversation_get_favorite

Gets whether or not conversation is a favorite conversation.

unstable since: 3.0

purple_conversation_get_federated

Gets whether or not conversation is federated.

unstable since: 3.0

purple_conversation_get_global_id

Gets a globally unique id for conversation.

unstable since: 3.0

purple_conversation_get_id

Gets the opaque identifier from conversation.

unstable since: 3.0

purple_conversation_get_logging

Gets whether or not conversation is currently being logged.

unstable since: 3.0

purple_conversation_get_members

Gets the members that are in conversation.

unstable since: 3.0

purple_conversation_get_messages

Gets the list of all messages in conversation.

unstable since: 3.0

purple_conversation_get_name

Returns the specified conversation’s name.

since: 2.0

purple_conversation_get_needs_attention

Gets whether or not conversation needs attention.

unstable since: 3.0

purple_conversation_get_online

Gets whether or not conversation is online.

unstable since: 3.0

purple_conversation_get_tags

Gets the PurpleTags object from conversation.

unstable since: 3.0

purple_conversation_get_title

Returns the specified conversation’s title.

since: 2.0

purple_conversation_get_title_for_display

Gets the title that should be displayed for conversation.

unstable since: 3.0

purple_conversation_get_title_generated

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

unstable since: 3.0

purple_conversation_get_topic

Gets the topic for conversation.

unstable since: 3.0

purple_conversation_get_topic_author

Gets the author of the topic for conversation.

unstable since: 3.0

purple_conversation_get_topic_updated

Gets the last time that the topic was updated.

unstable since: 3.0

purple_conversation_get_typing_state

Gets the PurpleTypingState for the libpurple user in conversation.

unstable since: 3.0

purple_conversation_get_user_nickname

Gets the nickname for the user in conversation.

unstable since: 3.0

purple_conversation_has_focus

Determines if a conversation has focus.

since: 2.0

purple_conversation_is_channel

Checks if conversation is a channel or not.

unstable since: 3.0

purple_conversation_is_dm

Checks if conversation is a direct message or not.

unstable since: 3.0

purple_conversation_is_group_dm

Checks if conversation is a group direct message or not.

unstable since: 3.0

purple_conversation_is_thread

Checks if conversation is a thread or not.

unstable since: 3.0

purple_conversation_present

Emits PurpleConversation::present.

since: 2.0

purple_conversation_send_message_async

Sends message to conversation.

unstable since: 3.0

purple_conversation_send_message_finish

Finishes a previous call to purple_conversation_send_message_async().

unstable since: 3.0

purple_conversation_set_age_restricted

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

unstable since: 3.0

purple_conversation_set_alias

Sets the libpurple user defined alias of conversation to alias.

unstable since: 3.0

purple_conversation_set_avatar

Sets the avatar of conversation to avatar.

unstable since: 3.0

purple_conversation_set_created_on

Sets the creation time of conversation to created_on.

unstable since: 3.0

purple_conversation_set_creator

Sets the creator of conversation to creator.

unstable since: 3.0

purple_conversation_set_description

Sets the description of conversation to description.

unstable since: 3.0

purple_conversation_set_drafting

Sets the drafting state of conversation to drafting.

unstable since: 3.0

purple_conversation_set_error

Sets the error of conversation to error.

unstable since: 3.0

purple_conversation_set_favorite

Sets whether or not conversation is a favorite to favorite.

unstable since: 3.0

purple_conversation_set_logging

Sets the logging state of conversation to logging.

unstable since: 3.0

purple_conversation_set_name

Sets the specified conversation’s name.

since: 2.0

purple_conversation_set_needs_attention

Marks conversation as needing attention or not.

unstable since: 3.0

purple_conversation_set_online

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

unstable 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.

unstable since: 3.0

purple_conversation_set_topic_author

Sets the author of the topic for conversation to author.

unstable since: 3.0

purple_conversation_set_topic_full

Sets everything about the topic all at once.

unstable since: 3.0

purple_conversation_set_topic_updated

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

unstable since: 3.0

purple_conversation_set_typing_state

Sets the PurpleTypingState of the libpurple user in conversation to typing_state.

unstable since: 3.0

purple_conversation_set_user_nickname

Sets the user’s nickname in conversation to nickname.

unstable since: 3.0

purple_conversation_write_message

Writes to a chat or an IM.

unstable 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.

unstable since: 3.0

Purple.Conversation:age-restricted

Whether or not the conversation is age restricted.

unstable since: 3.0

Purple.Conversation:alias

An alias for the conversation that is local to the libpurple user.

unstable since: 3.0

Purple.Conversation:avatar

The PurpleAvatar for the conversation.

unstable 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.

unstable since: 3.0

Purple.Conversation:creator

The PurpleContactInfo that created the conversation.

unstable 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.

unstable since: 3.0

Purple.Conversation:drafting

Whether or not the user has drafted a message for this conversation.

unstable since: 3.0

Purple.Conversation:error

An error that was encountered in this conversation. For example, this could be a channel connection error or a kick message.

unstable since: 3.0

Purple.Conversation:favorite

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

unstable since: 3.0

Purple.Conversation:federated

Whether or this conversation is federated.

unstable since: 3.0

Purple.Conversation:global-id

A libpurple global id for the conversation.

unstable 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.

unstable since: 3.0

Purple.Conversation:logging

Whether or not this conversation is currently being logged.

unstable since: 3.0

Purple.Conversation:members

The members that are currently in this conversation.

unstable since: 3.0

Purple.Conversation:messages

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

unstable since: 3.0

Purple.Conversation:name

The name of the conversation.

unstable since: 3.0

Purple.Conversation:needs-attention

Whether or not the conversation needs attention.

unstable since: 3.0

Purple.Conversation:online

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

unstable since: 3.0

Purple.Conversation:tags

PurpleTags for the conversation.

unstable since: 3.0

Purple.Conversation:title

The title of the conversation.

unstable since: 3.0

Purple.Conversation:title-for-display

The title that should be displayed for the conversation based on which properties are set.

unstable since: 3.0

Purple.Conversation:title-generated

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

unstable since: 3.0

Purple.Conversation:topic

The topic of the conversation.

unstable since: 3.0

Purple.Conversation:topic-author

Sets the author of the topic for the conversation.

unstable since: 3.0

Purple.Conversation:topic-updated

Set to the time that the topic was last updated.

unstable 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.

unstable since: 3.0

Purple.Conversation:typing-state

The PurpleTypingState of the libpurple user in this conversation.

unstable since: 3.0

Purple.Conversation:user-nickname

The user’s nickname in this conversation.

unstable since: 3.0

Signals

Purple.Conversation::present

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

unstable 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.