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
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_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_connection
Returns the specified conversation’s purple_connection.
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_drafting
Gets whether or not the user is currently drafting a message in
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_logging
Gets whether or not conversation
is currently being logged.
unstable since: 3.0
purple_conversation_get_needs_attention
Gets whether or not conversation
needs attention.
unstable since: 3.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_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_is_group_dm
Checks if conversation
is a group direct message or not.
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_created_on
Sets the creation time of conversation
to created_on
.
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_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_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_topic_author
Sets the author of the topic for conversation
to author
.
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
Properties
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: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: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: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: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-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
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.