ListBox

---

Object Hierarchy:

Description:

Content:

Properties:

• public bool activate_on_single_click { get; set; }
  Determines whether children can be activated with a single click, or require a double-click.
• public SelectionMode selection_mode { get; set; }
  The selection mode used by the list box.

Creation methods:

• public ListBox ()
  Creates a new `GtkListBox` container.

Methods:

• public void bind_model (ListModel? model, owned ListBoxCreateWidgetFunc? create_widget_func)
  Binds model to this.
• public void drag_highlight_row (ListBoxRow row)
  Add a drag highlight to a row.
• public void drag_unhighlight_row ()
  If a row has previously been highlighted via drag_highlight_row, it will have the highlight removed.
• public bool get_activate_on_single_click ()
  Returns whether rows activate on single clicks.
• public unowned Adjustment get_adjustment ()
  Gets the adjustment (if any) that the widget uses to for vertical scrolling.
• public unowned ListBoxRow? get_row_at_index (int index_)
  Gets the n-th child in the list (not counting headers).
• public unowned ListBoxRow? get_row_at_y (int y)
  Gets the row at the y position.
• public unowned ListBoxRow get_selected_row ()
  Gets the selected row, or null if no rows are selected.
• public List<unowned ListBoxRow> get_selected_rows ()
  Creates a list of all selected children.
• public SelectionMode get_selection_mode ()
  Gets the selection mode of the listbox.
• public void insert (Widget child, int position)
  Insert the child into the this at position.
• public void invalidate_filter ()
  Update the filtering for all rows.
• public void invalidate_headers ()
  Update the separators for all rows.
• public void invalidate_sort ()
  Update the sorting for all rows.
• public void prepend (Widget child)
  Prepend a widget to the list.
• public void select_row (ListBoxRow? row)
  Make row the currently selected row.
• public void selected_foreach (ListBoxForeachFunc func)
  Calls a function for each selected child.
• public void set_activate_on_single_click (bool single)
  If single is true, rows will be activated when you click on them, otherwise you need to double-click.
• public void set_adjustment (Adjustment? adjustment)
  Sets the adjustment (if any) that the widget uses to for vertical scrolling.
• public void set_filter_func (owned ListBoxFilterFunc? filter_func)
  By setting a filter function on the this one can decide dynamically which of the rows to show.
• public void set_header_func (owned ListBoxUpdateHeaderFunc? update_header)
  Sets a header function.
• public void set_placeholder (Widget? placeholder)
  Sets the placeholder widget that is shown in the list when it doesn't display any visible children.
• public void set_selection_mode (SelectionMode mode)
  Sets how selection works in the listbox.
• public void set_sort_func (owned ListBoxSortFunc? sort_func)
  Sets a sort function.
• public void unselect_row (ListBoxRow row)
  Unselects a single row of this, if the selection mode allows it.

Signals:

• public virtual signal void activate_cursor_row ()
  Emitted when the cursor row is activated.
• public virtual signal void move_cursor (MovementStep step, int count)
  Emitted when the user initiates a cursor movement.
• public virtual signal void row_activated (ListBoxRow row)
  Emitted when a row has been activated by the user.
• public virtual signal void row_selected (ListBoxRow? row)
  Emitted when a new row is selected, or (with a null row) when the selection is cleared.
• public virtual signal void select_all ()
  Emitted to select all children of the box, if the selection mode permits it.
• public virtual signal void selected_rows_changed ()
  Emitted when the set of selected rows changes.
• public virtual signal void toggle_cursor_row ()
  Emitted when the cursor row is toggled.
• public virtual signal void unselect_all ()
  Emitted to unselect all children of the box, if the selection mode permits it.

Inherited Members: