1 /* Copyright (c) 2007, Nokia Corporation
4 * Redistribution and use in source and binary forms, with or without
5 * modification, are permitted provided that the following conditions are
8 * * Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 * * Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in the
12 * documentation and/or other materials provided with the distribution.
13 * * Neither the name of the Nokia Corporation nor the names of its
14 * contributors may be used to endorse or promote products derived from
15 * this software without specific prior written permission.
17 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
18 * IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
19 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
20 * PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER
21 * OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
22 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
23 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
24 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
25 * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
26 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
27 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
30 #ifndef __LIBMODEST_DBUS_CLIENT_H__
31 #define __LIBMODEST_DBUS_CLIENT_H__
39 * libmodest_dbus_client_compose_mail:
40 * @osso_context: a valid osso_context instance
41 * @to: the To:-field of the message
42 * @cc: the Cc:-field of the message
43 * @bcc: the Bcc:-field of the message
44 * @subject: the Subject:-field of the message
45 * @body: the body (text) of the message
46 * @attachments: a list of (file://) URIs with the files to attach
48 * opens a new mail composer with the provided details filled in
50 * Returns: TRUE upon success, FALSE otherwise
52 gboolean libmodest_dbus_client_compose_mail (osso_context_t *osso_context, const gchar *to,
53 const gchar *cc, const gchar *bcc, const gchar* subject,
58 * libmodest_dbus_client_mail_to:
59 * @osso_context: a valid osso_context instance
60 * @mailto_uri: a 'mailto:foo@bar.cuux' URI
62 * opens a new mail composer with the provided details filled in,
63 * based on a mailto: string. apart from the To:-field (the first arg),
64 * also, cc, bcc, subject and body are supported, ie. "mailto:foo@bar.cuu?subject=test"
66 * Returns: TRUE upon success, FALSE otherwise
68 gboolean libmodest_dbus_client_mail_to (osso_context_t *osso_context,
69 const gchar *mailto_uri);
73 * libmodest_dbus_client_open_message:
74 * @osso_context: a valid osso_context instance
75 * @mail_uri: the unique URI referring to some message
77 * opens an existing message based on its URI; these URIs are unique pointers
78 * to some message, and are retrieved from modest.
80 * Returns: TRUE upon success, FALSE otherwise
82 gboolean libmodest_dbus_client_open_message (osso_context_t *osso_context,
83 const gchar *mail_uri);
87 * libmodest_dbus_client_send_and_receive:
88 * @osso_context: a valid osso_context instance
90 * send/receive messages
92 * Returns: TRUE upon success, FALSE otherwise
94 gboolean libmodest_dbus_client_send_and_receive (osso_context_t *osso_context);
99 * libmodest_dbus_client_open_default_inbox:
100 * @osso_context: a valid osso_context instance
102 * start modest, and open the inbox for the default account
104 * Returns: TRUE upon success, FALSE otherwise
106 gboolean libmodest_dbus_client_open_default_inbox (osso_context_t *osso_context);
111 * below: functions specific to osso-global-search; not useful for other clients.
117 MODEST_DBUS_SEARCH_SUBJECT = (1 << 0),
118 MODEST_DBUS_SEARCH_SENDER = (1 << 1),
119 MODEST_DBUS_SEARCH_RECIPIENT = (1 << 2),
120 MODEST_DBUS_SEARCH_SIZE = (1 << 3),
121 MODEST_DBUS_SEARCH_BODY = (1 << 6)
123 } ModestDBusSearchFlags;
126 gchar *msgid; /* E.g. the URI of the message. */
128 gchar *folder; /* The name, not the URI. */
131 gboolean has_attachment;
137 void modest_search_hit_list_free (GList *hits);
140 gboolean libmodest_dbus_client_search (osso_context_t *osso_ctx,
146 ModestDBusSearchFlags flags,
149 gboolean libmodest_dbus_client_delete_message (osso_context_t *osso_ctx,
150 const char *msg_uri);
156 } ModestFolderResult;
158 gboolean libmodest_dbus_client_get_folders (osso_context_t *osso_ctx, GList **folders);
160 void modest_folder_result_list_free (GList *folders);
164 #endif /* __LIBMODEST_DBUS_CLIENT_H__ */