Class
PurpleMessage
unstable since: 3.0
Description [src]
final class Purple.Message : GObject.Object
{
/* No available fields */
}
PurpleMessage
represents any message passed between users in libpurple.
Available since: 3.0
Instance methods
purple_message_foreach_attachment
Calls func
for each PurpleAttachment
that’s attached to message
.
unstable since: 3.0
purple_message_format_timestamp
Formats the timestamp of message
and returns it.
unstable since: 3.0
purple_message_get_attachment
Retrieves the PurpleAttachment
identified by id
from message
.
unstable since: 3.0
purple_message_get_delivered_at
Gets the time that message
was delivered if it was delivered, otherwise
NULL
.
unstable since: 3.0
purple_message_get_edited_at
Gets the time that message
was last edited. If message
has never been
edited this will be NULL
.
unstable since: 3.0
purple_message_get_id
Returns the unique identifier of the message. These identifiers are not serialized - it’s a per-session id.
unstable since: 3.0
purple_message_get_timestamp
Returns a message
‘s timestamp. If message
does not currently have a
timestamp, the current time will be set as the time stamp and returned.
unstable since: 3.0
purple_message_remove_attachment
Removes the PurpleAttachment
identified by id
if it exists.
unstable since: 3.0
purple_message_set_author_name_color
Sets the author’s name color of message
to color
. This is the color that
will be used to display the author’s name in a user interface. The user
interface might not use this exact color, as it might need to adapt for
contrast or limits on the number of colors.
unstable since: 3.0
purple_message_set_error
Sets the error of message
to error
. Primarily this will be used for
delivery failure.
unstable since: 3.0
purple_message_set_timestamp_now
Calls purple_message_set_timestamp()
with the current UTC time.
unstable since: 3.0
Properties
Purple.Message:delivered
Whether or not the message was delivered. This is protocol dependent and
possibly client dependent as well. So if this is FALSE
that doesn’t
necessarily mean the message was not delivered.
unstable since: 3.0
Purple.Message:delivered-at
The time that the message was delivered. This is protocol dependent and
possibly client dependent as well. So if this is NULL
that doesn’t
necessarily mean the message was not delivered.
unstable since: 3.0
Purple.Message:edited-at
The time that the message was last edited at. This is protocol dependent
and possibly client dependent as well. So if this is NULL
that doesn’t
necessarily mean the message was not edited.
unstable since: 3.0
Purple.Message:error
An error that this message encountered. This could be something like a failed delivery, or failed redaction, or rate limited, etc.
unstable since: 3.0
Signals
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.