#include <panel_design_block_chooser.h>

Inheritance diagram for PANEL_DESIGN_BLOCK_CHOOSER:

Public Member Functions
	PANEL_DESIGN_BLOCK_CHOOSER (SCH_EDIT_FRAME aFrame, wxWindow aParent, std::vector< LIB_ID > &aHistoryList, std::function< void()> aSelectHandler)
	Create dialog to choose design_block.

	~PANEL_DESIGN_BLOCK_CHOOSER ()

void	OnChar (wxKeyEvent &aEvent)

void	FinishSetup ()

void	SetPreselect (const LIB_ID &aPreselect)

void	RefreshLibs (bool aProgress=false)

LIB_ID	GetSelectedLibId (int *aUnit=nullptr) const
	To be called after this dialog returns from ShowModal().

void	SelectLibId (const LIB_ID &aLibId)

LIB_TREE *	GetLibTree ()

Protected Member Functions
void	OnDetailsCharHook (wxKeyEvent &aEvt)

void	onCloseTimer (wxTimerEvent &aEvent)

void	onOpenLibsTimer (wxTimerEvent &aEvent)

void	onDesignBlockSelected (wxCommandEvent &aEvent)

void	onDesignBlockChosen (wxCommandEvent &aEvent)
	Handle the selection of an item.

void	addDesignBlockToHistory (const LIB_ID &aLibId)

void	rebuildHistoryNode ()

void	displayErrors (wxTopLevelWindow *aWindow)

Protected Attributes
wxTimer *	m_dbl_click_timer

wxTimer *	m_open_libs_timer

wxSplitterWindow *	m_vsplitter

wxObjectDataPtr< LIB_TREE_MODEL_ADAPTER >	m_adapter

LIB_TREE *	m_tree

DESIGN_BLOCK_PREVIEW_WIDGET *	m_preview

SCH_EDIT_FRAME *	m_frame

std::function< void()>	m_selectHandler

std::vector< LIB_ID >	m_historyList

Static Protected Attributes
static constexpr int	DBLCLICK_DELAY = 100

static wxString	g_designBlockSearchString

Detailed Description

Definition at line 38 of file panel_design_block_chooser.h.

Constructor & Destructor Documentation

◆ PANEL_DESIGN_BLOCK_CHOOSER()

PANEL_DESIGN_BLOCK_CHOOSER::PANEL_DESIGN_BLOCK_CHOOSER	(	SCH_EDIT_FRAME *	aFrame,
		wxWindow *	aParent,
		std::vector< LIB_ID > &	aHistoryList,
		std::function< void()>	aSelectHandler
	)

Create dialog to choose design_block.

Parameters

aFrame	the parent frame (usually a SCH_EDIT_FRAME or DESIGN_BLOCK_CHOOSER_FRAME)
aParent	the parent window (usually a DIALOG_SHIM or DESIGN_BLOCK_CHOOSER_FRAME)
aAcceptHandler	a handler to be called on double-click of a footprint
aEscapeHandler	a handler to be called on <ESC>

Definition at line 53 of file panel_design_block_chooser.cpp.

References _, LIB_TREE::ALL_WIDGETS, DESIGN_BLOCK_TREE_MODEL_ADAPTER::Create(), PROJECT::DesignBlockLibs(), displayErrors(), g_designBlockSearchString, EDA_DRAW_PANEL_GAL::GAL_TYPE_OPENGL, SETTINGS_MANAGER::GetAppSettings(), DESIGN_BLOCK_LIB_TABLE::GetGlobalList(), PGM_BASE::GetSettingsManager(), m_adapter, m_dbl_click_timer, m_frame, m_open_libs_timer, m_preview, m_tree, m_vsplitter, OnChar(), onCloseTimer(), onDesignBlockChosen(), onOpenLibsTimer(), Pgm(), KIWAY_HOLDER::Prj(), DESIGN_BLOCK_LIST_IMPL::ReadDesignBlockFiles(), RefreshLibs(), and LIB_TREE::SetSearchString().

◆ ~PANEL_DESIGN_BLOCK_CHOOSER()

PANEL_DESIGN_BLOCK_CHOOSER::~PANEL_DESIGN_BLOCK_CHOOSER ( )

Definition at line 153 of file panel_design_block_chooser.cpp.

References g_designBlockSearchString, LIB_TREE::GetSearchString(), LIB_TREE::GetSortMode(), Kiface(), m_adapter, m_dbl_click_timer, m_open_libs_timer, m_tree, m_vsplitter, OnChar(), onCloseTimer(), onDesignBlockChosen(), and onDesignBlockSelected().

Member Function Documentation

◆ addDesignBlockToHistory()

void PANEL_DESIGN_BLOCK_CHOOSER::addDesignBlockToHistory ( const LIB_ID & aLibId )

protected

Definition at line 358 of file panel_design_block_chooser.cpp.

References GetSelectedLibId(), m_historyList, m_tree, rebuildHistoryNode(), LIB_TREE::Regenerate(), SelectLibId(), and LIB_TREE::Unselect().

Referenced by onCloseTimer().

◆ displayErrors()

void PANEL_DESIGN_BLOCK_CHOOSER::displayErrors ( wxTopLevelWindow * aWindow )

protected

Definition at line 408 of file panel_design_block_chooser.cpp.

References _, HTML_MESSAGE_BOX::AddHTML_Text(), EscapeHTML(), DESIGN_BLOCK_LIB_TABLE::GetGlobalList(), HTML_MESSAGE_BOX::MessageSet(), and DIALOG_SHIM::ShowModal().

Referenced by PANEL_DESIGN_BLOCK_CHOOSER().

◆ FinishSetup()

void PANEL_DESIGN_BLOCK_CHOOSER::FinishSetup ( )

Definition at line 208 of file panel_design_block_chooser.cpp.

References EESCHEMA_SETTINGS::PANEL_DESIGN_BLOCK_CHOOSER::height, Kiface(), m_adapter, m_vsplitter, EESCHEMA_SETTINGS::PANEL_DESIGN_BLOCK_CHOOSER::sash_pos_h, EESCHEMA_SETTINGS::PANEL_DESIGN_BLOCK_CHOOSER::sash_pos_v, EESCHEMA_SETTINGS::PANEL_DESIGN_BLOCK_CHOOSER::sort_mode, and EESCHEMA_SETTINGS::PANEL_DESIGN_BLOCK_CHOOSER::width.

Referenced by DESIGN_BLOCK_PANE::DESIGN_BLOCK_PANE().

◆ GetLibTree()

LIB_TREE * PANEL_DESIGN_BLOCK_CHOOSER::GetLibTree ( )

inline

Definition at line 77 of file panel_design_block_chooser.h.

References m_tree.

Referenced by SCH_DESIGN_BLOCK_CONTROL::getCurrentTreeNode().

◆ GetSelectedLibId()

LIB_ID PANEL_DESIGN_BLOCK_CHOOSER::GetSelectedLibId ( int * aUnit = nullptr ) const

To be called after this dialog returns from ShowModal().

For multi-unit design_blocks, if the user selects the design_block itself rather than picking an individual unit, 0 will be returned in aUnit. Beware that this is an invalid unit number - this should be replaced with whatever default is desired (usually 1).

Parameters

aUnit if not NULL, the selected unit is filled in here.

Returns: the LIB_ID of the design_block that has been selected.

Definition at line 289 of file panel_design_block_chooser.cpp.

References LIB_TREE::GetSelectedLibId(), and m_tree.

Referenced by addDesignBlockToHistory(), DESIGN_BLOCK_PANE::GetSelectedLibId(), and onDesignBlockSelected().

◆ OnChar()

void PANEL_DESIGN_BLOCK_CHOOSER::OnChar ( wxKeyEvent & aEvent )

Definition at line 184 of file panel_design_block_chooser.cpp.

References LIB_TREE::GetSearchString(), m_tree, and LIB_TREE::SetSearchString().

Referenced by DESIGN_BLOCK_PANE::DESIGN_BLOCK_PANE(), PANEL_DESIGN_BLOCK_CHOOSER(), and ~PANEL_DESIGN_BLOCK_CHOOSER().

◆ onCloseTimer()

void PANEL_DESIGN_BLOCK_CHOOSER::onCloseTimer ( wxTimerEvent & aEvent )

protected

Definition at line 302 of file panel_design_block_chooser.cpp.

References addDesignBlockToHistory(), DBLCLICK_DELAY, LIB_TREE::GetSelectedLibId(), m_dbl_click_timer, m_selectHandler, and m_tree.

Referenced by PANEL_DESIGN_BLOCK_CHOOSER(), and ~PANEL_DESIGN_BLOCK_CHOOSER().

◆ onDesignBlockChosen()

void PANEL_DESIGN_BLOCK_CHOOSER::onDesignBlockChosen ( wxCommandEvent & aEvent )

protected

Handle the selection of an item.

This is called when either the search box or the tree receive an Enter, or the tree receives a double click. If the item selected is a category, it is expanded or collapsed; if it is a design_block, the design_block is picked.

Definition at line 341 of file panel_design_block_chooser.cpp.

References DBLCLICK_DELAY, LIB_TREE::GetSelectedLibId(), LIB_ID::IsValid(), m_dbl_click_timer, and m_tree.

Referenced by PANEL_DESIGN_BLOCK_CHOOSER(), and ~PANEL_DESIGN_BLOCK_CHOOSER().