Rename ModestToolbarDimmingRules to ModestWindowDimmingRules and

[modest] / src / modest-platform.h

diff --git a/src/modest-platform.h b/src/modest-platform.h
index 745dd5f..606b3d9 100644 (file)
--- a/src/modest-platform.h
+++ b/src/modest-platform.h
@@ -127,10 +127,11 @@ gboolean modest_platform_show_uri_popup (const gchar *uri);
 /**
  * modest_platform_get_icon:
  * @name: the name of the icon
+ * @size: the icon size, use MODEST_ICON_SMALL or MODEST_ICON_BIG
  *
  * this function returns an icon, or NULL in case of error 
  */
-GdkPixbuf* modest_platform_get_icon (const gchar *name);
+GdkPixbuf* modest_platform_get_icon (const gchar *name, guint icon_size);
 
 
 /**
@@ -189,6 +190,24 @@ gint      modest_platform_run_rename_folder_dialog        (GtkWindow *parent_win
 gint      modest_platform_run_confirmation_dialog      (GtkWindow *parent_window,
                                                        const gchar *message);
 
+
+/**
+ * modest_platform_run_confirmation_dialog_with_buttons:
+ * @parent_window: the parent #GtkWindow of the dialog
+ * @message: the message to show to the user
+ * @button_accept: the text to show in the label of the accept button
+ * @button_cancel: the text to show in the label of the cancel button
+ * 
+ * runs a confirmation dialog with the given values for the buttons
+ * 
+ * Returns: GTK_RESPONSE_OK or GTK_RESPONSE_CANCEL
+ **/
+gint
+modest_platform_run_confirmation_dialog_with_buttons (GtkWindow *parent_window,
+                                                     const gchar *message,
+                                                     const gchar *button_accept,
+                                                     const gchar *button_cancel);
+
 /**
  * modest_platform_run_yes_no_dialog:
  * @parent_window: the parent #GtkWindow of the dialog
@@ -259,14 +278,6 @@ gboolean modest_platform_connect_and_wait_if_network_account (GtkWindow *parent_
 gboolean modest_platform_connect_and_wait_if_network_folderstore (GtkWindow *parent_window, TnyFolderStore *folder_store);
 
 /**
- * modest_platform_is_network_folderstore:
- * @folder_store: The folder store (folder or account) that needs to
- * decide if need a connection in subsequent operations.
- * @return value: Whether a connection is necessary for this folder_store.
- */
-gboolean modest_platform_is_network_folderstore (TnyFolderStore *folder_store);
-
-/**
  * modest_platform_set_update_interval:
  * @minutes: The number of minutes between updates, or 0 for no updates.
  * 
@@ -288,11 +299,13 @@ GtkWidget* modest_platform_get_global_settings_dialog (void);
 /**
  * modest_platform_on_new_headers_received:
  * @header_list: the list of new received headers
+ * @show_visual: adds a visual notification 
  *
  * Performs the required actions when new headers are
  * received. Tipically it's useful for showing new email notifications
  **/
-void modest_platform_on_new_headers_received (TnyList *header_list);
+void modest_platform_on_new_headers_received (TnyList *header_list,
+                                             gboolean show_visual);
 
 /**
  * modest_platform_show_help:
@@ -327,6 +340,12 @@ void modest_platform_information_banner (GtkWidget *widget,
                                         const gchar *icon_name,
                                         const gchar *text);
 
+/* Timeout is in miliseconds */
+void modest_platform_information_banner_with_timeout (GtkWidget *parent,
+                                                     const gchar *icon_name,
+                                                     const gchar *text,
+                                                     gint timeout);
+
 GtkWidget *
 modest_platform_animation_banner (GtkWidget *parent,
                                  const gchar *annimation_name,
@@ -374,10 +393,11 @@ gboolean modest_platform_run_alert_dialog (const gchar* prompt, gboolean is_ques
 
 /**
  * modest_platform_remove_new_mail_notifications:
+ * @only_visuals: remove only the visual notifications (like LEDs)
  *
  * Removes all the active new mail notifications
  **/
-void modest_platform_remove_new_mail_notifications (void);
+void modest_platform_remove_new_mail_notifications (gboolean only_visuals);
 
 /* ModestConnectedPerformer:
  * @canceled: whether or not the user canceled
@@ -412,23 +432,7 @@ void modest_platform_connect_and_perform (GtkWindow *parent_window,
                                          gpointer user_data);
                
 /*
- * modest_platform_connect_and_perform_if_network_account:
- * @parent_window: the parent #GtkWindow for any interactive or progress feedback UI.
- * @account: The account that might need a connection in subsequent operations.
- * @callback: will be called when finished, can be NULL
- * @user_data: user data for @callback
- * 
- * Like modest_platform_connect_and_perform(), but only attempts to make a connection if the 
- * @account uses the network. For instance, this just returns for local maildir accounts. It
- * will in that case instantly perform the @callback.
- */
-void modest_platform_connect_and_perform_if_network_account (GtkWindow *parent_window, 
-                                                            TnyAccount *account,
-                                                            ModestConnectedPerformer callback, 
-                                                            gpointer user_data);
- 
-/*
- * modest_platform_connect_and_perform_if_network_folderstore:
+ * modest_platform_connect_if_remote_and_perform:
  * @parent_window: the parent #GtkWindow for any interactive or progress feedback UI.
  * @folder_store: The folder store (folder or account) that might need a connection in subsequent operations.
  * @callback: will be called when finished, can be NULL
@@ -436,13 +440,33 @@ void modest_platform_connect_and_perform_if_network_account (GtkWindow *parent_w
  * 
  * Like modest_platform_connect_and_perform(), but only attempts to make a connection if the 
  * folder store uses the network. For instance, this just returns for local maildir folders. It
- * will in that case instantly perform the @callback
+ * will in that case synchronously and instantly perform the @callback
  */
-void modest_platform_connect_and_perform_if_network_folderstore (GtkWindow *parent_window, 
+void modest_platform_connect_if_remote_and_perform (GtkWindow *parent_window, 
                                                                 TnyFolderStore *folder_store,
                                                                 ModestConnectedPerformer callback, 
                                                                 gpointer user_data);
 
+/**
+ * modest_platform_get_account_settings_dialog:
+ * @settings: a #ModestAccountSettings
+ *
+ * creates a dialog for editing @settings
+ *
+ * Returns: the newly created dialog.
+ */
+GtkWidget *modest_platform_get_account_settings_dialog (ModestAccountSettings *settings);
+
+/**
+ * modest_platform_get_account_settings_wizard:
+ * @settings: a #ModestAccountSettings
+ *
+ * creates a dialog for editing @settings
+ *
+ * Returns: the newly created dialog.
+ */
+GtkWidget *modest_platform_get_account_settings_wizard ();
+
 G_END_DECLS
 
 #endif /* __MODEST_PLATFORM_UTILS_H__ */