Method
PurpleProtocolConversationset_topic_async
unstable since: 3.0
Declaration [src]
void
purple_protocol_conversation_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
This method completes asynchronously. Use purple_protocol_conversation_set_topic_finish() inside the GAsyncReadyCallback to obtain the result of the operation.
Parameters
conversation-
Type:
PurpleConversationThe conversation whose topic to set.
The data is owned by the caller of the method. topic-
Type:
const char*The new topic to set.
The argument can be NULL.The data is owned by the caller of the method. 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 method. callback-
Type:
GAsyncReadyCallbackThe callback to call after the message has been sent.
The argument can be NULL. data-
Type:
gpointerOptional user data to pass to
callback.The argument can be NULL.The data is owned by the caller of the method.