A widget for browsing a rich text error/status report. More...

#include <wx_html_report_panel.h>

Inheritance diagram for WX_HTML_REPORT_PANEL:

Classes
struct	REPORT_LINE

Public Member Functions
	WX_HTML_REPORT_PANEL (wxWindow *parent, wxWindowID id=wxID_ANY, const wxPoint &pos=wxDefaultPosition, const wxSize &size=wxSize(500, 300), long style=wxTAB_TRAVERSAL)

	~WX_HTML_REPORT_PANEL ()

void	MsgPanelSetMinSize (const wxSize &aMinSize)
	Set the min size of the area which displays html messages.

REPORTER &	Reporter ()
	Return the reporter object that reports to this panel.

void	Report (const wxString &aText, SEVERITY aSeverity, REPORTER::LOCATION aLocation=REPORTER::LOC_BODY)
	Report the string.

void	Clear ()
	Clears the report panel.

int	Count (int severityMask)
	Return the number of messages matching the given severity mask.

void	SetLabel (const wxString &aLabel) override
	Set the frame label.

void	SetLazyUpdate (bool aLazyUpdate)
	Set the lazy update.

void	Flush (bool aSort=false)
	Force updating the HTML page, after the report is built in lazy mode If aSort = true, the body messages will be ordered by severity.

int	GetVisibleSeverities () const

void	SetFileName (const wxString &aReportFileName)
	Set the report full file name to the string.

wxString &	GetFileName (void)

Protected Attributes
wxStaticBoxSizer *	m_box

wxFlexGridSizer *	m_fgSizer

HTML_WINDOW *	m_htmlView

wxStaticText *	m_staticTextShow

wxCheckBox *	m_checkBoxShowAll

wxCheckBox *	m_checkBoxShowErrors

NUMBER_BADGE *	m_errorsBadge

wxCheckBox *	m_checkBoxShowWarnings

NUMBER_BADGE *	m_warningsBadge

wxCheckBox *	m_checkBoxShowActions

wxCheckBox *	m_checkBoxShowInfos

wxButton *	m_btnSaveReportToFile

Private Types
typedef std::vector< REPORT_LINE >	REPORT_LINES

Private Member Functions
wxString	generateHtml (const REPORT_LINE &aLine)

wxString	generatePlainText (const REPORT_LINE &aLine)

void	updateBadges ()

void	scrollToBottom ()

void	onRightClick (wxMouseEvent &event) override

void	onMenuEvent (wxMenuEvent &event)

void	onCheckBox (wxCommandEvent &event) override

void	onBtnSaveToFile (wxCommandEvent &event) override

void	onThemeChanged (wxSysColourChangedEvent &aEvent)

Private Attributes
WX_HTML_PANEL_REPORTER	m_reporter

REPORT_LINES	m_report
	copy of the report, stored for filtering

REPORT_LINES	m_reportTail
	Lines to print at the end, regardless of sorting.

REPORT_LINES	m_reportHead
	... and at the beginning, regardless of sorting

bool	m_lazyUpdate

wxString	m_reportFileName
	defaults to the not very useful /bin/report.txt

Detailed Description

A widget for browsing a rich text error/status report.

Used in numerous dialogs in Eeschema and Pcbnew. Provides error filtering functionality and saving report files. The messages are reported through a REPORTER object

Definition at line 61 of file wx_html_report_panel.h.

Member Typedef Documentation

◆ REPORT_LINES

typedef std::vector<REPORT_LINE> WX_HTML_REPORT_PANEL::REPORT_LINES

private

Definition at line 119 of file wx_html_report_panel.h.

Constructor & Destructor Documentation

◆ WX_HTML_REPORT_PANEL()

WX_HTML_REPORT_PANEL::WX_HTML_REPORT_PANEL	(	wxWindow *	parent,
		wxWindowID	id = wxID_ANY,
		const wxPoint &	pos = wxDefaultPosition,
		const wxSize &	size = wxSize( 500, 300 ),
		long	style = wxTAB_TRAVERSAL )

Definition at line 40 of file wx_html_report_panel.cpp.

References Flush(), KIUI::GetInfoFont(), WX_HTML_REPORT_PANEL_BASE::m_htmlView, m_lazyUpdate, m_reporter, onMenuEvent(), onThemeChanged(), and WX_HTML_REPORT_PANEL_BASE::WX_HTML_REPORT_PANEL_BASE().

◆ ~WX_HTML_REPORT_PANEL()

WX_HTML_REPORT_PANEL::~WX_HTML_REPORT_PANEL ( )

Definition at line 56 of file wx_html_report_panel.cpp.

Member Function Documentation

◆ Clear()

void WX_HTML_REPORT_PANEL::Clear ( )

Clears the report panel.

Definition at line 348 of file wx_html_report_panel.cpp.

References m_report, m_reportHead, and m_reportTail.

◆ Count()

int WX_HTML_REPORT_PANEL::Count ( int severityMask )

Return the number of messages matching the given severity mask.

Definition at line 152 of file wx_html_report_panel.cpp.

References m_report, m_reportHead, and m_reportTail.

Referenced by updateBadges().

◆ Flush()

void WX_HTML_REPORT_PANEL::Flush ( bool aSort = false )

Force updating the HTML page, after the report is built in lazy mode If aSort = true, the body messages will be ordered by severity.

Definition at line 103 of file wx_html_report_panel.cpp.

References generateHtml(), WX_HTML_REPORT_PANEL_BASE::m_htmlView, m_report, m_reportHead, m_reportTail, and scrollToBottom().

Referenced by onCheckBox(), onThemeChanged(), and WX_HTML_REPORT_PANEL().

◆ generateHtml()

wxString WX_HTML_REPORT_PANEL::generateHtml ( const REPORT_LINE & aLine )

private

Definition at line 169 of file wx_html_report_panel.cpp.

References _, GetVisibleSeverities(), KIPLATFORM::UI::IsDarkTheme(), WX_HTML_REPORT_PANEL::REPORT_LINE::message, RPT_SEVERITY_ACTION, RPT_SEVERITY_ERROR, RPT_SEVERITY_INFO, RPT_SEVERITY_WARNING, and WX_HTML_REPORT_PANEL::REPORT_LINE::severity.

Referenced by Flush(), and Report().

◆ generatePlainText()

wxString WX_HTML_REPORT_PANEL::generatePlainText ( const REPORT_LINE & aLine )

private

Definition at line 229 of file wx_html_report_panel.cpp.

References _, WX_HTML_REPORT_PANEL::REPORT_LINE::message, RPT_SEVERITY_ERROR, RPT_SEVERITY_INFO, RPT_SEVERITY_WARNING, and WX_HTML_REPORT_PANEL::REPORT_LINE::severity.

Referenced by onBtnSaveToFile().

◆ GetFileName()

wxString & WX_HTML_REPORT_PANEL::GetFileName ( void )

inline

Returns: reference to the current report fill file name string.

Definition at line 110 of file wx_html_report_panel.h.

References m_reportFileName.

◆ GetVisibleSeverities()

int WX_HTML_REPORT_PANEL::GetVisibleSeverities ( ) const

Returns: the visible severity filter. If the m_showAll option is set, the mask is < 0

Definition at line 362 of file wx_html_report_panel.cpp.

References WX_HTML_REPORT_PANEL_BASE::m_checkBoxShowActions, WX_HTML_REPORT_PANEL_BASE::m_checkBoxShowErrors, WX_HTML_REPORT_PANEL_BASE::m_checkBoxShowInfos, WX_HTML_REPORT_PANEL_BASE::m_checkBoxShowWarnings, RPT_SEVERITY_ACTION, RPT_SEVERITY_ERROR, RPT_SEVERITY_INFO, and RPT_SEVERITY_WARNING.

Referenced by generateHtml(), and onCheckBox().

◆ MsgPanelSetMinSize()

void WX_HTML_REPORT_PANEL::MsgPanelSetMinSize ( const wxSize & aMinSize )

Set the min size of the area which displays html messages.

Definition at line 69 of file wx_html_report_panel.cpp.

References WX_HTML_REPORT_PANEL_BASE::m_fgSizer.

◆ onBtnSaveToFile()

void WX_HTML_REPORT_PANEL::onBtnSaveToFile ( wxCommandEvent & event )

overrideprivatevirtual

Reimplemented from WX_HTML_REPORT_PANEL_BASE.

Definition at line 294 of file wx_html_report_panel.cpp.

References _, ConvertSmartQuotesAndDashes(), generatePlainText(), m_report, m_reportFileName, m_reportHead, m_reportTail, and FILEEXT::TextFileWildcard().

◆ onCheckBox()

void WX_HTML_REPORT_PANEL::onCheckBox ( wxCommandEvent & event )

overrideprivatevirtual

Reimplemented from WX_HTML_REPORT_PANEL_BASE.

Definition at line 273 of file wx_html_report_panel.cpp.

References Flush(), GetVisibleSeverities(), WX_HTML_REPORT_PANEL_BASE::m_checkBoxShowActions, WX_HTML_REPORT_PANEL_BASE::m_checkBoxShowAll, WX_HTML_REPORT_PANEL_BASE::m_checkBoxShowErrors, WX_HTML_REPORT_PANEL_BASE::m_checkBoxShowInfos, WX_HTML_REPORT_PANEL_BASE::m_checkBoxShowWarnings, and RPT_SEVERITY_ALL.

◆ onMenuEvent()

void WX_HTML_REPORT_PANEL::onMenuEvent ( wxMenuEvent & event )

private

Definition at line 249 of file wx_html_report_panel.cpp.

References WX_HTML_REPORT_PANEL_BASE::m_htmlView.

Referenced by WX_HTML_REPORT_PANEL().

◆ onRightClick()

void WX_HTML_REPORT_PANEL::onRightClick ( wxMouseEvent & event )

overrideprivatevirtual

Reimplemented from WX_HTML_REPORT_PANEL_BASE.

Definition at line 241 of file wx_html_report_panel.cpp.

◆ onThemeChanged()

void WX_HTML_REPORT_PANEL::onThemeChanged ( wxSysColourChangedEvent & aEvent )

private

Definition at line 61 of file wx_html_report_panel.cpp.

References Flush().

Referenced by WX_HTML_REPORT_PANEL().

◆ Report()

void WX_HTML_REPORT_PANEL::Report	(	const wxString &	aText,
		SEVERITY	aSeverity,
		REPORTER::LOCATION	aLocation = REPORTER::LOC_BODY )

Report the string.

Parameters

aText	string message to report.
aSeverity	string classification level bitfield.
aLocation	REPORTER::LOCATION enum for placement of message.

Definition at line 82 of file wx_html_report_panel.cpp.

References generateHtml(), REPORTER::LOC_HEAD, REPORTER::LOC_TAIL, WX_HTML_REPORT_PANEL_BASE::m_htmlView, m_lazyUpdate, m_report, m_reportHead, m_reportTail, WX_HTML_REPORT_PANEL::REPORT_LINE::message, scrollToBottom(), and WX_HTML_REPORT_PANEL::REPORT_LINE::severity.

◆ Reporter()

REPORTER & WX_HTML_REPORT_PANEL::Reporter ( )

Return the reporter object that reports to this panel.

Definition at line 76 of file wx_html_report_panel.cpp.

References m_reporter.

◆ scrollToBottom()

void WX_HTML_REPORT_PANEL::scrollToBottom ( )

private

Definition at line 130 of file wx_html_report_panel.cpp.

References WX_HTML_REPORT_PANEL_BASE::m_htmlView, and updateBadges().

Referenced by Flush(), and Report().

◆ SetFileName()

void WX_HTML_REPORT_PANEL::SetFileName ( const wxString & aReportFileName )

inline

Set the report full file name to the string.

Definition at line 107 of file wx_html_report_panel.h.

References m_reportFileName.

◆ SetLabel()

void WX_HTML_REPORT_PANEL::SetLabel ( const wxString & aLabel )

override

Set the frame label.

Definition at line 356 of file wx_html_report_panel.cpp.

References WX_HTML_REPORT_PANEL_BASE::m_box.

◆ SetLazyUpdate()

void WX_HTML_REPORT_PANEL::SetLazyUpdate ( bool aLazyUpdate )

inline

Set the lazy update.

If this mode is on, messages are stored but the display is not updated (Updating display can be very time consuming if there are many messages) A call to Flush() will be needed after build the report

Definition at line 96 of file wx_html_report_panel.h.

References m_lazyUpdate.