X-Git-Url: http://git.maemo.org/git/?a=blobdiff_plain;f=src%2Fmodest-tny-folder.h;h=c271ccc50002fc07194c67f79bd3aed8797a34a2;hb=f361b7f11553fc0d6a1b27c043d23b1aca1a7f06;hp=0ace9ac7b4707ab81d825cb806f57b1a15a50ac5;hpb=d2ccacc82b0f9d49e38cccb7aa227e31e7f29995;p=modest diff --git a/src/modest-tny-folder.h b/src/modest-tny-folder.h index 0ace9ac..c271ccc 100644 --- a/src/modest-tny-folder.h +++ b/src/modest-tny-folder.h @@ -35,28 +35,31 @@ #define __MODEST_TNY_FOLDER_H__ #include +#include G_BEGIN_DECLS -typedef enum { - MODEST_FOLDER_RULES_FOLDER_READ_ONLY = 0 << 1, - MODEST_FOLDER_RULES_FOLDER_DELETABLE -} ModestTnyFolderRules; +/* TODO: move this to tinymail */ +#define TNY_FOLDER_TYPE_INVALID -1 typedef enum { - MODEST_LOCAL_FOLDER_TYPE_UNKNOWN, - - MODEST_LOCAL_FOLDER_TYPE_DRAFTS, - MODEST_LOCAL_FOLDER_TYPE_SENT, - MODEST_LOCAL_FOLDER_TYPE_OUTBOX, - MODEST_LOCAL_FOLDER_TYPE_ARCHIVE, - MODEST_LOCAL_FOLDER_TYPE_JUNK, - MODEST_LOCAL_FOLDER_TYPE_TRASH, - - MODEST_LOCAL_FOLDER_TYPE_NUM -} ModestLocalFolderType; - + MODEST_FOLDER_RULES_FOLDER_NON_WRITEABLE = 1 << 1, + MODEST_FOLDER_RULES_FOLDER_NON_DELETABLE = 1 << 2, + MODEST_FOLDER_RULES_FOLDER_NON_MOVEABLE = 1 << 3, + MODEST_FOLDER_RULES_FOLDER_NON_RENAMEABLE = 1 << 4, +} ModestTnyFolderRules; +/** Note: This is not a derived TnyFolder type. These are just convenience + * functions for working with a TnyFolder. tinymail does not seem to offer any + * easy way to cause derived TnyFolders to be instantiated. + */ + +/* TODO: These "const TnyFolder*" arguments will eventually need to + * be "TnyFolder*". C cannot support constness for complex objects like C++ + * can, because it lacks the mutable keyword and doesn't allow both const + * and non-const get function overloads. + */ + /** * modest_tny_folder_guess_type: * @folder: a valid tnymail folder @@ -69,19 +72,49 @@ typedef enum { */ TnyFolderType modest_tny_folder_guess_folder_type (const TnyFolder *folder); + + /** - * modest_tny_folder_guess_type_from_name: - * @folder_name: a folder name + * modest_tny_folder_is_remote_folder: + * @folder: a valid tnymail folder * - * determine the type of the folder. first, we see if tinymail - * can give a specific type. if it cannot, we try to guess the - * type, based on the name of the folder - * - * Note: this is a Class function, there does not require a tnyfolder instance + * checks if the folder is part of the "remote" account * - * Returns: the folder type, or TNY_FOLDER_TYPE_UNKNOWN + * Returns: TRUE if it's a remote folder, FALSE otherwise + */ +gboolean +modest_tny_folder_is_remote_folder (TnyFolder *folder); + +/** + * modest_tny_folder_is_local_folder: + * @folder: a valid tnymail folder + * + * checks if the folder is part of the "local folders" pseudo-account + * + * Returns: TRUE if it's a local folder, FALSE otherwise + */ +gboolean modest_tny_folder_is_local_folder (TnyFolder *folder); + +/** + * modest_tny_folder_is_memory_card_folder: + * @folder: a valid tnymail folder + * + * checks if the folder is part of the memory card account. + * + * Returns: TRUE if it's a memory card folder, FALSE otherwise + */ +gboolean +modest_tny_folder_is_memory_card_folder (TnyFolder *folder); + +/** + * modest_tny_folder_get_local_folder_type: + * @folder: a valid tnymail folder + * + * checks if the folder is part of the "local folders" pseudo-account + * + * Returns: TRUE if it's a local folder, FALSE otherwise */ -TnyFolderType modest_tny_folder_guess_folder_type_from_name (const gchar *folder_name); +TnyFolderType modest_tny_folder_get_local_or_mmc_folder_type (TnyFolder *folder); /** @@ -94,15 +127,87 @@ TnyFolderType modest_tny_folder_guess_folder_type_from_name (const gchar *fol * Returns: the ModestTnyFolderRules rules (bitwise-OR) for this * folder */ -ModestTnyFolderRules modest_tny_folder_get_rules (const TnyFolder *folder); +ModestTnyFolderRules modest_tny_folder_get_rules (TnyFolder *folder); + + +/** + * modest_tny_folder_get_help_id: + * @folder: a valid tnymail folder + * + * get the help_id for this folder + * + * Returns: get the help_id for this folder, or NULL in case of error + */ +const gchar* modest_tny_folder_get_help_id (const TnyFolder *folder); + +/** + * modest_tny_folder_is_outbox_for_account: + * @folder: a valid tnymail folder + * + * Discover whether this folder is the per-account outbox for the specified + * account. + * + * Returns: TRUE if this folder is the per-account outbox for the account. + */ +gboolean modest_tny_folder_is_outbox_for_account (TnyFolder *folder, + TnyAccount *account); + +/** + * modest_tny_folder_get_account: + * @folder: a folder + * + * Get the parent account of the folder or, for TnyMergeFolder + * instances, get the local-folders account. + * + * Returns: the account. You should call g_object_unref() on this. + */ +TnyAccount *modest_tny_folder_get_account (TnyFolder *folder); -/* some class-function (ie. don't require TnyFolder* */ -ModestLocalFolderType modest_tny_folder_get_local_folder_type (const gchar *name); -const gchar* modest_tny_folder_get_local_folder_type_name (ModestLocalFolderType type); -const gchar* modest_tny_folder_get_local_folder_type_display_name (ModestLocalFolderType type); +/** + * modest_tny_msg_get_header_unique_id: + * @header: a #TnyHeader + * + * This function returns a unique id for a message summary from + * a TnyHeader retrieved with tny_folder_get_headers. You can not use + * the TnyHeader returned by tny_msg_get_header because it has no uid. + * + * This uid is built from the folder URL string and the header uid, + * the caller of the function must free the unique id when no longer + * needed + * + * Returns: a unique identificator for a header object + **/ +gchar* modest_tny_folder_get_header_unique_id (TnyHeader *header); +/** + * modest_tny_folder_has_subfolder_with_name: + * @folder: a #TnyFolderStore + * @name: the name to check into subfolders. + * @nonstrict: if TRUE, also match on different-case and current-locale + * display versions of the name + * + * This function check if subfolders of @folder has the same + * name as @name. + * + * Returns: TRUE if some subfolder has the name @name. + **/ +gboolean modest_tny_folder_has_subfolder_with_name (TnyFolderStore *folder, + const gchar *name, + gboolean nonstrict); +/** + * modest_tny_folder_is_ancestor: + * @folder: a #TnyFolder + * @ancestor: a #TnyFolderStore + * + * This function checks if @ancestor is an ancestor of @folder + * + * Returns: TRUE if @ancestor is an ancestor of @folder, FALSE + * otherwise + **/ +gboolean modest_tny_folder_is_ancestor (TnyFolder *folder, + TnyFolderStore *ancestor); G_END_DECLS