2011-04-30 [colin] 3.7.9cvs18
[claws.git] / src / mimeview.h
1 /*
2  * Sylpheed -- a GTK+ based, lightweight, and fast e-mail client
3  * Copyright (C) 1999-2011 Hiroyuki Yamamoto and the Claws Mail team
4  *
5  * This program is free software; you can redistribute it and/or modify
6  * it under the terms of the GNU General Public License as published by
7  * the Free Software Foundation; either version 3 of the License, or
8  * (at your option) any later version.
9  *
10  * This program is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13  * GNU General Public License for more details.
14  *
15  * You should have received a copy of the GNU General Public License
16  * along with this program. If not, see <http://www.gnu.org/licenses/>.
17  * 
18  */
19
20 #ifndef MIMEVIEW_H
21 #define MIMEVIEW_H
22
23 typedef struct _MimeView                MimeView;
24 typedef struct _MimeViewerFactory       MimeViewerFactory;
25 typedef struct _MimeViewer              MimeViewer;
26
27 #include <glib.h>
28 #include <gdk/gdk.h>
29 #include <gtk/gtk.h>
30 #include "gtk/gtksctree.h"
31 #ifdef USE_PTHREAD
32 #include <pthread.h>
33 #endif
34
35 #include "textview.h"
36 #include "messageview.h"
37 #include "procmime.h"
38 #include "noticeview.h"
39
40 typedef enum
41 {
42         MIMEVIEW_TEXT,
43         MIMEVIEW_VIEWER
44 } MimeViewType;
45
46 #ifdef USE_PTHREAD
47 typedef struct _SigCheckData SigCheckData;
48 struct _SigCheckData
49 {
50         pthread_t th;
51         pthread_t cancel_th;
52         gboolean th_init;
53         gboolean cancel_th_init;
54
55         MimeInfo *siginfo;
56         gboolean free_after_use;
57         gboolean destroy_mimeview;
58         gboolean timeout;
59 };
60 #endif
61
62 struct _MimeView
63 {
64         GtkWidget *hbox;
65         GtkWidget *paned;
66         GtkWidget *scrolledwin;
67         GtkWidget *ctree;
68         GtkWidget *mime_notebook;
69         GtkWidget *ctree_mainbox;
70         GtkWidget *icon_scroll;
71         GtkWidget *icon_vbox;
72         GtkWidget *icon_mainbox;
73         GtkWidget *mime_toggle;
74         GtkWidget *scrollbutton;
75         MimeViewType type;
76         gboolean ctree_mode;
77
78         GtkWidget *popupmenu;
79
80         GtkCMCTreeNode *opened;
81
82         TextView *textview;
83         MimeViewer *mimeviewer;
84
85         MessageView *messageview;
86
87         MimeInfo *mimeinfo;
88
89         gchar *file;
90
91         GSList *viewers;
92
93         GtkTargetList *target_list; /* DnD */
94
95         gint icon_count;
96         MainWindow *mainwin;
97 #if !GTK_CHECK_VERSION(2,12,0)
98         GtkTooltips *tooltips;
99 #endif
100         gint oldsize;
101
102         NoticeView *siginfoview;
103         MimeInfo *siginfo;
104         MimeInfo *spec_part;
105         GtkUIManager *ui_manager;
106         GtkActionGroup *action_group;
107 #ifdef USE_PTHREAD
108         SigCheckData *check_data;
109 #endif
110 };
111
112 struct _MimeViewerFactory
113 {
114         /**
115          * Array of supported content types.
116          * Must be NULL terminated and lower case
117          */
118         gchar **content_types;
119         gint priority;
120         
121         MimeViewer *(*create_viewer) (void);
122 };
123
124 struct _MimeViewer
125 {
126         MimeViewerFactory *factory;
127         
128         GtkWidget       *(*get_widget)          (MimeViewer *);
129         void            (*show_mimepart)        (MimeViewer *, const gchar *infile, MimeInfo *);
130         void            (*clear_viewer)         (MimeViewer *);
131         void            (*destroy_viewer)       (MimeViewer *);
132         gchar           *(*get_selection)       (MimeViewer *);
133         gboolean        (*scroll_page)          (MimeViewer *, gboolean up);
134         void            (*scroll_one_line)      (MimeViewer *, gboolean up);
135         gboolean        (*text_search)          (MimeViewer *, gboolean backward,
136                                                  const gchar *str, 
137                                                  gboolean case_sensitive);
138         void            (*print)                (MimeViewer *);
139         MimeView        *mimeview;
140 };
141
142 #ifdef __cplusplus
143 extern "C" {
144 #endif /* __cplusplus */
145
146
147 MimeView *mimeview_create       (MainWindow     *mainwin);
148 void mimeview_init              (MimeView       *mimeview);
149 void mimeview_show_message      (MimeView       *mimeview,
150                                  MimeInfo       *mimeinfo,
151                                  const gchar    *file);
152 gboolean mimeview_show_part     (MimeView       *mimeview, 
153                                  MimeInfo       *partinfo);
154 void mimeview_destroy           (MimeView       *mimeview);
155 void mimeview_update            (MimeView       *mimeview);
156 void mimeview_clear             (MimeView       *mimeview);
157
158 MimeInfo *mimeview_get_selected_part    (MimeView       *mimeview);
159
160 void mimeview_pass_key_press_event      (MimeView       *mimeview,
161                                          GdkEventKey    *event);
162
163 void mimeview_register_viewer_factory   (MimeViewerFactory *factory);
164 void mimeview_unregister_viewer_factory (MimeViewerFactory *factory);
165 void mimeview_handle_cmd                (MimeView       *mimeview, 
166                                          const gchar    *cmd,
167                                          GdkEventButton *event,
168                                          gpointer        data);
169 void mimeview_select_mimepart_icon      (MimeView       *mimeview, 
170                                          MimeInfo       *partinfo);
171 gboolean mimeview_scroll_page           (MimeView       *mimeview, 
172                                          gboolean        up);
173 void mimeview_scroll_one_line           (MimeView       *mimeview, 
174                                          gboolean        up);
175 gint mimeview_get_selected_part_num     (MimeView       *mimeview);
176 void mimeview_select_part_num           (MimeView       *mimeview, 
177                                          gint            i);
178 gboolean mimeview_has_viewer_for_content_type
179                                         (MimeView       *mimeview,
180                                          const gchar    *content_type);
181
182 #ifdef __cplusplus
183 }
184 #endif /* __cplusplus */
185
186 #endif /* __MIMEVIEW_H__ */