aboutsummaryrefslogtreecommitdiffstats
path: root/widgets
diff options
context:
space:
mode:
authorMatthew Barnes <mbarnes@redhat.com>2010-10-22 04:21:19 +0800
committerMatthew Barnes <mbarnes@redhat.com>2010-10-23 02:21:22 +0800
commitc881b5bc5e61d04b18d4ab46ad70533e7340d15b (patch)
treee70a3ed0d2f93dacfe20d856de4d29578beb2e50 /widgets
parentf0714755e2fa8b06425907c2cf189abd3a1b7119 (diff)
downloadgsoc2013-evolution-c881b5bc5e61d04b18d4ab46ad70533e7340d15b.tar.gz
gsoc2013-evolution-c881b5bc5e61d04b18d4ab46ad70533e7340d15b.tar.zst
gsoc2013-evolution-c881b5bc5e61d04b18d4ab46ad70533e7340d15b.zip
Simplify EActivity.
With unintrusive error dialogs gone, we can cut some unnecessary bits out of EActivity. I'm also adding a new enum property called "state", which is one of: E_ACTIVITY_RUNNING E_ACTIVITY_WAITING E_ACTIVITY_CANCELLED E_ACTIVITY_COMPLETED The state of an activity must be explicitly changed. In particular, when the user cancels an activity the state should be set only after confirming the operation has been cancelled and not when cancellation is requested (e.g. after receiving a G_IO_ERROR_CANCELLED, not when the GCancellable emits "cancelled"). EActivityBar and EActivityProxy widgets have been updated to make this distinction clearer in the UI. E_ACTIVITY_WAITING will be used when activities have to be queued and dispatched in sequence, which I haven't written yet.
Diffstat (limited to 'widgets')
-rw-r--r--widgets/misc/e-activity-bar.c107
-rw-r--r--widgets/misc/e-activity-proxy.c289
-rw-r--r--widgets/misc/e-activity-proxy.h2
3 files changed, 229 insertions, 169 deletions
diff --git a/widgets/misc/e-activity-bar.c b/widgets/misc/e-activity-bar.c
index 0337822adc..a86e37cbdf 100644
--- a/widgets/misc/e-activity-bar.c
+++ b/widgets/misc/e-activity-bar.c
@@ -23,12 +23,14 @@
((obj), E_TYPE_ACTIVITY_BAR, EActivityBarPrivate))
#define FEEDBACK_PERIOD 1 /* seconds */
+#define COMPLETED_ICON_NAME "emblem-default"
struct _EActivityBarPrivate {
EActivity *activity; /* weak reference */
GtkWidget *image; /* not referenced */
GtkWidget *label; /* not referenced */
GtkWidget *cancel; /* not referenced */
+ GtkWidget *spinner; /* not referenced */
/* If the user clicks the Cancel button, keep the cancelled
* EActivity object alive for a short duration so the user
@@ -47,13 +49,35 @@ G_DEFINE_TYPE (
GTK_TYPE_INFO_BAR)
static void
+activity_bar_feedback (EActivityBar *bar)
+{
+ EActivity *activity;
+ EActivityState state;
+
+ activity = e_activity_bar_get_activity (bar);
+ g_return_if_fail (E_IS_ACTIVITY (activity));
+
+ state = e_activity_get_state (activity);
+ if (state != E_ACTIVITY_CANCELLED && state != E_ACTIVITY_COMPLETED)
+ return;
+
+ if (bar->priv->timeout_id > 0)
+ g_source_remove (bar->priv->timeout_id);
+
+ /* Hold a reference on the EActivity for a short
+ * period so the activity bar stays visible. */
+ bar->priv->timeout_id = g_timeout_add_seconds_full (
+ G_PRIORITY_LOW, FEEDBACK_PERIOD, (GSourceFunc) gtk_false,
+ g_object_ref (activity), (GDestroyNotify) g_object_unref);
+}
+
+static void
activity_bar_update (EActivityBar *bar)
{
EActivity *activity;
+ EActivityState state;
GCancellable *cancellable;
const gchar *icon_name;
- gboolean cancelled;
- gboolean completed;
gboolean sensitive;
gboolean visible;
gchar *description;
@@ -66,14 +90,13 @@ activity_bar_update (EActivityBar *bar)
}
cancellable = e_activity_get_cancellable (activity);
- cancelled = g_cancellable_is_cancelled (cancellable);
- completed = e_activity_is_completed (activity);
icon_name = e_activity_get_icon_name (activity);
+ state = e_activity_get_state (activity);
description = e_activity_describe (activity);
gtk_label_set_text (GTK_LABEL (bar->priv->label), description);
- if (cancelled) {
+ if (state == E_ACTIVITY_CANCELLED) {
PangoAttribute *attr;
PangoAttrList *attr_list;
@@ -90,25 +113,27 @@ activity_bar_update (EActivityBar *bar)
gtk_label_set_attributes (
GTK_LABEL (bar->priv->label), NULL);
- if (cancelled)
+ if (state == E_ACTIVITY_COMPLETED)
+ icon_name = COMPLETED_ICON_NAME;
+
+ if (state == E_ACTIVITY_CANCELLED) {
gtk_image_set_from_stock (
GTK_IMAGE (bar->priv->image),
GTK_STOCK_CANCEL, GTK_ICON_SIZE_BUTTON);
- else {
- if (completed)
- icon_name = "emblem-default";
+ gtk_widget_show (bar->priv->image);
+ } else if (icon_name != NULL) {
gtk_image_set_from_icon_name (
GTK_IMAGE (bar->priv->image),
icon_name, GTK_ICON_SIZE_BUTTON);
+ gtk_widget_show (bar->priv->image);
+ } else {
+ gtk_widget_hide (bar->priv->image);
}
- visible = (icon_name != NULL);
- gtk_widget_set_visible (bar->priv->image, visible);
-
visible = (cancellable != NULL);
gtk_widget_set_visible (bar->priv->cancel, visible);
- sensitive = !cancelled && !completed;
+ sensitive = (state == E_ACTIVITY_RUNNING);
gtk_widget_set_sensitive (bar->priv->cancel, sensitive);
visible = (description != NULL && *description != '\0');
@@ -128,30 +153,16 @@ activity_bar_cancel (EActivityBar *bar)
cancellable = e_activity_get_cancellable (activity);
g_cancellable_cancel (cancellable);
-}
-
-static void
-activity_bar_feedback (EActivityBar *bar)
-{
- EActivity *activity;
-
- activity = e_activity_bar_get_activity (bar);
- g_return_if_fail (E_IS_ACTIVITY (activity));
- if (bar->priv->timeout_id > 0)
- g_source_remove (bar->priv->timeout_id);
-
- /* Hold a reference on the EActivity for a short
- * period so the activity bar stays visible. */
- bar->priv->timeout_id = g_timeout_add_seconds_full (
- G_PRIORITY_LOW, FEEDBACK_PERIOD, (GSourceFunc) gtk_false,
- g_object_ref (activity), (GDestroyNotify) g_object_unref);
+ activity_bar_update (bar);
}
static void
activity_bar_weak_notify_cb (EActivityBar *bar,
GObject *where_the_object_was)
{
+ g_return_if_fail (E_IS_ACTIVITY_BAR (bar));
+
bar->priv->activity = NULL;
e_activity_bar_set_activity (bar, NULL);
}
@@ -259,7 +270,19 @@ e_activity_bar_init (EActivityBar *bar)
widget = gtk_image_new ();
gtk_box_pack_start (GTK_BOX (container), widget, FALSE, FALSE, 0);
bar->priv->image = widget;
- gtk_widget_show (widget);
+
+ widget = gtk_spinner_new ();
+ gtk_spinner_start (GTK_SPINNER (widget));
+ gtk_box_pack_start (GTK_BOX (container), widget, FALSE, FALSE, 0);
+ bar->priv->spinner = widget;
+
+ /* The spinner is only visible when the image is not. */
+ g_object_bind_property (
+ bar->priv->image, "visible",
+ bar->priv->spinner, "visible",
+ G_BINDING_BIDIRECTIONAL |
+ G_BINDING_SYNC_CREATE |
+ G_BINDING_INVERT_BOOLEAN);
widget = gtk_label_new (NULL);
gtk_misc_set_alignment (GTK_MISC (widget), 0.0, 0.5);
@@ -300,12 +323,8 @@ e_activity_bar_set_activity (EActivityBar *bar,
{
g_return_if_fail (E_IS_ACTIVITY_BAR (bar));
- if (activity != NULL) {
+ if (activity != NULL)
g_return_if_fail (E_IS_ACTIVITY (activity));
- g_object_weak_ref (
- G_OBJECT (activity), (GWeakNotify)
- activity_bar_weak_notify_cb, bar);
- }
if (bar->priv->timeout_id > 0) {
g_source_remove (bar->priv->timeout_id);
@@ -324,23 +343,15 @@ e_activity_bar_set_activity (EActivityBar *bar,
bar->priv->activity = activity;
if (activity != NULL) {
- g_signal_connect_swapped (
- activity, "cancelled",
- G_CALLBACK (activity_bar_feedback), bar);
+ g_object_weak_ref (
+ G_OBJECT (activity), (GWeakNotify)
+ activity_bar_weak_notify_cb, bar);
g_signal_connect_swapped (
- activity, "completed",
+ activity, "notify::state",
G_CALLBACK (activity_bar_feedback), bar);
g_signal_connect_swapped (
- activity, "cancelled",
- G_CALLBACK (activity_bar_update), bar);
-
- g_signal_connect_swapped (
- activity, "completed",
- G_CALLBACK (activity_bar_update), bar);
-
- g_signal_connect_swapped (
activity, "notify",
G_CALLBACK (activity_bar_update), bar);
}
diff --git a/widgets/misc/e-activity-proxy.c b/widgets/misc/e-activity-proxy.c
index 26d5d30ba0..aea025d9a7 100644
--- a/widgets/misc/e-activity-proxy.c
+++ b/widgets/misc/e-activity-proxy.c
@@ -27,13 +27,20 @@
(G_TYPE_INSTANCE_GET_PRIVATE \
((obj), E_TYPE_ACTIVITY_PROXY, EActivityProxyPrivate))
+#define FEEDBACK_PERIOD 1 /* seconds */
+#define COMPLETED_ICON_NAME "emblem-default"
+
struct _EActivityProxyPrivate {
- EActivity *activity;
- GtkWidget *button;
- GtkWidget *image;
- GtkWidget *label;
- GtkWidget *cancel;
- GtkWidget *spinner;
+ EActivity *activity; /* weak reference */
+ GtkWidget *image; /* not referenced */
+ GtkWidget *label; /* not referenced */
+ GtkWidget *cancel; /* not referenced */
+ GtkWidget *spinner; /* not referenced */
+
+ /* If the user clicks the Cancel button, keep the cancelled
+ * EActivity object alive for a short duration so the user
+ * gets some visual feedback that cancellation worked. */
+ guint timeout_id;
};
enum {
@@ -47,82 +54,123 @@ G_DEFINE_TYPE (
GTK_TYPE_EVENT_BOX)
static void
-activity_proxy_cancel (EActivity *activity)
+activity_proxy_feedback (EActivityProxy *proxy)
{
- GCancellable *cancellable;
+ EActivity *activity;
+ EActivityState state;
- /* We shouldn't get here unless the EActivity has a GCancellable,
- * since otherwise the cancel button is invisible and unclickable.
- * g_cancellable_cancel() will emit a warning if this breaks. */
+ activity = e_activity_proxy_get_activity (proxy);
+ g_return_if_fail (E_IS_ACTIVITY (activity));
- cancellable = e_activity_get_cancellable (activity);
- g_cancellable_cancel (cancellable);
+ state = e_activity_get_state (activity);
+ if (state != E_ACTIVITY_CANCELLED)
+ return;
+
+ if (proxy->priv->timeout_id > 0)
+ g_source_remove (proxy->priv->timeout_id);
+
+ /* Hold a reference on the EActivity for a short
+ * period so the activity proxy stays visible. */
+ proxy->priv->timeout_id = g_timeout_add_seconds_full (
+ G_PRIORITY_LOW, FEEDBACK_PERIOD, (GSourceFunc) gtk_false,
+ g_object_ref (activity), (GDestroyNotify) g_object_unref);
}
static void
activity_proxy_update (EActivityProxy *proxy)
{
EActivity *activity;
+ EActivityState state;
GCancellable *cancellable;
const gchar *icon_name;
- gboolean cancelled;
- gboolean clickable;
- gboolean completed;
gboolean sensitive;
gboolean visible;
gchar *description;
- activity = proxy->priv->activity;
+ activity = e_activity_proxy_get_activity (proxy);
+
+ if (activity == NULL) {
+ gtk_widget_hide (GTK_WIDGET (proxy));
+ return;
+ }
+
cancellable = e_activity_get_cancellable (activity);
- cancelled = g_cancellable_is_cancelled (cancellable);
- clickable = e_activity_get_clickable (activity);
- completed = e_activity_is_completed (activity);
icon_name = e_activity_get_icon_name (activity);
+ state = e_activity_get_state (activity);
description = e_activity_describe (activity);
gtk_widget_set_tooltip_text (GTK_WIDGET (proxy), description);
gtk_label_set_text (GTK_LABEL (proxy->priv->label), description);
- gtk_widget_set_visible (GTK_WIDGET (proxy), (description != NULL));
- g_free (description);
- /* Note, an activity requires an icon name in order to
- * be clickable. We don't support spinner buttons. */
- if (icon_name != NULL) {
+ if (state == E_ACTIVITY_CANCELLED) {
+ PangoAttribute *attr;
+ PangoAttrList *attr_list;
+
+ attr_list = pango_attr_list_new ();
+
+ attr = pango_attr_strikethrough_new (TRUE);
+ pango_attr_list_insert (attr_list, attr);
+
+ gtk_label_set_attributes (
+ GTK_LABEL (proxy->priv->label), attr_list);
+
+ pango_attr_list_unref (attr_list);
+ } else
+ gtk_label_set_attributes (
+ GTK_LABEL (proxy->priv->label), NULL);
+
+ if (state == E_ACTIVITY_COMPLETED)
+ icon_name = COMPLETED_ICON_NAME;
+
+ if (state == E_ACTIVITY_CANCELLED) {
+ gtk_image_set_from_stock (
+ GTK_IMAGE (proxy->priv->image),
+ GTK_STOCK_CANCEL, GTK_ICON_SIZE_BUTTON);
+ gtk_widget_show (proxy->priv->image);
+ } else if (icon_name != NULL) {
gtk_image_set_from_icon_name (
GTK_IMAGE (proxy->priv->image),
icon_name, GTK_ICON_SIZE_MENU);
- gtk_button_set_image (
- GTK_BUTTON (proxy->priv->button),
- gtk_image_new_from_icon_name (
- icon_name, GTK_ICON_SIZE_MENU));
- gtk_widget_hide (proxy->priv->spinner);
- if (clickable) {
- gtk_widget_show (proxy->priv->button);
- gtk_widget_hide (proxy->priv->image);
- } else {
- gtk_widget_hide (proxy->priv->button);
- gtk_widget_show (proxy->priv->image);
- }
+ gtk_widget_show (proxy->priv->image);
} else {
- gtk_widget_show (proxy->priv->spinner);
- gtk_widget_hide (proxy->priv->button);
gtk_widget_hide (proxy->priv->image);
}
visible = (cancellable != NULL);
gtk_widget_set_visible (proxy->priv->cancel, visible);
- sensitive = !(cancelled || completed);
+ sensitive = (state == E_ACTIVITY_RUNNING);
gtk_widget_set_sensitive (proxy->priv->cancel, sensitive);
+
+ visible = (description != NULL && *description != '\0');
+ gtk_widget_set_visible (GTK_WIDGET (proxy), visible);
+
+ g_free (description);
}
static void
-activity_proxy_set_activity (EActivityProxy *proxy,
- EActivity *activity)
+activity_proxy_cancel (EActivityProxy *proxy)
{
- g_return_if_fail (proxy->priv->activity == NULL);
+ EActivity *activity;
+ GCancellable *cancellable;
+
+ activity = e_activity_proxy_get_activity (proxy);
+ g_return_if_fail (E_IS_ACTIVITY (activity));
+
+ cancellable = e_activity_get_cancellable (activity);
+ g_cancellable_cancel (cancellable);
+
+ activity_proxy_update (proxy);
+}
+
+static void
+activity_proxy_weak_notify_cb (EActivityProxy *proxy,
+ GObject *where_the_object_was)
+{
+ g_return_if_fail (E_IS_ACTIVITY_PROXY (proxy));
- proxy->priv->activity = g_object_ref (activity);
+ proxy->priv->activity = NULL;
+ e_activity_proxy_set_activity (proxy, NULL);
}
static void
@@ -133,7 +181,7 @@ activity_proxy_set_property (GObject *object,
{
switch (property_id) {
case PROP_ACTIVITY:
- activity_proxy_set_activity (
+ e_activity_proxy_set_activity (
E_ACTIVITY_PROXY (object),
g_value_get_object (value));
return;
@@ -166,74 +214,26 @@ activity_proxy_dispose (GObject *object)
priv = E_ACTIVITY_PROXY_GET_PRIVATE (object);
+ if (priv->timeout_id > 0) {
+ g_source_remove (priv->timeout_id);
+ priv->timeout_id = 0;
+ }
+
if (priv->activity != NULL) {
g_signal_handlers_disconnect_matched (
- priv->activity, G_SIGNAL_MATCH_FUNC, 0, 0,
- NULL, activity_proxy_update, NULL);
- g_object_unref (priv->activity);
+ priv->activity, G_SIGNAL_MATCH_DATA,
+ 0, 0, NULL, NULL, object);
+ g_object_weak_unref (
+ G_OBJECT (priv->activity), (GWeakNotify)
+ activity_proxy_weak_notify_cb, object);
priv->activity = NULL;
}
- if (priv->button != NULL) {
- g_object_unref (priv->button);
- priv->button = NULL;
- }
-
- if (priv->image != NULL) {
- g_object_unref (priv->image);
- priv->image = NULL;
- }
-
- if (priv->label != NULL) {
- g_object_unref (priv->label);
- priv->label = NULL;
- }
-
- if (priv->cancel != NULL) {
- g_object_unref (priv->cancel);
- priv->cancel = NULL;
- }
-
- if (priv->spinner != NULL) {
- g_object_unref (priv->spinner);
- priv->spinner = NULL;
- }
-
/* Chain up to parent's dispose() method. */
G_OBJECT_CLASS (e_activity_proxy_parent_class)->dispose (object);
}
static void
-activity_proxy_constructed (GObject *object)
-{
- EActivityProxy *proxy;
-
- proxy = E_ACTIVITY_PROXY (object);
-
- g_signal_connect_swapped (
- proxy->priv->button, "clicked",
- G_CALLBACK (e_activity_clicked), proxy->priv->activity);
-
- g_signal_connect_swapped (
- proxy->priv->cancel, "clicked",
- G_CALLBACK (activity_proxy_cancel), proxy->priv->activity);
-
- g_signal_connect_swapped (
- proxy->priv->activity, "cancelled",
- G_CALLBACK (activity_proxy_update), proxy);
-
- g_signal_connect_swapped (
- proxy->priv->activity, "completed",
- G_CALLBACK (activity_proxy_update), proxy);
-
- g_signal_connect_swapped (
- proxy->priv->activity, "notify",
- G_CALLBACK (activity_proxy_update), proxy);
-
- activity_proxy_update (proxy);
-}
-
-static void
e_activity_proxy_class_init (EActivityProxyClass *class)
{
GObjectClass *object_class;
@@ -244,7 +244,6 @@ e_activity_proxy_class_init (EActivityProxyClass *class)
object_class->set_property = activity_proxy_set_property;
object_class->get_property = activity_proxy_get_property;
object_class->dispose = activity_proxy_dispose;
- object_class->constructed = activity_proxy_constructed;
g_object_class_install_property (
object_class,
@@ -255,7 +254,7 @@ e_activity_proxy_class_init (EActivityProxyClass *class)
NULL,
E_TYPE_ACTIVITY,
G_PARAM_READWRITE |
- G_PARAM_CONSTRUCT_ONLY));
+ G_PARAM_CONSTRUCT));
}
static void
@@ -283,37 +282,42 @@ e_activity_proxy_init (EActivityProxy *proxy)
widget = gtk_image_new ();
gtk_box_pack_start (GTK_BOX (container), widget, FALSE, FALSE, 0);
- proxy->priv->image = g_object_ref (widget);
- gtk_widget_hide (widget);
-
- widget = gtk_button_new ();
- gtk_button_set_relief (GTK_BUTTON (widget), GTK_RELIEF_NONE);
- gtk_box_pack_start (GTK_BOX (container), widget, FALSE, FALSE, 0);
- proxy->priv->button = g_object_ref (widget);
- gtk_widget_hide (widget);
+ proxy->priv->image = widget;
widget = gtk_spinner_new ();
gtk_spinner_start (GTK_SPINNER (widget));
gtk_box_pack_start (GTK_BOX (container), widget, FALSE, FALSE, 3);
- proxy->priv->spinner = g_object_ref (widget);
- gtk_widget_show (widget);
+ proxy->priv->spinner = widget;
+
+ /* The spinner is only visible when the image is not. */
+ g_object_bind_property (
+ proxy->priv->image, "visible",
+ proxy->priv->spinner, "visible",
+ G_BINDING_BIDIRECTIONAL |
+ G_BINDING_SYNC_CREATE |
+ G_BINDING_INVERT_BOOLEAN);
widget = gtk_label_new (NULL);
- gtk_label_set_ellipsize (GTK_LABEL (widget), PANGO_ELLIPSIZE_END);
gtk_misc_set_alignment (GTK_MISC (widget), 0.0, 0.5);
+ gtk_label_set_ellipsize (GTK_LABEL (widget), PANGO_ELLIPSIZE_END);
gtk_box_pack_start (GTK_BOX (container), widget, TRUE, TRUE, 0);
- proxy->priv->label = g_object_ref (widget);
+ proxy->priv->label = widget;
gtk_widget_show (widget);
+ /* This is only shown if the EActivity has a GCancellable. */
widget = gtk_button_new ();
gtk_button_set_image (
GTK_BUTTON (widget), gtk_image_new_from_stock (
- GTK_STOCK_STOP, GTK_ICON_SIZE_MENU));
+ GTK_STOCK_CANCEL, GTK_ICON_SIZE_MENU));
gtk_button_set_relief (GTK_BUTTON (widget), GTK_RELIEF_NONE);
gtk_box_pack_start (GTK_BOX (container), widget, FALSE, FALSE, 0);
gtk_widget_set_tooltip_text (widget, _("Cancel"));
- proxy->priv->cancel = g_object_ref (widget);
+ proxy->priv->cancel = widget;
gtk_widget_show (widget);
+
+ g_signal_connect_swapped (
+ widget, "clicked",
+ G_CALLBACK (activity_proxy_cancel), proxy);
}
GtkWidget *
@@ -322,8 +326,7 @@ e_activity_proxy_new (EActivity *activity)
g_return_val_if_fail (E_IS_ACTIVITY (activity), NULL);
return g_object_new (
- E_TYPE_ACTIVITY_PROXY,
- "activity", activity, NULL);
+ E_TYPE_ACTIVITY_PROXY, "activity", activity, NULL);
}
EActivity *
@@ -333,3 +336,47 @@ e_activity_proxy_get_activity (EActivityProxy *proxy)
return proxy->priv->activity;
}
+
+void
+e_activity_proxy_set_activity (EActivityProxy *proxy,
+ EActivity *activity)
+{
+ g_return_if_fail (E_IS_ACTIVITY_PROXY (proxy));
+
+ if (activity != NULL)
+ g_return_if_fail (E_IS_ACTIVITY (activity));
+
+ if (proxy->priv->timeout_id > 0) {
+ g_source_remove (proxy->priv->timeout_id);
+ proxy->priv->timeout_id = 0;
+ }
+
+ if (proxy->priv->activity != NULL) {
+ g_signal_handlers_disconnect_matched (
+ proxy->priv->activity, G_SIGNAL_MATCH_DATA,
+ 0, 0, NULL, NULL, proxy);
+ g_object_weak_unref (
+ G_OBJECT (proxy->priv->activity),
+ (GWeakNotify) activity_proxy_weak_notify_cb, proxy);
+ }
+
+ proxy->priv->activity = activity;
+
+ if (activity != NULL) {
+ g_object_weak_ref (
+ G_OBJECT (activity), (GWeakNotify)
+ activity_proxy_weak_notify_cb, proxy);
+
+ g_signal_connect_swapped (
+ activity, "notify::state",
+ G_CALLBACK (activity_proxy_feedback), proxy);
+
+ g_signal_connect_swapped (
+ activity, "notify",
+ G_CALLBACK (activity_proxy_update), proxy);
+ }
+
+ activity_proxy_update (proxy);
+
+ g_object_notify (G_OBJECT (proxy), "activity");
+}
diff --git a/widgets/misc/e-activity-proxy.h b/widgets/misc/e-activity-proxy.h
index 8844988e3d..cb44d6b025 100644
--- a/widgets/misc/e-activity-proxy.h
+++ b/widgets/misc/e-activity-proxy.h
@@ -62,6 +62,8 @@ struct _EActivityProxyClass {
GType e_activity_proxy_get_type (void);
GtkWidget * e_activity_proxy_new (EActivity *activity);
EActivity * e_activity_proxy_get_activity (EActivityProxy *proxy);
+void e_activity_proxy_set_activity (EActivityProxy *proxy,
+ EActivity *activity);
G_END_DECLS