#include <background_jobs_monitor.h>

Public Member Functions
	BACKGROUND_JOBS_MONITOR ()

std::shared_ptr< BACKGROUND_JOB >	Create (const wxString &aName)
	Creates a background job with the given name.

void	Remove (std::shared_ptr< BACKGROUND_JOB > job)
	Removes the given background job from any lists and frees it.

void	ShowList (wxWindow *aParent, wxPoint aPos)
	Shows the background job list.

void	RegisterStatusBar (KISTATUSBAR *aStatusBar)
	Add a status bar for handling.

void	UnregisterStatusBar (KISTATUSBAR *aStatusBar)
	Removes status bar from handling.

Private Member Functions
void	onListWindowClosed (wxCloseEvent &aEvent)
	Handles removing the shown list window from our list of shown windows.

void	jobUpdated (std::shared_ptr< BACKGROUND_JOB > aJob)
	Handles job status updates, intended to be called by BACKGROUND_JOB_REPORTER only.

Private Attributes
std::vector< std::shared_ptr< BACKGROUND_JOB > >	m_jobs
	Holds a reference to all active background jobs Access to this vector should be protected by locks since threads may Create or Remove at will to register their activity.

std::vector< BACKGROUND_JOB_LIST * >	m_shownDialogs

std::vector< KISTATUSBAR * >	m_statusBars

std::shared_mutex	m_mutex
	Mutex to protect access to the m_jobs vector.

Friends
class	BACKGROUND_JOB_REPORTER

class	BACKGROUND_JOB_LIST

Detailed Description

Definition at line 87 of file background_jobs_monitor.h.

Constructor & Destructor Documentation

◆ BACKGROUND_JOBS_MONITOR()

BACKGROUND_JOBS_MONITOR::BACKGROUND_JOBS_MONITOR ( )

Definition at line 223 of file background_jobs_monitor.cpp.

Referenced by BACKGROUND_JOB_LIST.

Member Function Documentation

◆ Create()

std::shared_ptr< BACKGROUND_JOB > BACKGROUND_JOBS_MONITOR::Create ( const wxString & aName )

Creates a background job with the given name.

Parameters

aName is the displayed title for the event

Definition at line 229 of file background_jobs_monitor.cpp.

References BACKGROUND_JOB_LIST, m_jobs, m_mutex, and m_shownDialogs.

Referenced by BACKGROUND_JOB_LIST, UPDATE_MANAGER::CheckForUpdate(), PGM_BASE::PreloadDesignBlockLibraries(), SCH::IFACE::PreloadLibraries(), and PLUGIN_CONTENT_MANAGER::RunBackgroundUpdate().

◆ jobUpdated()

void BACKGROUND_JOBS_MONITOR::jobUpdated ( std::shared_ptr< BACKGROUND_JOB > aJob )

private

Handles job status updates, intended to be called by BACKGROUND_JOB_REPORTER only.

Definition at line 335 of file background_jobs_monitor.cpp.

References BACKGROUND_JOB_LIST, m_jobs, m_mutex, m_shownDialogs, and m_statusBars.

Referenced by BACKGROUND_JOB_LIST, RegisterStatusBar(), and Remove().

◆ onListWindowClosed()

void BACKGROUND_JOBS_MONITOR::onListWindowClosed ( wxCloseEvent & aEvent )

private

Handles removing the shown list window from our list of shown windows.

Definition at line 298 of file background_jobs_monitor.cpp.

References BACKGROUND_JOB_LIST, and m_shownDialogs.

Referenced by BACKGROUND_JOB_LIST, and ShowList().

◆ RegisterStatusBar()

void BACKGROUND_JOBS_MONITOR::RegisterStatusBar ( KISTATUSBAR * aStatusBar )

Add a status bar for handling.

Definition at line 373 of file background_jobs_monitor.cpp.

References jobUpdated(), m_jobs, and m_statusBars.

Referenced by BACKGROUND_JOB_LIST, EVT_MENU_RANGE(), and SCH_BASE_FRAME::SCH_BASE_FRAME().

◆ Remove()

void BACKGROUND_JOBS_MONITOR::Remove ( std::shared_ptr< BACKGROUND_JOB > job )

Removes the given background job from any lists and frees it.

Definition at line 256 of file background_jobs_monitor.cpp.

References BACKGROUND_JOB_LIST, jobUpdated(), m_jobs, m_mutex, m_shownDialogs, and m_statusBars.

Referenced by BACKGROUND_JOB_LIST, UPDATE_MANAGER::CheckForUpdate(), PGM_BASE::PreloadDesignBlockLibraries(), SCH::IFACE::PreloadLibraries(), and UPDATE_CANCELLER::~UPDATE_CANCELLER().

◆ ShowList()

void BACKGROUND_JOBS_MONITOR::ShowList	(	wxWindow *	aParent,
		wxPoint	aPos )

Shows the background job list.

Definition at line 312 of file background_jobs_monitor.cpp.

References BACKGROUND_JOB_LIST, m_jobs, m_mutex, m_shownDialogs, and onListWindowClosed().

Referenced by BACKGROUND_JOB_LIST, and KISTATUSBAR::onBackgroundProgressClick().

◆ UnregisterStatusBar()

void BACKGROUND_JOBS_MONITOR::UnregisterStatusBar ( KISTATUSBAR * aStatusBar )

Removes status bar from handling.

Definition at line 383 of file background_jobs_monitor.cpp.

References m_statusBars.

Referenced by BACKGROUND_JOB_LIST, KICAD_MANAGER_FRAME::~KICAD_MANAGER_FRAME(), and SCH_BASE_FRAME::~SCH_BASE_FRAME().

Friends And Related Symbol Documentation

◆ BACKGROUND_JOB_LIST

friend class BACKGROUND_JOB_LIST

friend

Definition at line 90 of file background_jobs_monitor.h.

References BACKGROUND_JOB_LIST, BACKGROUND_JOBS_MONITOR(), Create(), jobUpdated(), onListWindowClosed(), RegisterStatusBar(), Remove(), ShowList(), and UnregisterStatusBar().

Referenced by BACKGROUND_JOB_LIST, Create(), jobUpdated(), onListWindowClosed(), Remove(), and ShowList().

◆ BACKGROUND_JOB_REPORTER

friend class BACKGROUND_JOB_REPORTER

friend

Definition at line 89 of file background_jobs_monitor.h.

References BACKGROUND_JOB_REPORTER.

Referenced by BACKGROUND_JOB_REPORTER.

Member Data Documentation

◆ m_jobs

std::vector<std::shared_ptr<BACKGROUND_JOB> > BACKGROUND_JOBS_MONITOR::m_jobs

private

Holds a reference to all active background jobs Access to this vector should be protected by locks since threads may Create or Remove at will to register their activity.

Definition at line 138 of file background_jobs_monitor.h.

Referenced by Create(), jobUpdated(), RegisterStatusBar(), Remove(), and ShowList().

◆ m_mutex

std::shared_mutex BACKGROUND_JOBS_MONITOR::m_mutex

mutableprivate

Mutex to protect access to the m_jobs vector.

Definition at line 144 of file background_jobs_monitor.h.

Referenced by Create(), jobUpdated(), Remove(), and ShowList().

◆ m_shownDialogs

std::vector<BACKGROUND_JOB_LIST*> BACKGROUND_JOBS_MONITOR::m_shownDialogs

private

Definition at line 139 of file background_jobs_monitor.h.

Referenced by Create(), jobUpdated(), onListWindowClosed(), Remove(), and ShowList().

◆ m_statusBars

std::vector<KISTATUSBAR*> BACKGROUND_JOBS_MONITOR::m_statusBars

private

Definition at line 141 of file background_jobs_monitor.h.

Referenced by jobUpdated(), RegisterStatusBar(), Remove(), and UnregisterStatusBar().

The documentation for this class was generated from the following files:

Public Member Functions

Private Member Functions

Private Attributes

Friends

Detailed Description

Constructor & Destructor Documentation

◆ BACKGROUND_JOBS_MONITOR()

Member Function Documentation

◆ Create()

◆ jobUpdated()

◆ onListWindowClosed()

◆ RegisterStatusBar()

◆ Remove()

◆ ShowList()

◆ UnregisterStatusBar()

Friends And Related Symbol Documentation

◆ BACKGROUND_JOB_LIST

◆ BACKGROUND_JOB_REPORTER

Member Data Documentation

◆ m_jobs

◆ m_mutex

◆ m_shownDialogs

◆ m_statusBars