ComboBox

---

Object Hierarchy:

Description:

Content:

Properties:

• public int active { get; set; }
  The item which is currently active.
• public bool add_tearoffs { get; set; }
  The add-tearoffs property controls whether generated menus have tearoff menu items.
• public SensitivityType button_sensitivity { get; set; }
  Whether the dropdown button is sensitive when the model is empty.
• public int column_span_column { get; set; }
  If this is set to a non-negative value, it must be the index of a column of type g_type_int in the model.
• public int entry_text_column { get; set; }
  The model column to associate with strings from the entry.
• public bool focus_on_click { get; set; }
• public bool has_entry { get; construct; }
  Whether the combo box has an entry.
• public bool has_frame { get; set; }
  The `has-frame` property controls whether a frame is drawn around the entry.
• public TreeModel model { get; set; }
  The model from which the combo box takes its values.
• public bool popup_shown { get; }
  Whether the combo boxes dropdown is popped up.
• public int row_span_column { get; set; }
  If this is set to a non-negative value, it must be the index of a column of type g_type_int in the model.
• public string tearoff_title { owned get; set; }
  A title that may be displayed by the window manager when the popup is torn-off.
• public int wrap_width { get; set; }
  If wrap-width is set to a positive value, items in the popup will be laid out along multiple columns, starting a new row on reaching the wrap width.

Creation methods:

• public ComboBox ()
  Creates a new empty `GtkComboBox`.
• public ComboBox.text ()
• public ComboBox.with_entry ()
  Creates a new empty `GtkComboBox` with an entry.
• public ComboBox.with_model (TreeModel model)
  Creates a new `GtkComboBox` with a model.
• public ComboBox.with_model_and_entry (TreeModel model)
  Creates a new empty `GtkComboBox` with an entry and a model.

Methods:

• public void append_text (string text)
• public int get_active ()
  Returns the index of the currently active item.
• public bool get_active_iter (out TreeIter iter)
  Sets iter to point to the currently active item.
• public virtual unowned string get_active_text ()
• public bool get_add_tearoffs ()
  Gets the current value of the add_tearoffs property.
• public SensitivityType get_button_sensitivity ()
  Returns whether the combo box sets the dropdown button sensitive or not when there are no items in the model.
• public int get_column_span_column ()
  Returns the column with column span information for this.
• public int get_entry_text_column ()
  Returns the column which this is using to get the strings from to display in the internal entry.
• public bool get_focus_on_click ()
  Returns whether the combo box grabs focus when it is clicked with the mouse.
• public bool get_has_entry ()
  Returns whether the combo box has an entry.
• public unowned TreeModel get_model ()
  Returns the `GtkTreeModel` of this.
• public unowned Object get_popup_accessible ()
  Gets the accessible object corresponding to the combo box’s popup.
• public unowned TreeViewRowSeparatorFunc get_row_separator_func ()
  Returns the current row separator function.
• public int get_row_span_column ()
  Returns the column with row span information for this.
• public unowned string get_title ()
  Gets the current title of the menu in tearoff mode.
• public int get_wrap_width ()
  Returns the wrap width which is used to determine the number of columns for the popup menu.
• public void insert_text (int position, string text)
• public void prepend_text (string text)
• public void remove_text (int position)
• public void set_active (int index_)
  Sets the active item of this to be the item at index.
• public void set_active_iter (TreeIter? iter)
  Sets the current active item to be the one referenced by iter .
• public void set_add_tearoffs (bool add_tearoffs)
  Sets whether the popup menu should have a tearoff menu item.
• public void set_button_sensitivity (SensitivityType sensitivity)
  Sets whether the dropdown button of the combo box should update its sensitivity depending on the model contents.
• public void set_column_span_column (int column_span)
  Sets the column with column span information for this to be column_span.
• public void set_entry_text_column (int text_column)
  Sets the model column which this should use to get strings from to be text_column.
• public void set_focus_on_click (bool focus_on_click)
  Sets whether the combo box will grab focus when it is clicked with the mouse.
• public void set_model (TreeModel? model)
  Sets the model used by this to be model.
• public void set_row_separator_func (owned TreeViewRowSeparatorFunc func)
  Sets the row separator function, which is used to determine whether a row should be drawn as a separator.
• public void set_row_span_column (int row_span)
  Sets the column with row span information for this to be row_span.
• public void set_title (string title)
  Sets the menu’s title in tearoff mode.
• public void set_wrap_width (int width)
  Sets the wrap width of this to be width.

Signals:

• public virtual signal void changed ()
  Emitted when the active item is changed.
• public virtual signal void move_active (ScrollType p0)
  Emitted to move the active selection.
• public virtual signal bool popdown ()
  Emitted to popdown the combo box list.
• public virtual signal void popup ()
  Emitted to popup the combo box list.

Inherited Members: