#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

References AbstractTreeViewItem, blender::ui::TreeViewItemContainer::None, options, and xy.

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.

References AbstractTreeViewItem, blender::ui::AbstractView::AbstractView(), and blender::ui::AbstractView::AbstractViewItem.

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 AbstractTreeViewItem, 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::AbstractView::supports_scrolling(), and 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().