Virtual Method
PurpleProtocolConversationset_topic_async
since: 3.0
Declaration [src]
void
set_topic_async (
PurpleProtocolConversation* protocol,
PurpleConversation* conversation,
const char* topic,
GCancellable* cancellable,
GAsyncReadyCallback callback,
gpointer data
)
Description [src]
Starts the process of setting the topic of conversation to topic.
It is up to the protocol to define how PurpleConversation:topic is
updated. It may be able to do this immediately based on a result from the
other end, or it might have to wait until another event comes in telling it
to update it. Regardless, user interfaces should not be updating the topic directly.
Available since: 3.0
Parameters
conversation-
Type:
PurpleConversationThe conversation whose topic to set.
The data is owned by the caller of the function. topic-
Type:
const char*The new topic to set.
The argument can be NULL.The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string. cancellable-
Type:
GCancellableOptional GCancellable object,
NULLto ignore.The argument can be NULL.The data is owned by the caller of the function. callback-
Type:
GAsyncReadyCallbackThe callback to call after the message has been sent.
data-
Type:
gpointerOptional user data to pass to
callback.The argument can be NULL.The data is owned by the caller of the function.