Gtk::TreeView Class Reference
[Widgets, Container Widgets, TreeView Classes]

Detailed Description
The TreeView widget displays the model (Gtk::TreeModel) data and allows the user to interact with it.The View can show all of the model's columns, or just some, and it can show them in various ways. You must provide the TreeModel in the constructor, or with set_model().
Add View columns with append_column(), append_column_editable(), insert_column(), or insert_column_editable().
You can manipulate the selection by obtaining the Gtk::TreeView::Selection from get_selection().
Public Types | |
| typedef TreeViewColumn | Column |
| A visible column in a Gtk::TreeView widget. | |
| typedef TreeSelection | Selection |
| A selection object for Gtk::TreeView. | |
| typedef TreeViewColumn::SlotCellData | SlotCellData |
| typedef sigc::slot< bool, TreeView*, TreeViewColumn *, TreeViewColumn *, TreeViewColumn* > | SlotColumnDrop |
| For instance, bool on_column_drop(TreeView*, tree_view, TreeViewColumn* column, TreeViewColumn* prev_column, TreeViewColumn* next_column). | |
| typedef sigc::slot< void, TreeView*, const TreeModel::Path& > | SlotMapping |
| For example, void on_map_expanded_rows(TreeView* tree_view, const TreeModel::Path& path);. | |
| typedef sigc::slot< bool, const Glib::RefPtr<TreeModel> &, const TreeModel::iterator& > | SlotRowSeparator |
| For instance, void on_row_separator(const Gtk::TreeModel& model, const Gtk::TreeModel::iterator& iter);. | |
| typedef sigc::slot< bool, const Glib::RefPtr<TreeModel> &, int, const Glib::ustring &, const TreeModel::iterator& > | SlotSearchEqual |
| void on_search_equal(const Glib::RefPtr<TreeModel>& model, int column, const Glib::ustring& key, const TreeModel::iterator& iter) | |
| typedef sigc::slot< void, Gtk::Widget* > | SlotSearchPosition |
| void on_search_position(Gtk::Widget* search_dialog) | |
Public Member Functions | |
| Glib::RefPtr<Gtk::TreeModel> | _get_base_model () |
| Get the treeview's model, but actually get the child model if it's a TreeModelFilter. | |
| int | append_column (const Glib::ustring& title, CellRenderer& cell) |
| Creates a View column containing the CellRenderer, and appends it. | |
| template<class ColumnType> | |
| int | append_column (const Glib::ustring& title, const TreeModelColumn<ColumnType>& model_column) |
| Appends a View column with the appropriate CellRenderer for the Model column. | |
| int | append_column (TreeViewColumn& column) |
| Appends column to the list of columns. | |
| template<class ColumnType> | |
| int | append_column_editable (const Glib::ustring& title, const TreeModelColumn<ColumnType>& model_column) |
| Appends a View column with the appropriate CellRenderer for the Model column. | |
| template<class ColumnType> | |
| int | append_column_numeric (const Glib::ustring& title, const TreeModelColumn<ColumnType>& model_column, const Glib::ustring& format) |
| Like append_column(), but only for numeric types, which will be displayed in the specified format. | |
| template<class ColumnType> | |
| int | append_column_numeric_editable (const Glib::ustring& title, const TreeModelColumn<ColumnType>& model_column, const Glib::ustring& format) |
| Like append_column_editable(), but only for numeric types, which will be displayed in the specified format. | |
| void | collapse_all () |
| Recursively collapses all visible, expanded nodes in tree_view. | |
| bool | collapse_row (const TreeModel::Path& path) |
| Collapses a row (hides its child rows, if they exist). | |
| void | columns_autosize () |
| Resizes all columns to their optimal width. | |
| void | convert_bin_window_to_tree_coords (int bx, int by, int& tx, int& ty) const |
| Converts bin_window coordinates to coordinates for the tree (the full scrollable area of the tree). | |
| void | convert_bin_window_to_widget_coords (int bx, int by, int& wx, int& wy) const |
| Converts bin_window coordinates (see get_bin_window()) to widget relative coordinates. | |
| void | convert_tree_to_bin_window_coords (int tx, int ty, int& bx, int& by) const |
| Converts tree coordinates (coordinates in full scrollable area of the tree) to bin_window coordinates. | |
| void | convert_tree_to_widget_coords (int tx, int ty, int& wx, int& wy) const |
| Converts tree coordinates (coordinates in full scrollable area of the tree) to widget coordinates. | |
| void | convert_widget_to_bin_window_coords (int wx, int wy, int& bx, int& by) const |
| Converts widget coordinates to coordinates for the bin_window (see get_bin_window()). | |
| void | convert_widget_to_tree_coords (int wx, int wy, int& tx, int& ty) const |
| Converts widget coordinates to coordinates for the tree (the full scrollable area of the tree). | |
| Glib::RefPtr<Gdk::Pixmap> | create_row_drag_icon (const TreeModel::Path& path) |
| Creates a Gdk::Pixmap representation of the row at path. | |
| void | enable_model_drag_dest (Gdk::DragAction actions=Gdk::ACTION_COPY|Gdk::ACTION_MOVE) |
| Turns the TreeView into a drop destination for automatic DND. | |
| void | enable_model_drag_dest (const ArrayHandle_TargetEntry& targets, Gdk::DragAction actions=Gdk::ACTION_COPY|Gdk::ACTION_MOVE) |
| Turns the TreeView into a drop destination for automatic DND. | |
| void | enable_model_drag_source (Gdk::ModifierType start_button_mask=Gdk::MODIFIER_MASK, Gdk::DragAction actions=Gdk::ACTION_COPY|Gdk::ACTION_MOVE) |
| Turns the TreeView into a drag source for automatic DND. | |
| void | enable_model_drag_source (const ArrayHandle_TargetEntry& targets, Gdk::ModifierType start_button_mask=Gdk::MODIFIER_MASK, Gdk::DragAction actions=Gdk::ACTION_COPY|Gdk::ACTION_MOVE) |
| Turns the TreeView into a drag source for automatic DND. | |
| void | expand_all () |
| Recursively expands all nodes in the tree_view. | |
| bool | expand_row (const TreeModel::Path& path, bool open_all) |
| Opens the row so its children are visible. | |
| void | expand_to_path (const TreeModel::Path& path) |
| Expands the row at path. | |
| void | get_background_area (const TreeModel::Path& path, TreeViewColumn& column, Gdk::Rectangle& rect) const |
| Fills the bounding rectangle in tree window coordinates for the cell at the row specified by path and the column specified by column. | |
| void | get_background_area (const TreeModel::Path& path, TreeViewColumn& column, Gdk::Rectangle& rect) |
| Fills the bounding rectangle in tree window coordinates for the cell at the row specified by path and the column specified by column. | |
| Glib::RefPtr<const Gdk::Window> | get_bin_window () const |
Return value: A Gdk::Window, or 0 when tree_view hasn't been realized yet. | |
| Glib::RefPtr<Gdk::Window> | get_bin_window () |
Return value: A Gdk::Window, or 0 when tree_view hasn't been realized yet. | |
| void | get_cell_area (const TreeModel::Path& path, TreeViewColumn& column, Gdk::Rectangle& rect) const |
| Fills the bounding rectangle in tree window coordinates for the cell at the row specified by path and the column specified by column. | |
| void | get_cell_area (const TreeModel::Path& path, TreeViewColumn& column, Gdk::Rectangle& rect) |
| Fills the bounding rectangle in tree window coordinates for the cell at the row specified by path and the column specified by column. | |
| const TreeViewColumn* | get_column (int n) const |
| Gets the Gtk::TreeViewColumn at the given position in the tree_view. | |
| TreeViewColumn* | get_column (int n) |
| Gets the Gtk::TreeViewColumn at the given position in the tree_view. | |
| const CellRenderer* | get_column_cell_renderer (int n) const |
| Gets the CellRenderer for that column. | |
| CellRenderer* | get_column_cell_renderer (int n) |
| Gets the CellRenderer for that column. | |
| Glib::ListHandle< const TreeViewColumn* > | get_columns () const |
| Returns a list of all the Gtk::TreeViewColumn s currently in tree_view. | |
| Glib::ListHandle <TreeViewColumn*> | get_columns () |
| Returns a list of all the Gtk::TreeViewColumn s currently in tree_view. | |
| void | get_cursor (TreeModel::Path& path, TreeViewColumn*& focus_column) |
| Fills in path and focus_column with the current path and focus column. | |
| bool | get_dest_row_at_pos (int drag_x, int drag_y, TreeModel::Path& path, TreeViewDropPosition& pos) const |
| Determines the destination row for a given position. | |
| void | get_drag_dest_row (TreeModel::Path& path, TreeViewDropPosition& pos) const |
| Gets information about the row that is highlighted for feedback. | |
| bool | get_enable_search () const |
| Return value: whether or not to let the user search interactively. | |
| bool | get_enable_tree_lines () const |
Return value: true if tree lines are drawn in tree_view, false. | |
| const TreeViewColumn* | get_expander_column () const |
| Return value: The expander column. | |
| TreeViewColumn* | get_expander_column () |
| Return value: The expander column. | |
| bool | get_fixed_height_mode () const |
Return value: true if tree_view is in fixed height mode. | |
| TreeViewGridLines | get_grid_lines () const |
| Return value: a Gtk::TreeViewGridLines value indicating which grid lines. | |
| const Adjustment* | get_hadjustment () const |
| Gets the Gtk::Adjustment currently being used for the horizontal aspect. | |
| Adjustment* | get_hadjustment () |
| Gets the Gtk::Adjustment currently being used for the horizontal aspect. | |
| bool | get_headers_clickable () const |
Return value: true if all header columns are clickable, otherwise false. | |
| bool | get_headers_visible () const |
| Return value: Whether the headers are visible or not. | |
| bool | get_hover_expand () const |
Return value: true if tree_view is in hover expansion mode. | |
| bool | get_hover_selection () const |
Return value: true if tree_view is in hover selection mode. | |
| int | get_level_indentation () const |
| Return value: the amount of extra indentation for child levels in. | |
| Glib::RefPtr<const TreeModel> | get_model () const |
Return value: A Gtk::TreeModel, or 0 if none is currently being used. | |
| Glib::RefPtr<TreeModel> | get_model () |
Return value: A Gtk::TreeModel, or 0 if none is currently being used. | |
| bool | get_path_at_pos (int x, int y, TreeModel::Path& path, TreeViewColumn*& column, int& cell_x, int& cell_y) const |
| Finds the path at the point (x, y), relative to widget coordinates. | |
| bool | get_path_at_pos (int x, int y, TreeModel::Path& path, TreeViewColumn*& column, int& cell_x, int& cell_y) |
| bool | get_reorderable () const |
| Retrieves whether the user can reorder the tree via drag-and-drop. | |
| bool | get_rubber_banding () const |
Return value: true if rubber banding in tree_view is enabled. | |
| bool | get_rules_hint () const |
| Gets the setting set by set_rules_hint(). | |
| int | get_search_column () const |
| Gets the column searched on by the interactive search code. | |
| const Entry* | get_search_entry () const |
| Return value: the entry currently in use as search entry. | |
| Entry* | get_search_entry () |
| Return value: the entry currently in use as search entry. | |
| Glib::RefPtr<const TreeSelection> | get_selection () const |
| Gets the Gtk::TreeSelection associated with tree_view. | |
| Glib::RefPtr<TreeSelection> | get_selection () |
| Gets the Gtk::TreeSelection associated with tree_view. | |
| bool | get_show_expanders () const |
Return value: true if expanders are drawn in tree_view, false. | |
| int | get_tooltip_column () const |
| bool | get_tooltip_context_iter (int& x, int& y, bool keyboard_tip, Gtk::TreeModel::iterator& iter) |
| bool | get_tooltip_context_path (int& x, int& y, bool keyboard_tip, TreeModel::Path& path) |
| const Adjustment* | get_vadjustment () const |
| Gets the Gtk::Adjustment currently being used for the vertical aspect. | |
| Adjustment* | get_vadjustment () |
| Gets the Gtk::Adjustment currently being used for the vertical aspect. | |
| bool | get_visible_range (TreeModel::Path& start_path, TreeModel::Path& end_path) const |
| void | get_visible_rect (Gdk::Rectangle& visible_rect) const |
| Fills visible_rect with the currently-visible region of the buffer, in tree coordinates. | |
| void | get_visible_rect (Gdk::Rectangle& visible_rect) |
| Fills visible_rect with the currently-visible region of the buffer, in tree coordinates. | |
| const GtkTreeView* | gobj () const |
| Provides access to the underlying C GtkObject. | |
| GtkTreeView* | gobj () |
| Provides access to the underlying C GtkObject. | |
| template<class ColumnType> | |
| int | insert_column (const Glib::ustring& title, const TreeModelColumn<ColumnType>& model_column, int position) |
| Inserts a View column with the appropriate CellRenderer for the Model column. | |
| int | insert_column (const Glib::ustring& title, CellRenderer& cell, int position) |
| Creates a View column containing the CellRenderer, and inserts it. | |
| int | insert_column (TreeViewColumn& column, int position) |
| This inserts the column into the tree_view at position. | |
| template<class ColumnType> | |
| int | insert_column_editable (const Glib::ustring& title, const TreeModelColumn<ColumnType>& model_column, int position) |
| Inserts a View column with the appropriate CellRenderer for the Model column. | |
| int | insert_column_with_data_func (int position, const Glib::ustring& title, CellRenderer& cell, const SlotCellData& slot) |
| Inserts a new column into the TreeView with the given cell renderer and a SlotCellData to set cell renderer attributes (normally using data from the model). | |
| bool | is_rubber_banding_active () const |
Return value: true if a rubber banding operation is currently being. | |
| void | map_expanded_rows (const SlotMapping& slot) |
| Calls the callback slot on all expanded rows. | |
| void | move_column_after (TreeViewColumn& column, TreeViewColumn& base_column) |
| Moves column to be after to base_column. | |
| void | move_column_to_start (TreeViewColumn& column) |
| This method moves column to the first position in the view. | |
| Glib::PropertyProxy_ReadOnly <bool> | property_enable_grid_lines () const |
| Whether grid lines should be drawn in the tree view. | |
| Glib::PropertyProxy<bool> | property_enable_grid_lines () |
| Whether grid lines should be drawn in the tree view. | |
| Glib::PropertyProxy_ReadOnly <bool> | property_enable_search () const |
| View allows user to search through columns interactively. | |
| Glib::PropertyProxy<bool> | property_enable_search () |
| View allows user to search through columns interactively. | |
| Glib::PropertyProxy_ReadOnly <bool> | property_enable_tree_lines () const |
| Whether tree lines should be drawn in the tree view. | |
| Glib::PropertyProxy<bool> | property_enable_tree_lines () |
| Whether tree lines should be drawn in the tree view. | |
| Glib::PropertyProxy_ReadOnly <TreeViewColumn*> | property_expander_column () const |
| Set the column for the expander column. | |
| Glib::PropertyProxy <TreeViewColumn*> | property_expander_column () |
| Set the column for the expander column. | |
| Glib::PropertyProxy_ReadOnly <bool> | property_fixed_height_mode () const |
| Speeds up GtkTreeView by assuming that all rows have the same height. | |
| Glib::PropertyProxy<bool> | property_fixed_height_mode () |
| Speeds up GtkTreeView by assuming that all rows have the same height. | |
| Glib::PropertyProxy_ReadOnly <Adjustment*> | property_hadjustment () const |
| Horizontal Adjustment for the widget. | |
| Glib::PropertyProxy<Adjustment*> | property_hadjustment () |
| Horizontal Adjustment for the widget. | |
| Glib::PropertyProxy_ReadOnly <bool> | property_headers_clickable () const |
| Column headers respond to click events. | |
| Glib::PropertyProxy<bool> | property_headers_clickable () |
| Column headers respond to click events. | |
| Glib::PropertyProxy_ReadOnly <bool> | property_headers_visible () const |
| Show the column header buttons. | |
| Glib::PropertyProxy<bool> | property_headers_visible () |
| Show the column header buttons. | |
| Glib::PropertyProxy_ReadOnly <bool> | property_hover_expand () const |
| Whether rows should be expanded/collapsed when the pointer moves over them. | |
| Glib::PropertyProxy<bool> | property_hover_expand () |
| Whether rows should be expanded/collapsed when the pointer moves over them. | |
| Glib::PropertyProxy_ReadOnly <bool> | property_hover_selection () const |
| Whether the selection should follow the pointer. | |
| Glib::PropertyProxy<bool> | property_hover_selection () |
| Whether the selection should follow the pointer. | |
| Glib::PropertyProxy_ReadOnly <bool> | property_level_indentation () const |
| Extra indentation for each level. | |
| Glib::PropertyProxy<bool> | property_level_indentation () |
| Extra indentation for each level. | |
| Glib::PropertyProxy_ReadOnly <Glib::RefPtr<TreeModel>> | property_model () const |
| The model for the tree view. | |
| Glib::PropertyProxy <Glib::RefPtr<TreeModel>> | property_model () |
| The model for the tree view. | |
| Glib::PropertyProxy_ReadOnly <bool> | property_reorderable () const |
| View is reorderable. | |
| Glib::PropertyProxy<bool> | property_reorderable () |
| View is reorderable. | |
| Glib::PropertyProxy_ReadOnly <bool> | property_rubber_banding () const |
| Whether to enable selection of multiple items by dragging the mouse pointer. | |
| Glib::PropertyProxy<bool> | property_rubber_banding () |
| Whether to enable selection of multiple items by dragging the mouse pointer. | |
| Glib::PropertyProxy_ReadOnly <bool> | property_rules_hint () const |
| Set a hint to the theme engine to draw rows in alternating colors. | |
| Glib::PropertyProxy<bool> | property_rules_hint () |
| Set a hint to the theme engine to draw rows in alternating colors. | |
| Glib::PropertyProxy_ReadOnly<int> | property_search_column () const |
| Model column to search through when searching through code. | |
| Glib::PropertyProxy<int> | property_search_column () |
| Model column to search through when searching through code. | |
| Glib::PropertyProxy_ReadOnly <bool> | property_show_expanders () const |
| View has expanders. | |
| Glib::PropertyProxy<bool> | property_show_expanders () |
| View has expanders. | |
| Glib::PropertyProxy_ReadOnly <Adjustment*> | property_vadjustment () const |
| Vertical Adjustment for the widget. | |
| Glib::PropertyProxy<Adjustment*> | property_vadjustment () |
| Vertical Adjustment for the widget. | |
| void | remove_all_columns () |
| Removes all View columns. | |
| int | remove_column (TreeViewColumn& column) |
| Removes column from tree_view. | |
| void | reset_expander_column () |
| This method resets the expander arrow to the default - the first visible column. | |
| void | row_activated (const TreeModel::Path& path, TreeViewColumn& column) |
| Activates the cell determined by path and column. | |
| bool | row_expanded (const TreeModel::Path& path) |
Return value: true if path is expanded. | |
| void | scroll_to_cell (const TreeModel::Path& path, TreeViewColumn& column) |
| Moves the alignments of tree view to the position specified by column and path. | |
| void | scroll_to_cell (const TreeModel::Path& path, TreeViewColumn& column, float row_align, float col_align) |
| Moves the alignments of tree view to the position specified by column and path. | |
| void | scroll_to_column (TreeViewColumn& column) |
| Moves the alignments of tree view to the position specified by column. | |
| void | scroll_to_column (TreeViewColumn& column, float col_align) |
| Moves the alignments of tree view to the position specified by column. | |
| void | scroll_to_point (int tree_x, int tree_y) |
| Scrolls the tree view such that the top-left corner of the visible area is tree_x, tree_y, where tree_x and tree_y are specified in tree coordinates. | |
| void | scroll_to_row (const TreeModel::Path& path) |
| Moves the alignments of tree view to the position specified by path. | |
| void | scroll_to_row (const TreeModel::Path& path, float row_align) |
| Moves the alignments of tree view to the position specified by path. | |
| void | set_column_drag_function (const SlotColumnDrop& slot) |
| Sets a callback slot for determining where a column may be dropped when dragged. | |
| void | set_cursor (const TreeModel::Path& path) |
| Sets the current keyboard focus to be at path , and selects it. | |
| void | set_cursor (const TreeModel::Path& path, TreeViewColumn& focus_column, CellRenderer& focus_cell, bool start_editing=false) |
| Sets the current keyboard focus to be at path, and selects it. | |
| void | set_cursor (const TreeModel::Path& path, TreeViewColumn& focus_column, bool start_editing=false) |
| Sets the current keyboard focus to be at path, and selects it. | |
| void | set_drag_dest_row (const TreeModel::Path& path, TreeViewDropPosition pos) |
| Sets the row that is highlighted for feedback. | |
| void | set_enable_search (bool enable_search=true) |
| If enable_search is set, then the user can type in text to search through the tree interactively (this is sometimes called "typeahead find"). | |
| void | set_enable_tree_lines (bool enable=true) |
| Sets whether to draw lines interconnecting the expanders in tree_view. | |
| void | set_expander_column (TreeViewColumn& column) |
| Sets the column to draw the expander arrow at. | |
| void | set_fixed_height_mode (bool enable=true) |
| Enables or disables the fixed height mode of tree_view. | |
| void | set_grid_lines (TreeViewGridLines grid_lines) |
| Sets which grid lines to draw in tree_view. | |
| void | set_hadjustment (Adjustment& adjustment) |
| Sets the Gtk::Adjustment for the current horizontal aspect. | |
| void | set_headers_clickable (bool setting=true) |
| Allow the column title buttons to be clicked. | |
| void | set_headers_visible (bool headers_visible=true) |
| Sets the visibility state of the headers. | |
| void | set_hover_expand (bool expand=true) |
| Enables of disables the hover expansion mode of tree_view. | |
| void | set_hover_selection (bool hover=true) |
| Enables of disables the hover selection mode of tree_view. | |
| void | set_level_indentation (int indentation) |
| Sets the amount of extra indentation for child levels to use in tree_view in addition to the default indentation. | |
| void | set_model (const Glib::RefPtr<TreeModel>& model) |
| Sets the model for a Gtk::TreeView. | |
| void | set_reorderable (bool reorderable=true) |
| This function is a convenience function to allow you to reorder models that support the Gtk::DragSourceIface and the Gtk::DragDestIface. | |
| void | set_row_separator_func (const SlotRowSeparator& slot) |
| void | set_rubber_banding (bool enable=true) |
| Enables or disables rubber banding in tree_view. | |
| void | set_rules_hint (bool setting=true) |
| This function tells GTK+ that the user interface for your application requires users to read across tree rows and associate cells with one another. | |
| void | set_search_column (int column) |
| Sets column as the column where the interactive search code should search in. | |
| void | set_search_column (const TreeModelColumnBase& column) |
| Sets column as the column where the interactive search code should search in. | |
| void | set_search_entry (Entry& entry) |
| Sets the entry which the interactive search code will use for this tree_view. | |
| void | set_search_equal_func (const SlotSearchEqual& slot) |
| Sets the compare function for the interactive search capabilities. | |
| void | set_search_position_func (const SlotSearchPosition& slot) |
| void | set_show_expanders (bool enabled=true) |
| Sets whether to draw and enable expanders and indent child rows in tree_view. | |
| void | set_tooltip_cell (const Glib::RefPtr<Tooltip>& tooltip, const TreeModel::Path* path, TreeViewColumn* column, CellRenderer* cell) |
| Sets the tip area of tooltip to the area path, column and cell have in common. | |
| void | set_tooltip_column (int column) |
| void | set_tooltip_row (const Glib::RefPtr<Tooltip>& tooltip, const TreePath& path) |
| Sets the tip area of tooltip to be the area covered by the row at path. | |
| void | set_vadjustment (Adjustment& adjustment) |
| Sets the Gtk::Adjustment for the current vertical aspect. | |
| Glib::SignalProxy0<void> | signal_columns_changed () |
| Glib::SignalProxy0<void> | signal_cursor_changed () |
| Glib::SignalProxy2< void, const TreeModel::Path &, TreeViewColumn* > | signal_row_activated () |
| Glib::SignalProxy2< void, const TreeModel::iterator &, const TreeModel::Path& > | signal_row_collapsed () |
| Glib::SignalProxy2< void, const TreeModel::iterator &, const TreeModel::Path& > | signal_row_expanded () |
| Glib::SignalProxy2< void, Adjustment*, Adjustment* > | signal_set_scroll_adjustments () |
| Glib::SignalProxy2< bool, const TreeModel::iterator &, const TreeModel::Path& > | signal_test_collapse_row () |
| Glib::SignalProxy2< bool, const TreeModel::iterator &, const TreeModel::Path& > | signal_test_expand_row () |
| void | tree_to_widget_coords (int tx, int ty, int& wx, int& wy) const |
| Converts tree coordinates (coordinates in full scrollable area of the tree) to bin_window coordinates. | |
| void | tree_to_widget_coords (int tx, int ty, int& wx, int& wy) |
| Converts tree coordinates (coordinates in full scrollable area of the tree) to bin_window coordinates. | |
| TreeView (const Glib::RefPtr<TreeModel>& model) | |
| Constructor that binds to a TreeModel. | |
| TreeView () | |
| Default constructor. | |
| void | unset_column_drag_function () |
| See set_column_drag_function(). | |
| void | unset_hadjustment () |
| This method removes the hadjustment. | |
| void | unset_model () |
| Remove the model from the TreeView. | |
| void | unset_rows_drag_dest () |
| Undoes the effect of enable_model_drag_source(). | |
| void | unset_rows_drag_source () |
| Undoes the effect of enable_model_drag_source(). | |
| void | unset_vadjustment () |
| This method removes the vadjustment. | |
| void | widget_to_tree_coords (int wx, int wy, int& tx, int& ty) const |
| Converts bin_window coordinates to coordinates for the tree (the full scrollable area of the tree). | |
| void | widget_to_tree_coords (int wx, int wy, int& tx, int& ty) |
| Converts bin_window coordinates to coordinates for the tree (the full scrollable area of the tree). | |
| virtual | ~TreeView () |
Protected Member Functions | |
| virtual void | on_columns_changed () |
| virtual void | on_cursor_changed () |
| virtual void | on_row_activated (const TreeModel::Path& path, TreeViewColumn* column) |
| virtual void | on_row_collapsed (const TreeModel::iterator& iter, const TreeModel::Path& path) |
| virtual void | on_row_expanded (const TreeModel::iterator& iter, const TreeModel::Path& path) |
| virtual void | on_set_scroll_adjustments (Adjustment* hadjustment, Adjustment* vadjustment) |
| virtual bool | on_test_collapse_row (const TreeModel::iterator& iter, const TreeModel::Path& path) |
| virtual bool | on_test_expand_row (const TreeModel::iterator& iter, const TreeModel::Path& path) |
Related Functions | |
| (Note that these are not member functions.) | |
| Gtk::TreeView* | wrap (GtkTreeView* object, bool take_copy=false) |
| A Glib::wrap() method for this object. | |
Member Typedef Documentation
| typedef TreeViewColumn Gtk::TreeView::Column |
A visible column in a Gtk::TreeView widget.
A selection object for Gtk::TreeView.
| typedef sigc::slot<bool, TreeView*, TreeViewColumn*, TreeViewColumn*, TreeViewColumn*> Gtk::TreeView::SlotColumnDrop |
For instance, bool on_column_drop(TreeView*, tree_view, TreeViewColumn* column, TreeViewColumn* prev_column, TreeViewColumn* next_column).
This function is called on every column pair in turn at the beginning of a column drag to determine where a drop can take place. The arguments passed to the function are: the tree_view, the view Column being dragged, and the two view Columns determining the drop spot. If either of the view Column arguments for the drop spot are 0, then they indicate an edge.
| typedef sigc::slot<void, TreeView*, const TreeModel::Path&> Gtk::TreeView::SlotMapping |
For example, void on_map_expanded_rows(TreeView* tree_view, const TreeModel::Path& path);.
| typedef sigc::slot<bool, const Glib::RefPtr<TreeModel>&, const TreeModel::iterator&> Gtk::TreeView::SlotRowSeparator |
For instance, void on_row_separator(const Gtk::TreeModel& model, const Gtk::TreeModel::iterator& iter);.
