Top | ![]() |
![]() |
![]() |
![]() |
|
e_alert_sink_submit_alert () |
|
(*EAlertSinkThreadJobFunc) () |
struct |
e_alert_sink_submit_thread_job () |
|
e_alert_sink_thread_job_set_alert_ident () |
|
e_alert_sink_thread_job_set_alert_arg_0 () |
A widget that implements
void e_alert_sink_submit_alert (,
EAlertSink *alert_sink);
EAlert *alert
This function is a place to pass
void (*EAlertSinkThreadJobFunc) (EAlertSinkThreadJobData *job_data
,,
gpointer user_data,
GCancellable *cancellable);
GError **error
struct_EActivity * e_alert_sink_submit_thread_job (,
EAlertSink *alert_sinkconst
,gchar *descriptionconst
,gchar *alert_identconst
,gchar *alert_arg_0EAlertSinkThreadJobFunc func
,,
gpointer user_data);
GDestroyNotify free_user_data
Runs the func
in a dedicated thread. Any error is propagated to UI.
The cancellable passed into the func
is a
alert_sink |
an |
|
description |
user-friendly description of the job, to be shown in UI |
|
alert_ident |
in case of an error, this alert identificator is used for EAlert construction |
|
alert_arg_0 |
in case of an error, use this string as
the first argument to the EAlert construction; the second argument
is the actual error message; can be |
[allow-none] |
func |
function to be run in a dedicated thread |
|
user_data |
custom data passed into |
[allow-none] |
free_user_data |
function to be called on |
[allow-none] |
Newly created g_object_unref()
Note: The free_user_data
, if set, is called in the main thread.
Note: This function should be called only from the main thread.
[transfer full]
Since: 3.16
void e_alert_sink_thread_job_set_alert_ident (EAlertSinkThreadJobData *job_data
,const
);gchar *alert_ident
Change an alert identificator to be used for error reporting.
This can be used within a thread function at e_alert_sink_submit_thread_job()
,
to overwrite the default error message, in case of a need to more fine-tuned
infomation to a user being available.
See: e_alert_sink_thread_job_set_alert_arg_0
job_data |
Thread job data, as passed to a thread
function specified at |
|
alert_ident |
A new alert identificator to use; cannot be |
Since: 3.16
void e_alert_sink_thread_job_set_alert_arg_0 (EAlertSinkThreadJobData *job_data
,const
);gchar *alert_arg_0
Change an argument 0 for an alert to be used for error reporting.
This can be used within a thread function at e_alert_sink_submit_thread_job()
,
to overwrite the default argument 0 of the erorr message. It might be
usually used with combination of e_alert_sink_thread_job_set_alert_ident()
.
job_data |
Thread job data, as passed to a thread
function specified at |
|
alert_arg_0 |
A new argument 0 of the alert;
can be |
[allow-none] |
Since: 3.16