Method

Gtk.ComboBox.set_active_id

Declaration [src]

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

Description [src]

Changes the active row of combo_box to the one that has an ID equal to active_id.

If active_id is NULL, the active row is unset. 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.

Sets propertyGtk.ComboBox:active-id

Parameters

active_id const char*
 

the ID of the row to select, or NULL

 Can be NULL
 Ownership is not transferred to the callee
 The string is a NUL terminated UTF-8 string

Return value

Returns: 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.