* Fixes NB#86171, show the proper error banner when account could not connect due...
[modest] / src / modest-platform.h
index 606b3d9..c22d839 100644 (file)
@@ -33,6 +33,7 @@
 #include <tny-device.h>
 #include "widgets/modest-window.h"
 #include "widgets/modest-folder-view.h"
+#include "widgets/modest-sort-criterium-view.h"
 
 G_BEGIN_DECLS
 
@@ -40,9 +41,10 @@ typedef enum _ModestConfirmationDialogType {
        MODEST_CONFIRMATION_DELETE_FOLDER,
 } ModestConfirmationDialogType;
 
-typedef enum _ModestSortDialogType {
-       MODEST_SORT_HEADERS,
-} ModestSortDialogType;
+typedef enum _ModestConnectedVia {
+       MODEST_CONNECTED_VIA_WLAN_OR_WIMAX = 1,
+       MODEST_CONNECTED_VIA_ANY,
+} ModestConnectedVia;
 
 /**
  * modest_platform_platform_init:
@@ -225,21 +227,23 @@ gint      modest_platform_run_yes_no_dialog      (GtkWindow *parent_window,
  * modest_platform_run_information_dialog:
  * @parent_window: the parent #GtkWindow of the dialog
  * @message: the message to show
+ * @block: whether or not the dialog should block the main loop or not while running
  * 
  * shows an information dialog
  **/
 void      modest_platform_run_information_dialog       (GtkWindow *parent_window,
-                                                       const gchar *message);
+                                                       const gchar *message,
+                                                       gboolean block);
 
 /**
- * modest_platform_run_sort_dialog:
+ * modest_platform_create_sort_dialog:
  * @parent_window: the parent #GtkWindow of the dialog
- * @type: the sort dialog type.
  * 
- * shows a sort dialog
+ * creates a proper sort dialog for the platform
+ *
+ * Returns: a #GtkDialog implementing #ModestSortCriteriumView interface
  **/
-void      modest_platform_run_sort_dialog       (GtkWindow *parent_window, 
-                                                ModestSortDialogType type);
+GtkWidget *modest_platform_create_sort_dialog       (GtkWindow *parent_window);
                
 /*
  * modest_platform_connect_and_wait:
@@ -297,6 +301,14 @@ gboolean modest_platform_set_update_interval (guint minutes);
 GtkWidget* modest_platform_get_global_settings_dialog (void);
 
 /**
+ * modest_platform_push_email_notification:
+ *
+ * Notify the user when new e-mail arrives by playing a sound, making
+ * a light blink, etc.
+ */
+void modest_platform_push_email_notification(void);
+
+/**
  * modest_platform_on_new_headers_received:
  * @header_list: the list of new received headers
  * @show_visual: adds a visual notification 
@@ -414,8 +426,15 @@ typedef void (*ModestConnectedPerformer) (gboolean canceled,
                                          TnyAccount *account, 
                                          gpointer user_data);
 
+typedef struct {
+       TnyAccount *dst_account;
+       ModestConnectedPerformer callback;
+       gpointer data;
+} DoubleConnectionInfo;
+
 /*
  * modest_platform_connect_and_perform:
+ * @force: force the device to connect if we're offline, if FALSE then it does not connect if required
  * @parent_window: the parent #GtkWindow for any interactive or progress feedback UI.
  * @account: The account to be used.
  * @callback: will be called when finished, can be NULL
@@ -427,6 +446,7 @@ typedef void (*ModestConnectedPerformer) (gboolean canceled,
  * @account is NULL, only a network connection is made using the platform's device.
  */            
 void modest_platform_connect_and_perform (GtkWindow *parent_window, 
+                                         gboolean force,
                                          TnyAccount *account, 
                                          ModestConnectedPerformer callback, 
                                          gpointer user_data);
@@ -443,9 +463,23 @@ void modest_platform_connect_and_perform (GtkWindow *parent_window,
  * will in that case synchronously and instantly perform the @callback
  */
 void modest_platform_connect_if_remote_and_perform (GtkWindow *parent_window, 
-                                                                TnyFolderStore *folder_store,
-                                                                ModestConnectedPerformer callback, 
-                                                                gpointer user_data);
+                                                   gboolean force,
+                                                   TnyFolderStore *folder_store,
+                                                   ModestConnectedPerformer callback, 
+                                                   gpointer user_data);
+
+/*
+ * modest_platform_double_connect_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
+ * @info: 
+ * 
+ */
+void modest_platform_double_connect_and_perform (GtkWindow *parent_window, 
+                                                gboolean force,
+                                                TnyFolderStore *folder_store,
+                                                DoubleConnectionInfo *info);
 
 /**
  * modest_platform_get_account_settings_dialog:
@@ -465,8 +499,29 @@ GtkWidget *modest_platform_get_account_settings_dialog (ModestAccountSettings *s
  *
  * Returns: the newly created dialog.
  */
-GtkWidget *modest_platform_get_account_settings_wizard ();
+GtkWidget *modest_platform_get_account_settings_wizard (void);
+
+ModestConnectedVia modest_platform_get_current_connection (void);
+
+
+
+
+/**
+ * modest_platform_check_memory_low:
+ * 
+ * @win: a ModestWindow, or NULL
+ * @visuals: whether or not show visual information
+ *
+ * see if memory is too low for big memory consuming operations
+ * optionally show a warning dialog if @win was provided
+ *
+ * Returns: TRUE if we're in lowmem state, FALSE otherwise
+ */
+gboolean modest_platform_check_memory_low (ModestWindow *win,
+                                          gboolean visuals);
+
 
 G_END_DECLS
 
 #endif /* __MODEST_PLATFORM_UTILS_H__ */
+