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. |