Include a Other Software section in Help file
[geeqie.git] / src / ui_misc.h
index 6d8c12e..e1f792f 100644 (file)
@@ -1,15 +1,24 @@
 /*
- * (SLIK) SimpLIstic sKin functions
- * (C) 2004 John Ellis
+ * Copyright (C) 2004 John Ellis
+ * Copyright (C) 2008 - 2016 The Geeqie Team
  *
  * Author: John Ellis
  *
- * This software is released under the GNU General Public License (GNU GPL).
- * Please read the included file COPYING for more information.
- * This software comes with no warranty of any kind, use at your own risk!
+ * 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
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * 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.,
+ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  */
 
-
 #ifndef UI_MISC_H
 #define UI_MISC_H
 
 
 /* HIG 2.0 chapter 8 defines: */
 
-/* space between elements within control (ex: icon and it's text) */
+/**
+ * @def PREF_PAD_GAP
+ * space between elements within control (ex: icon and it's text)
+ */
 #define PREF_PAD_GAP     6
-/* space between label and control(s) */
+
+/**
+ * @def PREF_PAD_SPACE
+ * space between label and control(s)
+ */
 #define PREF_PAD_SPACE  12
-/* space between window border and controls */
+
+/**
+ * @def PREF_PAD_BORDER
+ * space between window border and controls
+ */
 #define PREF_PAD_BORDER 12
-/* indent for group members */
+
+/**
+ * @def PREF_PAD_INDENT
+ * indent for group members
+ */
 #define PREF_PAD_INDENT 12
-/* vertical space between groups */
+
+/**
+ * @def PREF_PAD_GROUP
+ * vertical space between groups
+ */
 #define PREF_PAD_GROUP  18
 
 /* HIG 2.0 chapter 3.13 defines: */
 
-/* gap between buttons in a dialog */
+/**
+ * @def PREF_PAD_BUTTON_GAP
+ * gap between buttons in a dialog
+ */
 #define PREF_PAD_BUTTON_GAP 6
-/* space between buttons in a dialog and it's contents */
+
+/**
+ * @def PREF_PAD_BUTTON_SPACE
+ * space between buttons in a dialog and it's contents
+ */
 #define PREF_PAD_BUTTON_SPACE 24
 
 /* and these are not in the GNOME HIG */
 
-/* gap between similar toolbar items (buttons) */
+/**
+ * @def PREF_PAD_TOOLBAR_GAP
+ * gap between similar toolbar items (buttons)
+ */
 #define PREF_PAD_TOOLBAR_GAP 0
 
-/* HIG 2.0 states 6 pixels between icons and text,
+/**
+ * @def PREF_PAD_BUTTON_ICON_GAP
+ * HIG 2.0 states 6 pixels between icons and text,
  * but GTK's stock buttons ignore this (hard coded to 2), we do it too for consistency
  */
 #define PREF_PAD_BUTTON_ICON_GAP 2
 
 
-GtkWidget *pref_box_new(GtkWidget *parent_box, gint fill,
-                       GtkOrientation orientation, gint padding);
+GtkWidget *pref_box_new(GtkWidget *parent_box, gboolean fill,
+                       GtkOrientation orientation, gboolean padding);
 
-GtkWidget *pref_group_new(GtkWidget *parent_box, gint fill,
+GtkWidget *pref_group_new(GtkWidget *parent_box, gboolean fill,
                          const gchar *text, GtkOrientation orientation);
 GtkWidget *pref_group_parent(GtkWidget *child);
 
-GtkWidget *pref_frame_new(GtkWidget *parent_box, gint fill,
+GtkWidget *pref_frame_new(GtkWidget *parent_box, gboolean fill,
                          const gchar *text,
-                         GtkOrientation orientation, gint padding);
+                         GtkOrientation orientation, gboolean padding);
 
-GtkWidget *pref_spacer(GtkWidget *parent_box, gint padding);
-GtkWidget *pref_line(GtkWidget *parent_box, gint padding);
+GtkWidget *pref_spacer(GtkWidget *parent_box, gboolean padding);
+GtkWidget *pref_line(GtkWidget *parent_box, gboolean padding);
 
 GtkWidget *pref_label_new(GtkWidget *parent_box, const gchar *text);
 GtkWidget *pref_label_new_mnemonic(GtkWidget *parent_box, const gchar *text, GtkWidget *widget);
-void pref_label_bold(GtkWidget *label, gint bold, gint increase_size);
+void pref_label_bold(GtkWidget *label, gboolean bold, gboolean increase_size);
 
 GtkWidget *pref_button_new(GtkWidget *parent_box, const gchar *stock_id,
-                          const gchar *text, gint hide_stock_text,
+                          const gchar *text, gboolean hide_stock_text,
                           GCallback func, gpointer data);
 
-GtkWidget *pref_checkbox_new(GtkWidget *parent_box, const gchar *text, gint active,
+GtkWidget *pref_checkbox_new(GtkWidget *parent_box, const gchar *text, gboolean active,
                             GCallback func, gpointer data);
-GtkWidget *pref_checkbox_new_mnemonic(GtkWidget *parent_box, const gchar *text, gint active,
+GtkWidget *pref_checkbox_new_mnemonic(GtkWidget *parent_box, const gchar *text, gboolean active,
                                      GCallback func, gpointer data);
 
-GtkWidget *pref_checkbox_new_int(GtkWidget *parent_box, const gchar *text, gint active,
-                                gint *result);
+GtkWidget *pref_checkbox_new_int(GtkWidget *parent_box, const gchar *text, gboolean active,
+                                gboolean *result);
 
 void pref_checkbox_link_sensitivity(GtkWidget *button, GtkWidget *widget);
 void pref_checkbox_link_sensitivity_swap(GtkWidget *button, GtkWidget *widget);
 
 GtkWidget *pref_radiobutton_new(GtkWidget *parent_box, GtkWidget *sibling,
-                               const gchar *text, gint active,
+                               const gchar *text, gboolean active,
                                GCallback func, gpointer data);
 GtkWidget *pref_radiobutton_new_mnemonic(GtkWidget *parent_box, GtkWidget *sibling,
-                                        const gchar *text, gint active,
+                                        const gchar *text, gboolean active,
                                         GCallback func, gpointer data);
 
 GtkWidget *pref_radiobutton_new_int(GtkWidget *parent_box, GtkWidget *sibling,
-                                   const gchar *text, gint active,
-                                   gint *result, gint value,
+                                   const gchar *text, gboolean active,
+                                   gboolean *result, gboolean value,
                                    GCallback func, gpointer data);
 
 GtkWidget *pref_spin_new(GtkWidget *parent_box, const gchar *text, const gchar *suffix,
@@ -117,7 +157,7 @@ void pref_signal_unblock_data(GtkWidget *widget, gpointer data);
 
 
 GtkWidget *pref_table_new(GtkWidget *parent_box, gint columns, gint rows,
-                         gint homogenious, gint fill);
+                         gboolean homegeneous, gboolean fill);
 
 GtkWidget *pref_table_box(GtkWidget *table, gint column, gint row,
                          GtkOrientation orientation, const gchar *text);
@@ -126,7 +166,7 @@ GtkWidget *pref_table_label(GtkWidget *table, gint column, gint row,
                            const gchar *text, gfloat alignment);
 
 GtkWidget *pref_table_button(GtkWidget *table, gint column, gint row,
-                            const gchar *stock_id, const gchar *text, gint hide_stock_text,
+                            const gchar *stock_id, const gchar *text, gboolean hide_stock_text,
                             GCallback func, gpointer data);
 
 GtkWidget *pref_table_spin(GtkWidget *table, gint column, gint row,
@@ -135,10 +175,15 @@ GtkWidget *pref_table_spin(GtkWidget *table, gint column, gint row,
                           gdouble value,
                           GCallback func, gpointer data);
 
+GtkWidget *pref_table_spin_new_int(GtkWidget *table, gint column, gint row,
+                                  const gchar *text, const gchar *suffix,
+                                  gint min, gint max, gint step,
+                                  gint value, gint *value_var);
+
 
 GtkWidget *pref_toolbar_new(GtkWidget *parent_box, GtkToolbarStyle style);
 GtkWidget *pref_toolbar_button(GtkWidget *toolbar,
-                              const gchar *stock_id, const gchar *label, gint toggle,
+                              const gchar *stock_id, const gchar *label, gboolean toggle,
                               const gchar *description,
                               GCallback func, gpointer data);
 void pref_toolbar_button_set_icon(GtkWidget *button, GtkWidget *widget, const gchar *stock_id);
@@ -165,25 +210,28 @@ GtkWidget *sizer_new(GtkWidget *parent, GtkWidget *bounding_widget,
                     SizerPositionType position);
 
 void sizer_set_limits(GtkWidget *sizer,
-                      gint hsize_min, gint hsize_max,
-                      gint vsize_min, gint vsize_max);
+                     gint hsize_min, gint hsize_max,
+                     gint vsize_min, gint vsize_max);
 
 
 void pref_list_int_set(const gchar *group, const gchar *key, gint value);
-gint pref_list_int_get(const gchar *group, const gchar *key, gint *result);
+gboolean pref_list_int_get(const gchar *group, const gchar *key, gint *result);
 
 void pref_list_double_set(const gchar *group, const gchar *key, gdouble value);
-gint pref_list_double_get(const gchar *group, const gchar *key, gdouble *result);
+gboolean pref_list_double_get(const gchar *group, const gchar *key, gdouble *result);
 
 void pref_list_string_set(const gchar *group, const gchar *key, const gchar *value);
-gint pref_list_string_get(const gchar *group, const gchar *key, const gchar **result);
+gboolean pref_list_string_get(const gchar *group, const gchar *key, const gchar **result);
 
 
-void pref_background_color_set_cb(GtkWidget *widget, gpointer data);
-GtkWidget *pref_colorbutton_new(GtkWidget *parent_box,
-                               const gchar *title, const GdkColor *color,
-                               GCallback func, gpointer data);
+void pref_color_button_set_cb(GtkWidget *widget, gpointer data);
+GtkWidget *pref_color_button_new(GtkWidget *parent_box,
+                                const gchar *title, const GdkColor *color,
+                                GCallback func, gpointer data);
 
+gchar *text_widget_text_pull(GtkWidget *text_widget);
+gchar *text_widget_text_pull_selected(GtkWidget *text_widget);
 
+gboolean defined_mouse_buttons(GtkWidget *widget, GdkEventButton *event, gpointer data);
 #endif
-
+/* vim: set shiftwidth=8 softtabstop=0 cindent cinoptions={1s: */