Function
GimpUiquery_size_box
unstable since: 3.0
Declaration [src]
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,
GDestroyNotify data_destroy
)
Description [src]
Creates a new GtkDialog that queries the user for a size using a
GimpSizeEntry.
Available since: 3.0
Parameters
title-
Type:
const gchar*The query box dialog’s title.
The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string. parent-
Type:
GtkWidgetThe dialog’s parent widget.
The data is owned by the caller of the function. help_func-
Type:
GimpHelpFuncThe help function to show this dialog’s help page.
help_id-
Type:
const gchar*A string identifying this dialog’s help page.
The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string. message-
Type:
const gchar*A string which will be shown above the dialog’s entry widget.
The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string. initial-
Type:
gdoubleThe initial value.
lower-
Type:
gdoubleThe lower boundary of the range of possible values.
upper-
Type:
gdoubleThe upper boundray of the range of possible values.
digits-
Type:
gintThe number of decimal digits the
GimpSizeEntryprovide in “pixel” mode. unit-
Type:
NoneThe unit initially shown by the
GimpUnitMenu. resolution-
Type:
gdoubleThe resolution (in dpi) which will be used for pixel/unit calculations.
dot_for_dot-
Type:
gbooleanTRUEif theGimpUnitMenu‘s initial unit should be “pixels”. object-
Type:
GObjectThe object this query box is associated with.
The data is owned by the caller of the function. signal-
Type:
const gchar*The object’s signal which will cause the query box to be closed.
The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string. callback-
Type:
GimpQuerySizeCallbackThe function which will be called when the user selects “OK”.
data-
Type:
gpointerThe callback’s user data.
The argument can be NULL.The data is owned by the caller of the function. data_destroy-
Type:
GDestroyNotifyDestroy function for
data.
Return value
Type: GtkWidget
A pointer to the new GtkDialog.
| The caller of the function takes ownership of the data, and is responsible for freeing it. |