X-Git-Url: http://git.maemo.org/git/?p=modest;a=blobdiff_plain;f=src%2Fmodest-platform.h;h=b7fd3f02e86d9d741f501a102cf4626dcd720ca9;hp=cf171161e7650e6dc6c079dd52d0b198f17ab7c6;hb=e61d161744d31c7799d1a7b5246b53a7a03d9ea5;hpb=d7a668c4c7f0f1a4468bbab754819d0bfd930977 diff --git a/src/modest-platform.h b/src/modest-platform.h index cf17116..b7fd3f0 100644 --- a/src/modest-platform.h +++ b/src/modest-platform.h @@ -51,8 +51,8 @@ typedef enum _ModestSortDialogType { * * Returns: TRUE if succeeded, FALSE otherwise */ -gboolean modest_platform_init (void); - +gboolean modest_platform_init (int argc, char *argv[]); + /** * modest_platform_get_new_device: @@ -151,6 +151,23 @@ gint modest_platform_run_new_folder_dialog (GtkWindow *parent_window gchar **folder_name); /** + * modest_platform_run_rename_folder_dialog: + * @parent_window: a #GtkWindow + * @parent: the parent of the folder + * @suggested_name: current name of the folder + * @folder_name: the new folder name selected by the user for the folder + * + * runs a "rename folder" confirmation dialog. 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_rename_folder_dialog (GtkWindow *parent_window, + TnyFolderStore *parent, + const gchar *current_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 @@ -162,6 +179,18 @@ gint modest_platform_run_new_folder_dialog (GtkWindow *parent_window gint modest_platform_run_confirmation_dialog (GtkWindow *parent_window, const gchar *message); +/** + * modest_platform_run_yes_no_dialog: + * @parent_window: the parent #GtkWindow of the dialog + * @message: the message to show to the user + * + * runs a dialog that offers yes and no buttons. + * + * Returns: GTK_RESPONSE_YES or GTK_RESPONSE_NO + **/ +gint modest_platform_run_yes_no_dialog (GtkWindow *parent_window, + const gchar *message); + /** * modest_platform_run_information_dialog: @@ -186,13 +215,46 @@ void modest_platform_run_sort_dialog (GtkWindow *parent_window, /* * modest_platform_connect_and_wait: * @parent_window: the parent #GtkWindow for any interactive or progress feedback UI. + * @account: The account to be used. * @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. + * This also sets the account to online, if it is a store account, in case it has been set to offline mode. */ -gboolean modest_platform_connect_and_wait (GtkWindow *parent_window); +gboolean modest_platform_connect_and_wait (GtkWindow *parent_window, TnyAccount *account); + + +/* + * modest_platform_connect_and_wait_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. + * @return value: Whether a connection was made. Also returns TRUE if no connection is necessary. + * + * Like modest_platform_connect_and_wait(), but only attempts to make a connection if the + * account uses the network. For instance, this just returns TRUE for local maildir accounts. + */ +gboolean modest_platform_connect_and_wait_if_network_account (GtkWindow *parent_window, TnyAccount *account); + +/* + * modest_platform_connect_and_wait_if_network_account: + * @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. + * @return value: Whether a connection was made. Also returns TRUE if no connection is necessary. + * + * Like modest_platform_connect_and_wait(), but only attempts to make a connection if the + * folder store uses the network. For instance, this just returns TRUE for local maildir folders. + */ +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: @@ -213,8 +275,14 @@ gboolean modest_platform_set_update_interval (guint minutes); **/ GtkWidget* modest_platform_get_global_settings_dialog (void); -void modest_platform_on_new_msg (void); - +/** + * modest_platform_on_new_headers_received: + * @header_list: the list of new received headers + * + * 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); /** * modest_platform_show_help: @@ -227,6 +295,17 @@ void modest_platform_show_help (GtkWindow *parent_window, const gchar *help_id); /** + * modest_platform_set_dialog_help: + * @dialog: a #GtkDialog + * @help_id: the help topic id to be shown on requesting + * help in the dialog + * + * attachs a help topic to the dialog + **/ +void modest_platform_set_dialog_help (GtkDialog *parent_window, + const gchar *help_id); + +/** * modest_platform_show_search_messages: * @parent_window: window the dialog will be child of * @@ -249,6 +328,58 @@ void modest_platform_information_banner (GtkWidget *widget, const gchar *icon_name, const gchar *text); +GtkWidget * +modest_platform_animation_banner (GtkWidget *parent, + const gchar *annimation_name, + const gchar *text); + +/* TODO: This isn't platform-dependent, so this isn't the best place for this. */ +/* Return TRUE immediately if the account is already online, + * otherwise check every second for NUMBER_OF_TRIES seconds and return TRUE as + * soon as the account is online, or FALSE if the account does + * not become online in the NUMBER_OF_TRIES seconds. + * This is useful when the D-Bus method was run immediately after + * the application was started (when using D-Bus activation), + * because the account usually takes a short time to go online. + * The return value is maybe not very useful. + */ +gboolean modest_platform_check_and_wait_for_account_is_online(TnyAccount *account); + + + +/** + * modest_platform_run_certificate_confirmation_dialog: + * @server_name: name of the server we get this dialog for + * @certificate: the text representation of the certificate + * + * show the unknown-certificate confirmation dialog + * + * Returns: TRUE (Ok-pressed) or FALSE (cancel pressed) + **/ +gboolean modest_platform_run_certificate_confirmation_dialog (const gchar* server_name, + const gchar *certificate); + + +/** + * modest_platform_run_alert_dialog: + * @prompt: prompt for the dialog + * @is_question: is it a question dialog? + * + * show the alert dialog for TnyAlerts + * if it's a aquest + * + * Returns: TRUE (Ok-pressed) or FALSE (cancel pressed) + **/ +gboolean modest_platform_run_alert_dialog (const gchar* prompt, gboolean is_question); + + +/** + * modest_platform_remove_new_mail_notifications: + * + * Removes all the active new mail notifications + **/ +void modest_platform_remove_new_mail_notifications (void); + G_END_DECLS #endif /* __MODEST_PLATFORM_UTILS_H__ */