X-Git-Url: http://git.maemo.org/git/?a=blobdiff_plain;f=src%2Fmodest-platform.h;h=0bb795281f9870e840b61775597f952a7d593771;hb=6aa04a4745825df25bc83dcccc764acce2803f5f;hp=f839513e2cb4d9bac31c5aeae93302aa81a949f4;hpb=6754695adb4d12d3c2db5f7f819d2d7a78c07334;p=modest diff --git a/src/modest-platform.h b/src/modest-platform.h index f839513..0bb7952 100644 --- a/src/modest-platform.h +++ b/src/modest-platform.h @@ -30,9 +30,18 @@ #ifndef __MODEST_PLATFORM_H__ #define __MODEST_PLATFORM_H__ -#include -#include #include +#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: @@ -74,6 +83,37 @@ gchar* modest_platform_get_file_icon_name (const gchar* name, const gchar* mime 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 * @@ -82,5 +122,125 @@ gchar* modest_platform_get_file_icon_name (const gchar* name, const gchar* mime GdkPixbuf* modest_platform_get_icon (const gchar *name); +/** + * modest_platform_get_app_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); + +/** + * modest_platform_show_addressbook: + * @parent_window: window the dialog will be child of + * + * shows the addressbook + **/ +void modest_platform_show_addressbook (GtkWindow *parent_window); + +G_END_DECLS #endif /* __MODEST_PLATFORM_UTILS_H__ */