### Method

# GimpUi ProcedureDialog fill_box

#### Declaration [src]

    GtkWidget*
    gimp_procedure_dialog_fill_box (
      GimpProcedureDialog* dialog,
      const gchar* container_id,
      const gchar* first_property,
      ...
    )

#### Description [src]

Creates and populates a new `GtkBox` with widgets corresponding to every listed properties. If the list is empty, the created box will be filled by the whole list of properties of the associated `GimpProcedure`, in the defined order. This is similar of how `gimp_procedure_dialog_fill()` works except that it creates a new widget which is not inside `dialog` itself.

The `container_id` must be a unique ID which is neither the name of a property of the `GimpProcedureConfig` associated to `dialog`, nor is it the ID of any previously created container. This ID can later be used together with property names to be packed in other containers or inside `dialog` itself.

This method is not directly available to language bindings.
The implementation of this method is provided by `gimp_procedure_dialog_fill_box_list()` in language bindings

#### Parameters

`container_id` | `const gchar*`
| A container identifier.
| The data is owned by the caller of the function.
| The value is a NUL terminated UTF-8 string.
`first_property` | `const gchar*`
| The first property name.
| The data is owned by the caller of the function.
| The value is a NUL terminated UTF-8 string.
`...` | ``
| A `NULL`-terminated list of other property names.

#### Return value

Returns: | `GtkWidget`
| The `GtkBox` representing `property`. The object belongs to `dialog` and must not be freed.
| The data is owned by the instance.