#include <memory>
#include "DNA_screen_types.h"
#include "BKE_screen.hh"
#include "BLI_listbase.h"
#include "BLI_map.hh"
#include "BLI_rect.h"
#include "ED_screen.hh"
#include "interface_intern.hh"
#include "UI_abstract_view.hh"
#include "UI_grid_view.hh"
#include "UI_tree_view.hh"

Classes
struct	ViewLink

Namespaces
namespace	blender
namespace	blender::ui

Functions
template<class T>
static T *	ui_block_add_view_impl (uiBlock &block, StringRef idname, std::unique_ptr< AbstractView > view)
AbstractGridView *	UI_block_add_view (uiBlock &block, StringRef idname, std::unique_ptr< AbstractGridView > grid_view)
AbstractTreeView *	UI_block_add_view (uiBlock &block, StringRef idname, std::unique_ptr< AbstractTreeView > tree_view)
void	ui_block_free_views (uiBlock *block)
void	ui_block_view_persistent_state_restore (const ARegion &region, const uiBlock &block, ui::AbstractView &view)
static uiViewStateLink *	ensure_view_state (ARegion &region, const ViewLink &link)
void	ui_block_views_end (ARegion region, const uiBlock block)
void	ui_block_views_listen (const uiBlock block, const wmRegionListenerParams listener_params)
void	ui_block_views_draw_overlays (const ARegion region, const uiBlock block)
blender::ui::AbstractView *	UI_region_view_find_at (const ARegion *region, const int xy[2], const int pad)
ui::AbstractViewItem *	UI_region_views_find_item_at (const ARegion &region, const int xy[2])
ui::AbstractViewItem *	UI_region_views_find_active_item (const ARegion *region)
uiBut *	UI_region_views_find_active_item_but (const ARegion *region)
void	UI_region_views_clear_search_highlight (const ARegion *region)
std::unique_ptr< DropTargetInterface >	blender::ui::region_views_find_drop_target_at (const ARegion *region, const int xy[2])
static StringRef	ui_block_view_find_idname (const uiBlock &block, const AbstractView &view)
template<class T>
static T *	ui_block_view_find_matching_in_old_block_impl (const uiBlock &new_block, const T &new_view)
blender::ui::AbstractView *	ui_block_view_find_matching_in_old_block (const uiBlock &new_block, const blender::ui::AbstractView &new_view)
uiButViewItem *	ui_block_view_find_matching_view_item_but_in_old_block (const uiBlock &new_block, const ui::AbstractViewItem &new_item)

Detailed Description

Code to manage views as part of the regular screen hierarchy. E.g. managing ownership of views inside blocks (uiBlock.views), looking up items in the region, passing WM notifiers to views, etc.

Blocks and their contained views are reconstructed on every redraw. This file also contains functions related to this recreation of views inside blocks. For example to query state information before the view is done reconstructing (AbstractView.is_reconstructed() returns false), it may be enough to query the previous version of the block/view/view-item. Since such queries rely on the details of the UI reconstruction process, they should remain internal to interface/ code.

Definition in file interface_view.cc.

Function Documentation

◆ ensure_view_state()

uiViewStateLink * ensure_view_state	(	ARegion &	region,
		const ViewLink &	link )

static

Definition at line 153 of file interface_view.cc.

References BLI_addhead(), uiViewStateLink::idname, ViewLink::idname, LISTBASE_FOREACH, MEM_callocN(), and ARegion::view_states.

Referenced by ui_block_views_end().

◆ UI_block_add_view() [1/2]

AbstractGridView * UI_block_add_view	(	uiBlock &	block,
		blender::StringRef	idname,
		std::unique_ptr< blender::ui::AbstractGridView >	grid_view )

Override this for all available view types.

Parameters

idname Used for restoring persistent state of this view, potentially written to files. Must not be longer than BKE_ST_MAXNAME (including 0 terminator).

Definition at line 67 of file interface_view.cc.

References ui_block_add_view_impl().

Referenced by blender::ed::asset::shelf::build_asset_view(), blender::ed::asset::shelf::catalog_selector_panel_draw(), blender::ed::asset::shelf::catalog_tree_draw(), blender::ed::spreadsheet::draw_viewer_data_panel(), blender::ed::spreadsheet::draw_viewer_path_panel(), blender::ed::asset_browser::file_create_asset_catalog_tree_view_in_layout(), blender::ed::spreadsheet::spreadsheet_data_set_panel_draw(), blender::ed::object::shapekey::template_tree(), uiTemplateBoneCollectionTree(), uiTemplateGreasePencilLayerTree(), uiTemplateLightLinkingCollection(), and uiTemplateNodeTreeInterface().