Top | ![]() |
![]() |
![]() |
![]() |
|
camel_operation_new () |
|
camel_operation_new_proxy () |
|
camel_operation_cancel_all () |
|
camel_operation_push_message () |
|
camel_operation_pop_message () |
|
camel_operation_progress () |
GCancellable * camel_operation_new (void
);
Create a new camel operation handle. Camel operation handles can be used in a multithreaded application (or a single operation handle can be used in a non threaded appliation) to cancel running operations and to obtain notification messages of the internal status of messages.
GCancellable * camel_operation_new_proxy ();
GCancellable *cancellable
Proxies the cancellable
in a way that if it is cancelled,
then the returned cancellable is also cancelled, but when
the returned cancellable is cancelled, then it doesn't
influence the original cancellable. Other CamelOperation
actions being done on the returned cancellable are also
propagated to the cancellable
.
The passed-in cancellable
can be NULL
This is useful when some operation can be cancelled from elsewhere (like by a user), but also by the code on its own, when it doesn't make sense to cancel also any larger operation to which the passed-in cancellable belongs.
Since: 3.24
void camel_operation_cancel_all (void
);
Cancel all outstanding operations.
void camel_operation_push_message (,
GCancellable *cancellableconst
,gchar *format...
);
Call this function to describe an operation being performed.
Call camel_operation_progress()
to report progress on the operation.
Call camel_operation_pop_message()
when the operation is complete.
This function only works if cancellable
is a cancellable
is a plain NULL
void camel_operation_pop_message ();
GCancellable *cancellable
Pops the most recently pushed message.
This function only works if cancellable
is a cancellable
is a plain NULL
void camel_operation_progress (,
GCancellable *cancellable);
gint percent
Report progress on the current operation. percent
reports the current
percentage of completion, which should be in the range of 0 to 100.
This function only works if cancellable
is a cancellable
is a plain NULL