X-Git-Url: http://git.maemo.org/git/?p=modest;a=blobdiff_plain;f=src%2Fmodest-runtime.h;h=5726a3d7768b448673fe577d6f1185fb40e1d339;hp=9097eb41183f88da0f330c9e758f64cd8609f21f;hb=5d2de21f1b0aa7aa9dee5321acf6edb9b089dd5e;hpb=8dd32612f91e282c5f67019dd0bfbd35833fe57b diff --git a/src/modest-runtime.h b/src/modest-runtime.h index 9097eb4..5726a3d 100644 --- a/src/modest-runtime.h +++ b/src/modest-runtime.h @@ -35,9 +35,13 @@ #include #include #include +#include #include #include -#include +#include +#include +#include +#include "widgets/modest-window-mgr.h" G_BEGIN_DECLS @@ -46,9 +50,10 @@ G_BEGIN_DECLS typedef enum { MODEST_RUNTIME_DEBUG_ABORT_ON_WARNING = 1 << 0, MODEST_RUNTIME_DEBUG_LOG_ACTIONS = 1 << 1, /* not in use atm */ - MODEST_RUNTIME_DEBUG_DEBUG_OBJECTS = 1 << 2, /* for g_type_init */ - MODEST_RUNTIME_DEBUG_DEBUG_SIGNALS = 1 << 3, /* for g_type_init */ + MODEST_RUNTIME_DEBUG_OBJECTS = 1 << 2, /* for g_type_init */ + MODEST_RUNTIME_DEBUG_SIGNALS = 1 << 3, /* for g_type_init */ MODEST_RUNTIME_DEBUG_FACTORY_SETTINGS = 1 << 4, /* reset to factory defaults */ + MODEST_RUNTIME_DEBUG_CODE = 1 << 5 /* print various debugging messages */ } ModestRuntimeDebugFlags; /** @@ -65,18 +70,6 @@ gboolean modest_runtime_init (void); /** - * modest_runtime_init_ui: - * @argc: the #argc argument to the main function - * @argv: the #argv argument to the main function - * - * initialize the modest UI; this replaces the call to - * gtk_init - * - * TRUE if this succeeded, FALSE otherwise. - */ -gboolean modest_runtime_init_ui (gint argc, gchar** argv); - -/** * modest_runtime_uinit: * * uninitialize the modest runtime system; free all the @@ -85,7 +78,7 @@ gboolean modest_runtime_init_ui (gint argc, gchar** argv); * TRUE if this succeeded, FALSE otherwise */ gboolean modest_runtime_uninit (void); - + /** * modest_runtime_get_debug_flags @@ -96,11 +89,10 @@ gboolean modest_runtime_uninit (void); * - "abort-on-warning": abort the program when a gtk/glib/.. warning occurs. * useful when running in debugger * - "log-actions": log user actions (not in use atm) - * - "track-object": track the use of (g)objects in the program. this option influences + * - "debug-objects": track the use of (g)objects in the program. this option influences * g_type_init_with_debug_flags - * - "track-signals": track the use of (g)signals in the program. this option influences + * - "debug-signals": track the use of (g)signals in the program. this option influences * g_type_init_with_debug_flags - * - "disable-cache": disable caching of strings and pixbuf * if you would want to track signals and log actions, you could do something like: * MODEST_DEBUG="log-actions:track-signals" ./modest * NOTE that the flags will stay the same during the run of the program, even @@ -115,7 +107,7 @@ ModestRuntimeDebugFlags modest_runtime_get_debug_flags (void) G_GNUC_CONST; * * get the ModestConf singleton instance * - * Returns: the ModestConf singleton + * Returns: the ModestConf singleton. This should NOT be unref'd. **/ ModestConf* modest_runtime_get_conf (void); @@ -125,16 +117,25 @@ ModestConf* modest_runtime_get_conf (void); * * get the ModestAccountMgr singleton instance * - * Returns: the ModestAccountMgr singleton + * Returns: the ModestAccountMgr singleton. This should NOT be unref'd. **/ ModestAccountMgr* modest_runtime_get_account_mgr (void); /** + * modest_runtime_get_email_clipboard: + * + * get the #ModestEmailClipboard singleton instance + * + * Returns: the #ModestEamilClipboard singleton. This should NOT be unref'd. + **/ +ModestEmailClipboard* modest_runtime_get_email_clipboard (void); + +/** * modest_runtime_get_account_store: * * get the ModestTnyAccountStore singleton instance * - * Returns: the ModestTnyAccountStore singleton + * Returns: the ModestTnyAccountStore singleton. This should NOT be unref'd. **/ ModestTnyAccountStore* modest_runtime_get_account_store (void); @@ -144,29 +145,81 @@ ModestTnyAccountStore* modest_runtime_get_account_store (void); * * get the ModestCacheMgr singleton instance * - * Returns: the ModestCacheMgr singleton + * Returns: the #ModestCacheMgr singleton. This should NOT be unref'd. **/ ModestCacheMgr* modest_runtime_get_cache_mgr (void); + +/** + * modest_runtime_get_device: + * + * get the #TnyDevice singleton instance + * + * Returns: the #TnyDevice singleton. This should NOT be unref'd. + **/ +TnyDevice* modest_runtime_get_device (void); + + +/** + * modest_runtime_get_platform_factory: + * + * get the #TnyPlatformFactory singleton instance + * + * Returns: the #TnyPlatformFactory singleton. This should NOT be unref'd. + **/ +TnyPlatformFactory* modest_runtime_get_platform_factory (void); + + + + /** * modest_runtime_get_mail_operation_queue: * - * get the ModestMailOperationQueue singleton instance + * get the #ModestMailOperationQueue singleton instance * - * Returns: the ModestMailOperationQueue singleton + * Returns: the #ModestMailOperationQueue singleton. This should NOT be unref'd. **/ ModestMailOperationQueue* modest_runtime_get_mail_operation_queue (void); /** - * modest_runtime_get_widget_factory + * modest_runtime_get_send_queue: + * @account: a valid TnyTransportAccount + * @create: whether or not a new send queue should be created if it does not exist + * + * get the send queue for the given account + * + * Returns: the #ModestTnySendQueue singleton instance for this account + * (ie., one singleton per account). This should NOT be unref'd. + **/ +ModestTnySendQueue* modest_runtime_get_send_queue (TnyTransportAccount *account, + gboolean create); + +/** + * modest_runtime_remove_send_queue: + * @account: a #TnyTransportAccount + * + * Removes the send queue associated with the given transport account + **/ +void modest_runtime_remove_send_queue (TnyTransportAccount *account); + +/** + * modest_runtime_remove_all_send_queues: * - * get the ModestWidgetFactory singleton instance + * Removes all send queues, ready for them to be recreated, for instance + * with a new connection. + **/ +void modest_runtime_remove_all_send_queues (); + +/** + * modest_runtime_get_window_mgr: + * + * get the #ModestWindowMgr singleton instance * - * Returns: the ModestCacheMgr singleton + * Returns: the #ModestWindowMgr singleton. This should NOT be unref'd. **/ -ModestWidgetFactory* modest_runtime_get_widget_factory (void); +ModestWindowMgr* modest_runtime_get_window_mgr (void); G_END_DECLS