Method

GtkComboBoxset_active_id

since: 3.0

Declaration [src]

gboolean
gtk_combo_box_set_active_id (
  GtkComboBox* combo_box,
  const gchar* active_id
)

Description [src]

Changes the active row of combo_box to the one that has an ID equal to active_id, or unsets the active row if active_id is NULL. Rows having a NULL ID string cannot be made active by this function.

If the GtkComboBox:id-column property of combo_box is unset or if no row has the given ID then the function does nothing and returns FALSE.

Available since: 3.0

Sets propertyGtk.ComboBox:active-id

Parameters

active_id

Type: const gchar*

The ID of the row to select, or NULL.

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

Return value

Type: gboolean

TRUE if a row with a matching ID was found. If a NULL active_id was given to unset the active row, the function always returns TRUE.