Gimp.items_popup
Description: Reference for Gimp.items_popup

### Function

# Gimpitems_popup

#### Declaration [src]

    gboolean
    gimp_items_popup (
      const gchar* callback,
      const gchar* popup_title,
      const gchar* item_type,
      GimpItem* initial_item,
      GBytes* parent_window
    )

#### Description [src]

Invokes the item selection dialog.

Opens a dialog letting a user choose an item .

#### Parameters

`callback`

  Type: `const gchar*`

  The callback PDB proc to call when user chooses an item.

  The data is owned by the caller of the function.
  The value is a NUL terminated UTF-8 string.

`popup_title`

  Type: `const gchar*`

  Title of the item selection dialog.

  The data is owned by the caller of the function.
  The value is a NUL terminated UTF-8 string.

`item_type`

  Type: `const gchar*`

  The name of the GIMP_TYPE_ITEM subtype.

  The data is owned by the caller of the function.
  The value is a NUL terminated UTF-8 string.

`initial_item`

  Type: `GimpItem`

  The item to set as the initial choice.

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

`parent_window`

  Type: `GBytes`

  An optional parent window handle for the popup to be set transient to.

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

#### Return value

Type: `gboolean`

TRUE on success.