rework image viewer
[claws.git] / src / gtk / gtkutils.h
index 143d42c6ced41598b9906412fff28a7f875fc9f1..a8dafcba472150e93eb34dfe7c05e122b628f6df 100644 (file)
@@ -1,10 +1,10 @@
 /*
- * Sylpheed -- a GTK+ based, lightweight, and fast e-mail client
- * Copyright (C) 1999-2004 Hiroyuki Yamamoto
+ * Claws Mail -- a GTK+ based, lightweight, and fast e-mail client
+ * Copyright (C) 1999-2020 the Claws Mail team and Hiroyuki Yamamoto
  *
  * This program is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation; either version 2 of the License, or
+ * the Free Software Foundation; either version 3 of the License, or
  * (at your option) any later version.
  *
  * This program is distributed in the hope that it will be useful,
  * GNU General Public License for more details.
  *
  * You should have received a copy of the GNU General Public License
- * along with this program; if not, write to the Free Software
- * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
  */
 
 #ifndef __GTKUTILS_H__
 #define __GTKUTILS_H__
 
 #ifdef HAVE_CONFIG_H
-#  include "config.h"
+#include "claws-features.h"
 #endif
 
 #include <glib.h>
 #include <gdk/gdk.h>
-#include <gtk/gtkmain.h>
-#include <gtk/gtkwidget.h>
-#include <gtk/gtkcontainer.h>
-#include <gtk/gtkeditable.h>
-#include <gtk/gtkctree.h>
-#include <gtk/gtkcombo.h>
-#include <gtk/gtktextview.h>
-#include <gtk/gtkitemfactory.h>
+#include <gtk/gtk.h>
 #include <stdlib.h>
 #if HAVE_WCHAR_H
 #  include <wchar.h>
 #endif
 
-typedef struct _ComboButton    ComboButton;
-
-struct _ComboButton
-{
-       GtkWidget *arrow;
-       GtkWidget *button;
-       GtkWidget *menu;
-       GtkItemFactory *factory;
-       gpointer data;
-};
+#include "gtkcmctree.h"
 
 #define GTK_EVENTS_FLUSH() \
 { \
@@ -56,38 +39,21 @@ struct _ComboButton
                gtk_main_iteration(); \
 }
 
-#define PIXMAP_CREATE(widget, pixmap, mask, xpm_d) \
-{ \
-       if (!pixmap) { \
-               GtkStyle *style = gtk_widget_get_style(widget); \
-               pixmap = gdk_pixmap_create_from_xpm_d \
-                       (widget->window, &mask, \
-                        &style->bg[GTK_STATE_NORMAL], xpm_d); \
-       } \
-}
-
-#define PIXMAP_CREATE_FROM_FILE(widget, pixmap, mask, filename) \
-{ \
-       if (!pixmap) { \
-               GtkStyle *style = gtk_widget_get_style(widget); \
-               pixmap = gdk_pixmap_create_from_xpm \
-                       (widget->window, &mask, \
-                        &style->bg[GTK_STATE_NORMAL], filename); \
-       } \
-}
-
 #define GTK_WIDGET_PTR(wid)    (*(GtkWidget **)wid)
 
 #define GTKUT_CTREE_NODE_SET_ROW_DATA(node, d) \
 { \
-       GTK_CTREE_ROW(node)->row.data = d; \
+       GTK_CMCTREE_ROW(node)->row.data = d; \
 }
 
 #define GTKUT_CTREE_NODE_GET_ROW_DATA(node) \
-       (GTK_CTREE_ROW(node)->row.data)
+       (GTK_CMCTREE_ROW(node)->row.data)
 
 #define GTKUT_CTREE_REFRESH(clist) \
-       GTK_CLIST_GET_CLASS(clist)->refresh(clist)
+       GTK_CMCLIST_GET_CLASS(clist)->refresh(clist)
+
+#define GTKUT_COLOR_BUTTON() \
+       gtk_button_new_with_label("\x20\xE2\x80\x83\x20")
 
 gboolean gtkut_get_font_size           (GtkWidget      *widget,
                                         gint           *width,
@@ -95,8 +61,17 @@ gboolean gtkut_get_font_size         (GtkWidget      *widget,
 
 void gtkut_convert_int_to_gdk_color    (gint            rgbvalue,
                                         GdkColor       *color);
+gint gtkut_convert_gdk_color_to_int    (GdkColor       *color);
+
+void gtkut_stock_button_add_help(GtkWidget *bbox, GtkWidget **help_btn);
+
+void gtkut_stock_button_set_create_with_help(GtkWidget **bbox,
+               GtkWidget **help_button,
+               GtkWidget **button1, const gchar *label1,
+               GtkWidget **button2, const gchar *label2,
+               GtkWidget **button3, const gchar *label3);
 
-void gtkut_button_set_create           (GtkWidget      **bbox,
+void gtkut_stock_button_set_create     (GtkWidget      **bbox,
                                         GtkWidget      **button1,
                                         const gchar     *label1,
                                         GtkWidget      **button2,
@@ -104,53 +79,58 @@ void gtkut_button_set_create               (GtkWidget      **bbox,
                                         GtkWidget      **button3,
                                         const gchar     *label3);
 
-ComboButton *gtkut_combo_button_create (GtkWidget              *button,
-                                        GtkItemFactoryEntry    *entries,
-                                        gint                    n_entries,
-                                        const gchar            *path,
-                                        gpointer                data);
+void gtkut_stock_with_text_button_set_create(GtkWidget **bbox,
+                                  GtkWidget **button1, const gchar *label1, const gchar *text1,
+                                  GtkWidget **button2, const gchar *label2, const gchar *text2,
+                                  GtkWidget **button3, const gchar *label3, const gchar *text3);
 
 void gtkut_ctree_node_move_if_on_the_edge
-                                       (GtkCTree       *ctree,
-                                        GtkCTreeNode   *node);
-gint gtkut_ctree_get_nth_from_node     (GtkCTree       *ctree,
-                                        GtkCTreeNode   *node);
-GtkCTreeNode *gtkut_ctree_node_next    (GtkCTree       *ctree,
-                                        GtkCTreeNode   *node);
-GtkCTreeNode *gtkut_ctree_node_prev    (GtkCTree       *ctree,
-                                        GtkCTreeNode   *node);
-gboolean gtkut_ctree_node_is_selected  (GtkCTree       *ctree,
-                                        GtkCTreeNode   *node);
-GtkCTreeNode *gtkut_ctree_find_collapsed_parent
-                                       (GtkCTree       *ctree,
-                                        GtkCTreeNode   *node);
-void gtkut_ctree_expand_parent_all     (GtkCTree       *ctree,
-                                        GtkCTreeNode   *node);
-gboolean gtkut_ctree_node_is_parent    (GtkCTreeNode   *parent, 
-                                        GtkCTreeNode   *node);
-void gtkut_ctree_set_focus_row         (GtkCTree       *ctree,
-                                        GtkCTreeNode   *node);
-
-void gtkut_clist_set_focus_row         (GtkCList       *clist,
-                                        gint            row);
-
-void gtkut_combo_set_items             (GtkCombo       *combo,
-                                        const gchar    *str1, ...);
+                                       (GtkCMCTree     *ctree,
+                                        GtkCMCTreeNode *node,
+                                        gint            _row);
+gint gtkut_ctree_get_nth_from_node     (GtkCMCTree     *ctree,
+                                        GtkCMCTreeNode *node);
+GtkCMCTreeNode *gtkut_ctree_node_next  (GtkCMCTree     *ctree,
+                                        GtkCMCTreeNode *node);
+GtkCMCTreeNode *gtkut_ctree_node_prev  (GtkCMCTree     *ctree,
+                                        GtkCMCTreeNode *node);
+gboolean gtkut_ctree_node_is_selected  (GtkCMCTree     *ctree,
+                                        GtkCMCTreeNode *node);
+GtkCMCTreeNode *gtkut_ctree_find_collapsed_parent
+                                       (GtkCMCTree     *ctree,
+                                        GtkCMCTreeNode *node);
+void gtkut_ctree_expand_parent_all     (GtkCMCTree     *ctree,
+                                        GtkCMCTreeNode *node);
+gboolean gtkut_ctree_node_is_parent    (GtkCMCTreeNode         *parent, 
+                                        GtkCMCTreeNode         *node);
+void gtkut_ctree_set_focus_row         (GtkCMCTree     *ctree,
+                                        GtkCMCTreeNode *node);
 
-gchar *gtkut_editable_get_selection    (GtkEditable    *editable);
-void gtkut_editable_disable_im         (GtkEditable    *editable);
+void gtkut_clist_set_focus_row         (GtkCMCList     *clist,
+                                        gint            row);
 
 void gtkut_container_remove            (GtkContainer   *container,
                                         GtkWidget      *widget);
 
+gchar *gtkut_text_view_get_selection   (GtkTextView    *textview);
+void gtkut_text_view_set_position              (GtkTextView *text, gint pos);
+gboolean gtkut_text_view_search_string (GtkTextView *text, const gchar *str,
+                                       gboolean case_sens);
+gboolean gtkut_text_view_search_string_backward        (GtkTextView *text, const gchar *str,
+                                       gboolean case_sens);
+
+GtkWidget *label_window_create(const gchar *str);
+void label_window_destroy(GtkWidget *widget);
 
 void gtkut_window_popup                        (GtkWidget      *window);
+GtkWidget *gtkut_window_new            (GtkWindowType   type,
+                                        const gchar    *class);
+
 
 void gtkut_widget_get_uposition                (GtkWidget      *widget,
                                         gint           *px,
                                         gint           *py);
-void gtkut_widget_disable_theme_engine (GtkWidget      *widget);
-void gtkut_widget_wait_for_draw                (GtkWidget      *widget);
+void gtkut_widget_draw_now             (GtkWidget      *widget);
 void gtkut_widget_init                 (void);
 
 void gtkut_widget_set_app_icon         (GtkWidget      *widget);
@@ -163,23 +143,126 @@ GtkWidget *gtkut_account_menu_new        (GList                  *ac_list,
 void gtkut_set_widget_bgcolor_rgb      (GtkWidget      *widget,
                                         guint           rgbvalue);
 
-gboolean gtkut_text_buffer_match_string        (GtkTextBuffer  *text,
-                                        gint            pos,
-                                        gunichar       *wcs,
-                                        gint            len,
-                                        gboolean        case_sens);
-guint gtkut_text_buffer_str_compare_n  (GtkTextBuffer  *text,
-                                        guint           pos1,
-                                        guint           pos2,
-                                        guint           len,
-                                        guint           text_len);
-guint gtkut_text_buffer_str_compare    (GtkTextBuffer  *text,
-                                        guint           start_pos,
-                                        guint           text_len,
-                                        const gchar    *str);
-gboolean gtkut_text_buffer_is_uri_string(GtkTextBuffer *text,
-                                        guint           start_pos,
-                                        guint           text_len);
-gchar *gtkut_text_view_get_selection   (GtkTextView    *textview);
+void gtkut_widget_set_small_font_size(GtkWidget *widget);
+GtkWidget *gtkut_get_focused_child     (GtkContainer   *parent);
+
+GtkWidget *gtkut_get_browse_file_btn(const gchar *label);
+GtkWidget *gtkut_get_browse_directory_btn(const gchar *label);
+GtkWidget *gtkut_get_replace_btn(const gchar *label);
+GtkWidget *gtkut_get_options_frame(GtkWidget *box, GtkWidget **frame, const gchar *frame_label);
+#if HAVE_LIBCOMPFACE
+GtkWidget *xface_get_from_header(const gchar *o_xface);
+#endif
+gboolean get_tag_range(GtkTextIter *iter,
+                                      GtkTextTag *tag,
+                                      GtkTextIter *start_iter,
+                                      GtkTextIter *end_iter);
+
+GtkWidget *face_get_from_header(const gchar *o_face);
+GtkWidget *gtkut_get_link_btn(GtkWidget *window, const gchar *url, const gchar *label);
+
+GtkWidget *gtkut_sc_combobox_create(GtkWidget *eventbox, gboolean focus_on_click);
+void gtkutils_scroll_one_line  (GtkWidget *widget, 
+                                GtkAdjustment *vadj, 
+                                gboolean up);
+gboolean gtkutils_scroll_page  (GtkWidget *widget, 
+                                GtkAdjustment *vadj, 
+                                gboolean up);
+
+gboolean gtkut_tree_model_text_iter_prev(GtkTreeModel *model,
+                                GtkTreeIter *iter,
+                                const gchar* text);
+gboolean gtkut_tree_model_get_iter_last(GtkTreeModel *model,
+                                GtkTreeIter *iter);
+
+gint gtkut_list_view_get_selected_row(GtkWidget *list_view);
+gboolean gtkut_list_view_select_row(GtkWidget *list, gint row);
+
+GtkUIManager *gtkut_create_ui_manager(void);
+GtkUIManager *gtkut_ui_manager(void);
+
+GdkPixbuf *claws_load_pixbuf_fitting(GdkPixbuf *pixbuf, gboolean inline_img,
+                                    gboolean fit_img_height,
+                                    int box_width, int box_height);
+
+GtkWidget *gtkut_time_select_combo_new();
+void gtkut_time_select_select_by_time(GtkComboBox *combo, int hour, int minute);
+gboolean gtkut_time_select_get_time(GtkComboBox *combo, int *hour, int *minute);
+
+void gtk_calendar_select_today(GtkCalendar *calendar);
+
+typedef void (*ClawsIOFunc)(gpointer data, gint source, GIOCondition condition);
+gint
+claws_input_add    (gint             source,
+                   GIOCondition      condition,
+                   ClawsIOFunc       function,
+                   gpointer          data,
+                   gboolean          is_sock);
+
+#define CLAWS_SET_TIP(widget,tip) {                                            \
+       if (widget != NULL) {                                                   \
+               if (tip != NULL)                                                \
+                       gtk_widget_set_tooltip_text(GTK_WIDGET(widget), tip);   \
+               else                                                            \
+                       gtk_widget_set_has_tooltip(GTK_WIDGET(widget), FALSE);  \
+       }                                                                       \
+}
+
+#if defined USE_GNUTLS
+typedef struct _AutoConfigureData {
+       const gchar *ssl_service;
+       const gchar *tls_service;
+       gchar *address;
+       gint resolver_error;
+
+       GtkEntry *hostname_entry;
+       GtkToggleButton *set_port;
+       GtkSpinButton *port;
+       gint default_port;
+       gint default_ssl_port;
+       GtkToggleButton *tls_checkbtn;
+       GtkToggleButton *ssl_checkbtn;
+       GtkToggleButton *auth_checkbtn;
+       GtkEntry *uid_entry;
+       GtkLabel *info_label;
+       GtkButton *configure_button;
+       GtkButton *cancel_button;
+       GCancellable *cancel;
+       GMainLoop *main_loop;
+} AutoConfigureData;
+
+void auto_configure_service(AutoConfigureData *data);
+gboolean auto_configure_service_sync(const gchar *service, const gchar *domain, gchar **srvhost, guint16 *srvport);
+#endif
+
+/* Returns pointer stored in selected row of a tree view's model
+ * in a given column. The column has to be of type G_TYPE_POINTER
+ * or G_TYPE_STRING (in this case, the returned value has to be
+ * freed by the caller.
+ * _model, _selection and _iter parameters are optional, and if
+ * not NULL, they will be set to point to corresponding GtkTreeModel,
+ * GtkTreeSelection, and GtkTreeIter of the selected row. */
+gpointer gtkut_tree_view_get_selected_pointer(GtkTreeView *view,
+               gint column, GtkTreeModel **_model, GtkTreeSelection **_selection,
+               GtkTreeIter *_iter);
+
+#if GTK_CHECK_VERSION (3, 2, 0)
+#define GTK_TYPE_VBOX GTK_TYPE_BOX
+#define GtkVBox GtkBox
+#define GtkVBoxClass GtkBoxClass
+#define gtk_vbox_new(hmg,spc) g_object_new (GTK_TYPE_BOX, \
+    "homogeneous", hmg, "spacing", spc, \
+    "orientation", GTK_ORIENTATION_VERTICAL, NULL)
+#define GTK_TYPE_HBOX GTK_TYPE_BOX
+#define GtkHBox GtkBox
+#define GtkHBoxClass GtkBoxClass
+#define gtk_hbox_new(hmg,spc) g_object_new (GTK_TYPE_BOX, \
+    "homogeneous", hmg, "spacing", spc, \
+    "orientation", GTK_ORIENTATION_HORIZONTAL, NULL)
+#define gtk_hseparator_new() g_object_new (GTK_TYPE_SEPARATOR, NULL)
+#define gtk_hpaned_new() g_object_new (GTK_TYPE_PANED, NULL)
+#define gtk_vpaned_new() g_object_new (GTK_TYPE_PANED, \
+    "orientation", GTK_ORIENTATION_VERTICAL, NULL)
+#endif
 
 #endif /* __GTKUTILS_H__ */