X-Git-Url: http://git.maemo.org/git/?p=modest;a=blobdiff_plain;f=src%2Fmodest-platform.h;h=a4cb41101273d08214c1ebae29f0b850cb3fc803;hp=745dd5fe6bf19214b9a39966304357d51068c6f8;hb=7b18df5711ee7782411329e8a47d1d573d898136;hpb=b8c8bac0fa5a04c1cac1c04198e88a312adf200c diff --git a/src/modest-platform.h b/src/modest-platform.h index 745dd5f..a4cb411 100644 --- a/src/modest-platform.h +++ b/src/modest-platform.h @@ -44,6 +44,11 @@ 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: * @@ -127,10 +132,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 +195,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 @@ -206,11 +230,13 @@ 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: @@ -259,14 +285,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. * @@ -286,13 +304,23 @@ 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 * * 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 +355,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 +408,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 @@ -394,8 +429,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 @@ -407,41 +449,62 @@ 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); /* - * modest_platform_connect_and_perform_if_network_account: + * modest_platform_connect_if_remote_and_perform: * @parent_window: the parent #GtkWindow for any interactive or progress feedback UI. - * @account: The account that might need a connection in subsequent operations. + * @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 * @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. + * folder store uses the network. For instance, this just returns for local maildir folders. It + * will in that case synchronously and instantly perform the @callback */ -void modest_platform_connect_and_perform_if_network_account (GtkWindow *parent_window, - TnyAccount *account, - ModestConnectedPerformer callback, - gpointer user_data); - +void modest_platform_connect_if_remote_and_perform (GtkWindow *parent_window, + gboolean force, + TnyFolderStore *folder_store, + ModestConnectedPerformer callback, + gpointer user_data); + /* - * modest_platform_connect_and_perform_if_network_folderstore: + * 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 - * @user_data: user data for @callback + * @info: * - * 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 */ -void modest_platform_connect_and_perform_if_network_folderstore (GtkWindow *parent_window, - TnyFolderStore *folder_store, - ModestConnectedPerformer callback, - gpointer user_data); +void modest_platform_double_connect_and_perform (GtkWindow *parent_window, + gboolean force, + TnyFolderStore *folder_store, + DoubleConnectionInfo *info); + +/** + * 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 (); + +ModestConnectedVia modest_platform_get_current_connection (void); G_END_DECLS