Function

GimpUiquery_size_box

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.

Parameters

title 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 GtkWidget
 

The dialog’s parent widget.

 The data is owned by the caller of the function.
help_func GimpHelpFunc
 

The help function to show this dialog’s help page.

help_id 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 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 gdouble
 

The initial value.

lower gdouble
 

The lower boundary of the range of possible values.

upper gdouble
 

The upper boundray of the range of possible values.

digits gint
 

The number of decimal digits the GimpSizeEntry provide in “pixel” mode.

unit None
 

The unit initially shown by the GimpUnitMenu.

resolution gdouble
 

The resolution (in dpi) which will be used for pixel/unit calculations.

dot_for_dot gboolean
 

TRUE if the GimpUnitMenus initial unit should be “pixels”.

object GObject
 

The object this query box is associated with.

 The data is owned by the caller of the function.
signal 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 GimpQuerySizeCallback
 

The function which will be called when the user selects “OK”.

data gpointer
 

The callback’s user data.

 The argument can be NULL.
 The data is owned by the caller of the function.
data_destroy GDestroyNotify
 

Destroy function for data.

Return value

Returns: GtkWidget
 

A pointer to the new GtkDialog.

 The caller of the function takes ownership of the data, and is responsible for freeing it.