Method

GtkFileChooseradd_choice

since: 3.22

Declaration [src]

void
gtk_file_chooser_add_choice (
  GtkFileChooser* chooser,
  const char* id,
  const char* label,
  const char** options,
  const char** option_labels
)

Description [src]

Adds a ‘choice’ to the file chooser. This is typically implemented as a combobox or, for boolean choices, as a checkbutton. You can select a value using gtk_file_chooser_set_choice() before the dialog is shown, and you can obtain the user-selected value in the ::response signal handler using gtk_file_chooser_get_choice().

Compare gtk_file_chooser_set_extra_widget().

Available since: 3.22

Parameters

id

Type: const char*

Id for the added choice.

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

Type: const char*

User-visible label for the added choice.

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

Type: An array of char*

Ids for the options of the choice, or NULL for a boolean choice.

The argument can be NULL.
The array must be NULL-terminated.
The data is owned by the caller of the method.
Each element is a NUL terminated UTF-8 string.
option_labels

Type: An array of char*

User-visible labels for the options, must be the same length as options.

The argument can be NULL.
The array must be NULL-terminated.
The data is owned by the caller of the method.
Each element is a NUL terminated UTF-8 string.