Implement "search messages" action (fixes NB#57209).
[modest] / src / modest-platform.h
index e4d4b15..2511e9d 100644 (file)
 #ifndef __MODEST_PLATFORM_H__
 #define __MODEST_PLATFORM_H__
 
-#include <glib.h>
 #include <tny-device.h>
+#include "widgets/modest-window.h"
+
+G_BEGIN_DECLS
+
+typedef enum _ModestConfirmationDialogType {
+       MODEST_CONFIRMATION_DELETE_FOLDER,
+} ModestConfirmationDialogType;
+
+typedef enum _ModestSortDialogType {
+       MODEST_SORT_HEADERS,
+} ModestSortDialogType;
 
 /**
  * modest_platform_platform_init:
@@ -54,7 +64,7 @@ TnyDevice*  modest_platform_get_new_device (void);
 
 
 /**
- * modest_platform_get_file_icon:
+ * modest_platform_get_file_icon_name:
  * @name: the name of the file, or NULL
  * @mime_type: the mime-type, or NULL
  * @effective_mime_type: out-param which receives the 'effective mime-type', ie., the mime type
@@ -72,4 +82,157 @@ TnyDevice*  modest_platform_get_new_device (void);
 gchar*  modest_platform_get_file_icon_name (const gchar* name, const gchar* mime_type,
                                            gchar **effective_mime_type);
 
+/**
+ * modest_platform_activate_uri:
+ * @uri: the uri to activate
+ *
+ * This function activates an URI
+ *
+ * Returns: %TRUE if successful, %FALSE if not.
+ **/
+gboolean modest_platform_activate_uri (const gchar *uri);
+
+/**
+ * modest_platform_activate_file:
+ * @path: the path to activate
+ * @mime_type: the mime type of the path, or %NULL to guess
+ *
+ * This function activates a file
+ *
+ * Returns: %TRUE if successful, %FALSE if not.
+ **/
+gboolean modest_platform_activate_file (const gchar *path, const gchar *mime_type);
+
+/**
+ * modest_platform_show_uri_popup:
+ * @uri: an URI with the string
+ *
+ * This function show the popup of actions for an URI
+ *
+ * Returns: %TRUE if successful, %FALSE if not.
+ **/
+gboolean modest_platform_show_uri_popup (const gchar *uri);
+
+/**
+ * modest_platform_get_icon:
+ * @name: the name of the icon
+ *
+ * this function returns an icon, or NULL in case of error 
+ */
+GdkPixbuf* modest_platform_get_icon (const gchar *name);
+
+
+/**
+ * modest_platform_get_application_name:
+ *
+ * this function returns the name of the application. Do not modify.
+ */
+const gchar* modest_platform_get_app_name (void);
+
+
+/**
+ * modest_platform_run_new_folder_dialog:
+ * @parent_window: a #GtkWindow
+ * @parent: the parent of the new folder
+ * @suggested_name: the suggested name for the new folder
+ * @folder_name: the folder name selected by the user for the new folder
+ * 
+ * runs a "new folder" confirmation dialog. The dialog will suggest a
+ * folder name which depends of the platform if the #suggested_name
+ * parametter is NULL. If the user input a valid folder name it's
+ * returned in the #folder_name attribute.
+ * 
+ * Returns: the #GtkResponseType returned by the dialog
+ **/
+gint      modest_platform_run_new_folder_dialog        (GtkWindow *parent_window,
+                                                       TnyFolderStore *parent,
+                                                       gchar *suggested_name,
+                                                       gchar **folder_name);
+
+/**
+ * modest_platform_run_confirmation_dialog:
+ * @parent_window: the parent #GtkWindow of the dialog
+ * @message: the message to show to the user
+ * 
+ * runs a confirmation dialog
+ * 
+ * Returns: GTK_RESPONSE_OK or GTK_RESPONSE_CANCEL
+ **/
+gint      modest_platform_run_confirmation_dialog      (GtkWindow *parent_window,
+                                                       const gchar *message);
+
+
+/**
+ * modest_platform_run_information_dialog:
+ * @parent_window: the parent #GtkWindow of the dialog
+ * @message: the message to show
+ * 
+ * shows an information dialog
+ **/
+void      modest_platform_run_information_dialog       (GtkWindow *parent_window,
+                                                       const gchar *message);
+
+/**
+ * modest_platform_run_sort_dialog:
+ * @parent_window: the parent #GtkWindow of the dialog
+ * @type: the sort dialog type.
+ * 
+ * shows a sort dialog
+ **/
+void      modest_platform_run_sort_dialog       (GtkWindow *parent_window, 
+                                                ModestSortDialogType type);
+               
+/*
+ * modest_platform_connect_and_wait:
+ * @parent_window: the parent #GtkWindow for any interactive or progress feedback UI.
+ * @return value: Whether a connection was made.
+ * 
+ * Attempts to make a connection, possibly showing interactive UI to achieve this.
+ * This will return TRUE immediately if a connection is already open.
+ * Otherwise, this function blocks until the connection attempt has either succeded or failed.
+ */            
+gboolean modest_platform_connect_and_wait (GtkWindow *parent_window);
+
+/**
+ * modest_platform_set_update_interval:
+ * @minutes: The number of minutes between updates, or 0 for no updates.
+ * 
+ * Set the number of minutes between automatic updates of email accounts.
+ * The platform will cause the send/receive action to happen repeatedly.
+ **/
+gboolean modest_platform_set_update_interval (guint minutes);
+
+/**
+ * modest_platform_get_global_settings_dialog:
+ * @void: 
+ * 
+ * returns the global settings dialog
+ * 
+ * Return value: a new #ModestGlobalSettingsDialog dialog
+ **/
+GtkWidget* modest_platform_get_global_settings_dialog (void);
+
+void modest_platform_on_new_msg (void);
+
+
+/**
+ * modest_platform_show_help:
+ * @parent_window: 
+ * @help_id: the help topic id to be shown in the help dialog
+ * 
+ * shows the application help dialog
+ **/
+void modest_platform_show_help (GtkWindow *parent_window, 
+                               const gchar *help_id);
+
+/**
+ * modest_platform_show_search_messages:
+ * @parent_window: window the dialog will be child of
+ *
+ * shows the search messages dialog
+ **/
+void modest_platform_show_search_messages (GtkWindow *parent_window);
+
+G_END_DECLS
+
 #endif /* __MODEST_PLATFORM_UTILS_H__ */