#include <UI_tree_view.hh>

Inherits blender::ui::AbstractView, and blender::ui::TreeViewItemContainer.

Inherited by blender::ed::asset::shelf::AssetCatalogSelectorTree, blender::ed::asset::shelf::AssetCatalogTreeView, blender::ed::asset_browser::AssetCatalogTreeView, blender::ed::spreadsheet::GeometryDataSetTreeView, blender::ed::spreadsheet::GeometryInstancesTreeView, blender::ui::bonecollections::BoneCollectionTreeView, and blender::ui::greasepencil::LayerTreeView.

Public Member Functions
	~AbstractTreeView () override=default

void	draw_overlays (const ARegion &region, const uiBlock &block) const override

void	foreach_item (ItemIterFn iter_fn, IterOptions options=IterOptions::None) const

void	scroll (ViewScrollDirection direction) override

AbstractTreeViewItem *	find_hovered (const ARegion &region, const int2 &xy)

void	set_default_rows (int default_rows)

Public Member Functions inherited from blender::ui::AbstractView
virtual	~AbstractView ()=default

void	register_item (AbstractViewItem &item)

virtual std::unique_ptr< DropTargetInterface >	create_drop_target ()

virtual bool	listen (const wmNotifier &) const

virtual bool	begin_filtering (const bContext &C) const

bool	is_renaming () const

bool	begin_renaming ()

void	end_renaming ()

Span< char >	get_rename_buffer () const

MutableSpan< char >	get_rename_buffer ()

std::optional< rcti >	get_bounds () const

std::string	get_context_menu_title () const

void	set_context_menu_title (const std::string &title)

bool	get_popup_keep_open () const

void	set_popup_keep_open ()

void	clear_search_highlight ()

Public Member Functions inherited from blender::ui::TreeViewItemContainer
template<class ItemT , typename... Args>
ItemT &	add_tree_item (Args &&...args)

AbstractTreeViewItem &	add_tree_item (std::unique_ptr< AbstractTreeViewItem > item)

Protected Member Functions
virtual void	build_tree ()=0

Protected Member Functions inherited from blender::ui::AbstractView
	AbstractView ()=default

virtual void	change_state_delayed ()

void	update_from_old (uiBlock &new_block)

bool	is_reconstructed () const

const AbstractViewItem *	search_highlight_item () const

void	filter (std::optional< StringRef > filter_str)

Protected Member Functions inherited from blender::ui::TreeViewItemContainer
void	foreach_item_recursive (ItemIterFn iter_fn, IterOptions options=IterOptions::None) const

void	foreach_parent (ItemIterFn iter_fn) const

Friends
class	AbstractTreeViewItem

class	TreeViewBuilder

class	TreeViewLayoutBuilder

class	TreeViewItemDropTarget

Additional Inherited Members
Public Types inherited from blender::ui::TreeViewItemContainer
enum class	IterOptions { None = 0 , SkipCollapsed = 1 << 0 , SkipFiltered = 1 << 1 }

using	ItemIterFn = FunctionRef<void(AbstractTreeViewItem &)>

Protected Attributes inherited from blender::ui::TreeViewItemContainer
Vector< std::unique_ptr< AbstractTreeViewItem > >	children_

TreeViewItemContainer *	root_ = nullptr

AbstractTreeViewItem *	parent_ = nullptr

Detailed Description

Definition at line 114 of file UI_tree_view.hh.

Constructor & Destructor Documentation

◆ ~AbstractTreeView()

blender::ui::AbstractTreeView::~AbstractTreeView ( )

overridedefault

Member Function Documentation

◆ build_tree()

virtual void blender::ui::AbstractTreeView::build_tree ( )

protectedpure virtual

Implemented in blender::ed::asset::shelf::AssetCatalogSelectorTree, blender::ed::asset::shelf::AssetCatalogTreeView, blender::ed::asset_browser::AssetCatalogTreeView, blender::ed::spreadsheet::GeometryDataSetTreeView, blender::ed::spreadsheet::GeometryInstancesTreeView, blender::ui::bonecollections::BoneCollectionTreeView, and blender::ui::greasepencil::LayerTreeView.

Referenced by blender::ui::TreeViewBuilder::build_tree_view().

◆ draw_overlays()

void blender::ui::AbstractTreeView::draw_overlays	(	const ARegion &	region,
		const uiBlock &	block ) const

overridevirtual

Reimplemented from blender::ui::AbstractView.

Definition at line 263 of file tree_view.cc.

◆ find_hovered()

AbstractTreeViewItem * blender::ui::AbstractTreeView::find_hovered	(	const ARegion &	region,
		const int2 &	xy )

Parameters

xy	The mouse coordinates in window space.

Definition at line 110 of file tree_view.cc.

References BLI_rctf_isect_y(), blender::ui::TreeViewItemContainer::foreach_item_recursive(), blender::ui::AbstractTreeViewItem::get_win_rect(), blender::ui::TreeViewItemContainer::SkipCollapsed, blender::ui::TreeViewItemContainer::SkipFiltered, and xy.

◆ foreach_item()

void blender::ui::AbstractTreeView::foreach_item	(	ItemIterFn	iter_fn,
		IterOptions	options = IterOptions::None ) const

Definition at line 105 of file tree_view.cc.

References blender::ui::TreeViewItemContainer::foreach_item_recursive(), and options.

Referenced by blender::ui::TreeViewLayoutBuilder::build_from_tree(), blender::ui::count_visible_items(), and blender::ed::asset::shelf::AssetCatalogSelectorTree::update_shelf_settings_from_enabled_catalogs().

◆ scroll()

void blender::ui::AbstractTreeView::scroll ( ViewScrollDirection direction )

overridevirtual

Reimplemented from blender::ui::AbstractView.

Definition at line 332 of file tree_view.cc.

References blender::ui::UP.

◆ set_default_rows()

void blender::ui::AbstractTreeView::set_default_rows ( int default_rows )

Visual feature: Define a number of item rows the view will show by default. If there are fewer items, empty dummy items will be added. These contribute to the view bounds, so the drop target of the view includes them, but they are not interactive (e.g. no mouse-hover highlight).

Definition at line 129 of file tree_view.cc.

References blender::ui::padded_item_height().

Referenced by uiTemplateBoneCollectionTree(), uiTemplateGreasePencilLayerTree(), uiTemplateLightLinkingCollection(), and uiTemplateNodeTreeInterface().