1 /* Copyright (c) 2006, 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 /* modest-tny-platform-factory.h */
32 #ifndef __MODEST_MAIL_OPERATION_QUEUE_H__
33 #define __MODEST_MAIL_OPERATION_QUEUE_H__
35 #include <glib-object.h>
36 #include "modest-mail-operation.h"
40 /* convenience macros */
41 #define MODEST_TYPE_MAIL_OPERATION_QUEUE (modest_mail_operation_queue_get_type())
42 #define MODEST_MAIL_OPERATION_QUEUE(obj) (G_TYPE_CHECK_INSTANCE_CAST((obj),MODEST_TYPE_MAIL_OPERATION_QUEUE,ModestMailOperationQueue))
43 #define MODEST_MAIL_OPERATION_QUEUE_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST((klass),MODEST_TYPE_MAIL_OPERATION_QUEUE,GObject))
44 #define MODEST_IS_MAIL_OPERATION_QUEUE(obj) (G_TYPE_CHECK_INSTANCE_TYPE((obj),MODEST_TYPE_MAIL_OPERATION_QUEUE))
45 #define MODEST_IS_MAIL_OPERATION_QUEUE_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE((klass),MODEST_TYPE_MAIL_OPERATION_QUEUE))
46 #define MODEST_MAIL_OPERATION_QUEUE_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS((obj),MODEST_TYPE_MAIL_OPERATION_QUEUE,ModestMailOperationQueueClass))
48 typedef enum _ModestMailOperationQueueNotification {
49 MODEST_MAIL_OPERATION_QUEUE_OPERATION_ADDED,
50 MODEST_MAIL_OPERATION_QUEUE_OPERATION_REMOVED
51 } ModestMailOperationQueueNotification;
53 typedef struct _ModestMailOperationQueue ModestMailOperationQueue;
54 typedef struct _ModestMailOperationQueueClass ModestMailOperationQueueClass;
56 struct _ModestMailOperationQueue {
60 struct _ModestMailOperationQueueClass {
61 GObjectClass parent_class;
64 void (*queue_changed) (ModestMailOperationQueue *self,
65 ModestMailOperation *mail_op,
66 ModestMailOperationQueueNotification type);
69 /* member functions */
70 GType modest_mail_operation_queue_get_type (void) G_GNUC_CONST;
72 ModestMailOperationQueue * modest_mail_operation_queue_new (void);
75 * modest_mail_operation_queue_add:
76 * @op_queue: a #ModestMailOperationQueue
77 * @mail_op: the #ModestMailOperation that will be added to the queue
79 * Adds a mail operation at the end of the queue. It also adds a
80 * reference to the mail operation so the caller could free it
82 void modest_mail_operation_queue_add (ModestMailOperationQueue *op_queue,
83 ModestMailOperation *mail_op);
86 * modest_mail_operation_queue_remove:
87 * @op_queue: a #ModestMailOperationQueue
88 * @mail_op: the #ModestMailOperation that will be removed from the queue
90 * Removes a mail operation from the queue. This method does not free
93 void modest_mail_operation_queue_remove (ModestMailOperationQueue *op_queue,
94 ModestMailOperation *mail_op);
96 * modest_mail_operation_queue_num_elements:
97 * @op_queue: a #ModestMailOperationQueue
99 * Gets the numeber of elements stored in #ModestMailOperationQueue.
102 modest_mail_operation_queue_num_elements (ModestMailOperationQueue *self);
105 * modest_mail_operation_queue_cancel:
106 * @op_queue: a #ModestMailOperationQueue
107 * @mail_op: the #ModestMailOperation that will be canceled
109 * Cancels a #ModestMailOperation if it's not finished and removes it
112 void modest_mail_operation_queue_cancel (ModestMailOperationQueue *op_queue,
113 ModestMailOperation *mail_op);
115 * modest_mail_operation_queue_cancel_all:
116 * @op_queue: a #ModestMailOperationQueue
118 * Cancels all the unfinished #ModestMailOperation of the queue
120 void modest_mail_operation_queue_cancel_all (ModestMailOperationQueue *op_queue);
124 #endif /* __MODEST_MAIL_OPERATION_QUEUE_H__ */