gimp/libgimpwidgets/gimpquerybox.h

181 lines
7.8 KiB
C

/* LIBGIMP - The GIMP Library
* Copyright (C) 1995-1997 Peter Mattis and Spencer Kimball
*
* gimpquerybox.h
* Copyright (C) 1999-2000 Michael Natterer <mitch@gimp.org>
*
* This library is free software: you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 3 of the License, or (at your option) any later version.
*
* This library 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
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library. If not, see
* <https://www.gnu.org/licenses/>.
*/
#if !defined (__GIMP_WIDGETS_H_INSIDE__) && !defined (GIMP_WIDGETS_COMPILATION)
#error "Only <libgimpwidgets/gimpwidgets.h> can be included directly."
#endif
#ifndef __GIMP_QUERY_BOX_H__
#define __GIMP_QUERY_BOX_H__
G_BEGIN_DECLS
/* For information look into the C source or the html documentation */
/**
* GimpQueryStringCallback:
* @query_box: The query box.
* @string: The entered string.
* @data: The user data.
*
* Note that you must not g_free() the passed string.
**/
typedef void (* GimpQueryStringCallback) (GtkWidget *query_box,
const gchar *string,
gpointer data);
/**
* GimpQueryIntCallback:
* @query_box: The query box.
* @value: The entered integer value.
* @data: The user data.
*
* The callback for an int query box.
**/
typedef void (* GimpQueryIntCallback) (GtkWidget *query_box,
gint value,
gpointer data);
/**
* GimpQueryDoubleCallback:
* @query_box: The query box.
* @value: The entered double value.
* @data: The user data.
*
* The callback for a double query box.
**/
typedef void (* GimpQueryDoubleCallback) (GtkWidget *query_box,
gdouble value,
gpointer data);
/**
* GimpQuerySizeCallback:
* @query_box: The query box.
* @size: The entered size in pixels.
* @unit: The selected unit from the #GimpUnitMenu.
* @data: The user data.
*
* The callback for a size query box.
**/
typedef void (* GimpQuerySizeCallback) (GtkWidget *query_box,
gdouble size,
GimpUnit unit,
gpointer data);
/**
* GimpQueryBooleanCallback:
* @query_box: The query box.
* @value: The entered boolean value.
* @data: The user data.
*
* The callback for a boolean query box.
**/
typedef void (* GimpQueryBooleanCallback) (GtkWidget *query_box,
gboolean value,
gpointer data);
/**
* GIMP_QUERY_BOX_VBOX:
* @qbox: The query box.
*
* A macro to access the #GtkVBox in a #libgimpwidgets-gimpquerybox.
* Useful if you want to add more widgets.
**/
#define GIMP_QUERY_BOX_VBOX(qbox) g_object_get_data (G_OBJECT (qbox), \
"gimp-query-box-vbox")
/* some simple query dialogs */
GtkWidget * gimp_query_string_box (const gchar *title,
GtkWidget *parent,
GimpHelpFunc help_func,
const gchar *help_id,
const gchar *message,
const gchar *initial,
GObject *object,
const gchar *signal,
GimpQueryStringCallback callback,
gpointer data);
GtkWidget * gimp_query_int_box (const gchar *title,
GtkWidget *parent,
GimpHelpFunc help_func,
const gchar *help_id,
const gchar *message,
gint initial,
gint lower,
gint upper,
GObject *object,
const gchar *signal,
GimpQueryIntCallback callback,
gpointer data);
GtkWidget * gimp_query_double_box (const gchar *title,
GtkWidget *parent,
GimpHelpFunc help_func,
const gchar *help_id,
const gchar *message,
gdouble initial,
gdouble lower,
gdouble upper,
gint digits,
GObject *object,
const gchar *signal,
GimpQueryDoubleCallback callback,
gpointer data);
GtkWidget * gimp_query_size_box (const gchar *title,
GtkWidget *parent,
GimpHelpFunc help_func,
const gchar *help_id,
const gchar *message,
gdouble initial,
gdouble lower,
gdouble upper,
gint digits,
GimpUnit unit,
gdouble resolution,
gboolean dot_for_dot,
GObject *object,
const gchar *signal,
GimpQuerySizeCallback callback,
gpointer data);
GtkWidget * gimp_query_boolean_box (const gchar *title,
GtkWidget *parent,
GimpHelpFunc help_func,
const gchar *help_id,
const gchar *icon_name,
const gchar *message,
const gchar *true_button,
const gchar *false_button,
GObject *object,
const gchar *signal,
GimpQueryBooleanCallback callback,
gpointer data);
G_END_DECLS
#endif /* __GIMP_QUERY_BOX_H__ */