Function
GimpUiquery_string_box
Declaration [src]
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,
GDestroyNotify data_destroy
)
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:
const gchar*The initial value.
The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string. 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:
GimpQueryStringCallbackThe 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. |