PROGRESS_REPORTER Class Reference

A progress reporter interface for use in multi-threaded environments. More...

#include <progress_reporter.h>

Inheritance diagram for PROGRESS_REPORTER:

Public Member Functions
	PROGRESS_REPORTER ()
	PROGRESS_REPORTER (const PROGRESS_REPORTER &)=delete
virtual	~PROGRESS_REPORTER ()
virtual void	SetNumPhases (int aNumPhases)=0
	Set the number of phases. More...
virtual void	AddPhases (int aNumPhases)=0
virtual void	BeginPhase (int aPhase)=0
	Initialize the aPhase virtual zone of the dialog progress bar. More...
virtual void	AdvancePhase ()=0
	Use the next available virtual zone of the dialog progress bar. More...
virtual void	AdvancePhase (const wxString &aMessage)=0
	Use the next available virtual zone of the dialog progress bar and updates the message. More...
virtual void	Report (const wxString &aMessage)=0
	Display aMessage in the progress bar dialog. More...
virtual void	SetCurrentProgress (double aProgress)=0
	Set the progress value to aProgress (0..1). More...
virtual void	SetMaxProgress (int aMaxProgress)=0
	Fix the value that gives the 100 percent progress bar length (inside the current virtual zone). More...
virtual void	AdvanceProgress ()=0
	Increment the progress bar length (inside the current virtual zone). More...
virtual bool	KeepRefreshing (bool aWait=false)=0
	Update the UI (if any). More...
virtual void	SetTitle (const wxString &aTitle)=0
	Change the title displayed on the window caption. More...
virtual bool	IsCancelled () const =0

Detailed Description

A progress reporter interface for use in multi-threaded environments.

The various advancement and message methods can be called from sub-threads. The KeepRefreshing method MUST be called only from the main thread (primarily a MSW requirement, which won't allow access to UI objects allocated from a separate thread).

Definition at line 36 of file progress_reporter.h.

Constructor & Destructor Documentation

PROGRESS_REPORTER() [1/2]

PROGRESS_REPORTER::PROGRESS_REPORTER ( )

inline

Definition at line 40 of file progress_reporter.h.

 { }

PROGRESS_REPORTER() [2/2]

PROGRESS_REPORTER::PROGRESS_REPORTER ( const PROGRESS_REPORTER &  )

delete

~PROGRESS_REPORTER()

virtual PROGRESS_REPORTER::~PROGRESS_REPORTER ( )

inlinevirtual

Definition at line 45 of file progress_reporter.h.

 { }

Member Function Documentation

AddPhases()

virtual void PROGRESS_REPORTER::AddPhases ( int  aNumPhases )

pure virtual

Implemented in PROGRESS_REPORTER_BASE.

AdvancePhase() [1/2]

virtual void PROGRESS_REPORTER::AdvancePhase ( )

pure virtual

Use the next available virtual zone of the dialog progress bar.

Implemented in PROGRESS_REPORTER_BASE, and DIALOG_PCM_PROGRESS.

Referenced by ZONE_FILLER::Fill(), FOOTPRINT_LIST_IMPL::ReadFootprintFiles(), DRC_ENGINE::ReportPhase(), DRC_TOOL::RunTests(), and SYMBOL_ASYNC_LOADER::worker().

AdvancePhase() [2/2]

virtual void PROGRESS_REPORTER::AdvancePhase ( const wxString &  aMessage )

pure virtual

Use the next available virtual zone of the dialog progress bar and updates the message.

Implemented in DIALOG_DRC, PROGRESS_REPORTER_BASE, and DIALOG_ERC.

AdvanceProgress()

virtual void PROGRESS_REPORTER::AdvanceProgress ( )

pure virtual

Increment the progress bar length (inside the current virtual zone).

Implemented in PROGRESS_REPORTER_BASE.

Referenced by AR_AUTOPLACER::AutoplaceFootprints(), CADSTAR_ARCHIVE_PARSER::checkPoint(), ZONE_FILLER::Fill(), FOOTPRINT_LIST_IMPL::joinWorkers(), and FOOTPRINT_LIST_IMPL::loader_job().

BeginPhase()

virtual void PROGRESS_REPORTER::BeginPhase ( int  aPhase )

pure virtual

Initialize the aPhase virtual zone of the dialog progress bar.

Implemented in PROGRESS_REPORTER_BASE.

Referenced by CADSTAR_PCB_ARCHIVE_LOADER::Load(), CADSTAR_SCH_ARCHIVE_LOADER::Load(), CADSTAR_SCH_ARCHIVE_PARSER::Parse(), and CADSTAR_PCB_ARCHIVE_PARSER::Parse().

IsCancelled()

virtual bool PROGRESS_REPORTER::IsCancelled ( ) const

pure virtual

Implemented in PROGRESS_REPORTER_BASE.

Referenced by ZONE_FILLER::computeRawFilledArea(), ZONE_FILLER::Fill(), ZONE_FILLER::fillSingleZone(), CN_CONNECTIVITY_ALGO::SearchClusters(), and SYMBOL_ASYNC_LOADER::worker().

KeepRefreshing()

virtual bool PROGRESS_REPORTER::KeepRefreshing ( bool  aWait = false )

pure virtual

Update the UI (if any).

Warning

This should only be called from the main thread.

Returns

false if the user cancelled.

Implemented in PROGRESS_REPORTER_BASE.

Referenced by AR_AUTOPLACER::AutoplaceFootprints(), CONNECTIVITY_DATA::Build(), SCH_SEXPR_PARSER::checkpoint(), LEGACY_PLUGIN::checkpoint(), SCH_EAGLE_PLUGIN::checkpoint(), ALTIUM_PCB::checkpoint(), SCH_LEGACY_PLUGIN::checkpoint(), EAGLE_PLUGIN::checkpoint(), FABMASTER::checkpoint(), CADSTAR_ARCHIVE_PARSER::checkPoint(), PCB_DRAW_PANEL_GAL::DisplayBoard(), ZONE_FILLER::Fill(), FOOTPRINT_LIST_IMPL::joinWorkers(), FABMASTER_PLUGIN::Load(), LEGACY_PLUGIN::Load(), SCH_EAGLE_PLUGIN::Load(), EAGLE_PLUGIN::Load(), PCB_PLUGIN::Load(), CADSTAR_ARCHIVE_PARSER::LoadArchiveFile(), SCH_SEXPR_PLUGIN::loadFile(), SCH_LEGACY_PLUGIN::loadFile(), SYMBOL_LIBRARY_MANAGER::Preload(), FOOTPRINT_LIST_IMPL::ReadFootprintFiles(), DRC_ENGINE::ReportPhase(), DRC_ENGINE::ReportProgress(), reportProgress(), and CN_CONNECTIVITY_ALGO::searchConnections().

Report()

virtual void PROGRESS_REPORTER::Report ( const wxString &  aMessage )

pure virtual

Display aMessage in the progress bar dialog.

Implemented in PROGRESS_REPORTER_BASE, and DIALOG_ERC.

Referenced by AR_AUTOPLACER::AutoplaceFootprints(), ZONE_FILLER::Fill(), FABMASTER_PLUGIN::Load(), LEGACY_PLUGIN::Load(), SCH_EAGLE_PLUGIN::Load(), EAGLE_PLUGIN::Load(), PCB_PLUGIN::Load(), SCH_SEXPR_PLUGIN::loadFile(), SCH_LEGACY_PLUGIN::loadFile(), ALTIUM_PCB::ParseArcs6Data(), ALTIUM_PCB::ParseBoard6Data(), ALTIUM_PCB::ParseBoardRegionsData(), ALTIUM_PCB::ParseClasses6Data(), ALTIUM_PCB::ParseComponents6Data(), ALTIUM_PCB::ParseComponentsBodies6Data(), ALTIUM_PCB::ParseDimensions6Data(), ALTIUM_PCB::ParseFills6Data(), ALTIUM_PCB::ParseModelsData(), ALTIUM_PCB::ParseNets6Data(), ALTIUM_PCB::ParsePads6Data(), ALTIUM_PCB::ParsePolygons6Data(), ALTIUM_PCB::ParseRegions6Data(), ALTIUM_PCB::ParseRules6Data(), ALTIUM_PCB::ParseShapeBasedRegions6Data(), ALTIUM_PCB::ParseTexts6Data(), ALTIUM_PCB::ParseTracks6Data(), ALTIUM_PCB::ParseVias6Data(), ALTIUM_PCB::ParseWideStrings6Data(), and FOOTPRINT_LIST_IMPL::ReadFootprintFiles().

SetCurrentProgress()

virtual void PROGRESS_REPORTER::SetCurrentProgress ( double  aProgress )

pure virtual

Set the progress value to aProgress (0..1).

Implemented in CONSOLE_PROGRESS_REPORTER, and PROGRESS_REPORTER_BASE.

Referenced by CONNECTIVITY_DATA::Build(), SCH_SEXPR_PARSER::checkpoint(), SCH_EAGLE_PLUGIN::checkpoint(), LEGACY_PLUGIN::checkpoint(), ALTIUM_PCB::checkpoint(), SCH_LEGACY_PLUGIN::checkpoint(), EAGLE_PLUGIN::checkpoint(), FABMASTER::checkpoint(), CADSTAR_ARCHIVE_PARSER::LoadArchiveFile(), DRC_ENGINE::ReportProgress(), and reportProgress().

SetMaxProgress()

virtual void PROGRESS_REPORTER::SetMaxProgress ( int  aMaxProgress )

pure virtual

Fix the value that gives the 100 percent progress bar length (inside the current virtual zone).

Implemented in PROGRESS_REPORTER_BASE.

Referenced by AR_AUTOPLACER::AutoplaceFootprints(), ZONE_FILLER::Fill(), CADSTAR_PCB_ARCHIVE_LOADER::Load(), CADSTAR_SCH_ARCHIVE_LOADER::Load(), CADSTAR_SCH_ARCHIVE_PARSER::Parse(), CADSTAR_PCB_ARCHIVE_PARSER::Parse(), FOOTPRINT_LIST_IMPL::ReadFootprintFiles(), and CN_CONNECTIVITY_ALGO::searchConnections().

SetNumPhases()

virtual void PROGRESS_REPORTER::SetNumPhases ( int  aNumPhases )

pure virtual

Set the number of phases.

Implemented in PROGRESS_REPORTER_BASE.

Referenced by CADSTAR_PCB_ARCHIVE_LOADER::Load(), and CADSTAR_SCH_ARCHIVE_LOADER::Load().

SetTitle()

virtual void PROGRESS_REPORTER::SetTitle ( const wxString &  aTitle )

pure virtual

Change the title displayed on the window caption.

Has meaning only for some reporters. Does nothing for others.

Warning

This should only be called from the main thread.

Implemented in PROGRESS_REPORTER_BASE, and WX_PROGRESS_REPORTER.

Referenced by AR_AUTOPLACER::AutoplaceFootprints().

---

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

• progress_reporter.h