GimpUi.query_string_box
Description: Reference for GimpUi.query_string_box

### 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
    )

#### Description [src]

Creates a new `GtkDialog` that queries the user for a string value.

#### 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: `GtkWidget`

  The dialog’s parent widget.

  The data is owned by the caller of the function.

`help_func`

  Type: `GimpHelpFunc`

  The 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: `GObject`

  The 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: `GimpQueryStringCallback`

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

`data`

  Type: `gpointer`

  The callback’s user data.

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

`data_destroy`

  Type: `GDestroyNotify`

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