A modified version of the wxInfoBar class that allows us to: More...

#include <wx_infobar.h>

Inheritance diagram for WX_INFOBAR:

Public Types
enum class	MESSAGE_TYPE { GENERIC , OUTDATED_SAVE , DRC_RULES_ERROR , DRC_VIOLATION }
	Sets the type of message for special handling if needed. More...

Public Member Functions
	WX_INFOBAR (wxWindow aParent, wxAuiManager aMgr=nullptr, wxWindowID aWinid=wxID_ANY)
	Construct an infobar that can exist inside an AUI managed frame.

	~WX_INFOBAR ()

MESSAGE_TYPE	GetMessageType () const

void	SetShowTime (int aTime)
	Set the time period to show the infobar.

void	AddCloseButton (const wxString &aTooltip=_("Hide this message."))
	Add the default close button to the infobar on the right side.

void	AddButton (wxButton *aButton)
	Add an already created button to the infobar.

void	AddButton (wxHyperlinkCtrl *aHypertextButton)
	Add an already created hypertext link to the infobar.

void	AddButton (wxWindowID aId, const wxString &aLabel=wxEmptyString) override
	Add a button with the provided ID and text.

void	RemoveAllButtons ()
	Remove all the buttons that have been added by the user.

bool	HasCloseButton () const

wxBitmapButton *	GetCloseButton () const

void	SetCallback (std::function< void(void)> aCallback)
	Provide a callback to be called when the infobar is dismissed (either by user action or timer).

void	ShowMessageFor (const wxString &aMessage, int aTime, int aFlags=wxICON_INFORMATION, MESSAGE_TYPE aType=WX_INFOBAR::MESSAGE_TYPE::GENERIC)
	Show the infobar with the provided message and icon for a specific period of time.

void	ShowMessage (const wxString &aMessage, int aFlags=wxICON_INFORMATION) override
	Show the info bar with the provided message and icon.

void	ShowMessage (const wxString &aMessage, int aFlags, MESSAGE_TYPE aType)
	Show the info bar with the provided message and icon, setting the type.

void	Dismiss () override
	Dismisses the infobar and updates the containing layout and AUI manager (if one is provided).

void	QueueShowMessage (const wxString &aMessage, int aFlags=wxICON_INFORMATION)
	Send the infobar an event telling it to show a message.

void	QueueDismiss ()
	Send the infobar an event telling it to hide itself.

bool	IsLocked ()
	Returns true if the infobar is being updated.

Protected Member Functions
void	onShowInfoBar (wxCommandEvent &aEvent)
	Event handler for showing the infobar using a wxCommandEvent of the type KIEVT_SHOW_INFOBAR.

void	onDismissInfoBar (wxCommandEvent &aEvent)
	Event handler for dismissing the infobar using a wxCommandEvent of the type KIEVT_DISMISS_INFOBAR.

void	onCloseButton (wxCommandEvent &aEvent)
	Event handler for the close button.

void	onThemeChange (wxSysColourChangedEvent &aEvent)
	Event handler for the color theme change event.

void	onTimer (wxTimerEvent &aEvent)
	Event handler for the automatic closing timer.

void	onSize (wxSizeEvent &aEvent)

void	updateAuiLayout (bool aShow)
	Update the AUI pane to show or hide this infobar.

Protected Attributes
int	m_showTime
	The time to show the infobar. 0 = don't auto hide.

bool	m_updateLock
	True if this infobar requested the UI update.

wxTimer *	m_showTimer
	The timer counting the autoclose period.

wxAuiManager *	m_auiManager
	The AUI manager that contains this infobar.

MESSAGE_TYPE	m_type
	The type of message being displayed.

wxString	m_message
	The original message without wrapping.

std::optional< std::function< void(void)> >	m_callback
	Optional callback made when closing infobar.

Detailed Description

A modified version of the wxInfoBar class that allows us to:

Show the close button along with the other buttons
Remove all user-provided buttons at once
Allow automatically hiding the infobar after a time period
Show/hide using events
Place it inside an AUI manager

This inherits from the generic infobar because the native infobar on GTK doesn't include the icon on the left and it looks worse.

There are 2 events associated with the infobar:

KIEVT_SHOW_INFOBAR: An event that tells the infobar to show a message.

The message text is contained inside the string component, and the message flag is contained inside the int component.

Sample event creation code: wxCommandEvent* evt = new wxCommandEvent( KIEVT_SHOW_INFOBAR ); evt->SetString( "A message to show" ); evt->SetInt( wxICON_WARNING );

KIEVT_DISMISS_INFOBAR: An event that tells the infobar to hide itself.

Definition at line 75 of file wx_infobar.h.

Member Enumeration Documentation

◆ MESSAGE_TYPE

enum class WX_INFOBAR::MESSAGE_TYPE

strong

Sets the type of message for special handling if needed.

Enumerator
GENERIC	GENERIC Are messages that do not have special handling.
OUTDATED_SAVE	OUTDATED_SAVE Messages that should be cleared on save.
DRC_RULES_ERROR
DRC_VIOLATION

Definition at line 93 of file wx_infobar.h.

Constructor & Destructor Documentation

◆ WX_INFOBAR()

WX_INFOBAR::WX_INFOBAR	(	wxWindow *	aParent,
		wxAuiManager *	aMgr = nullptr,
		wxWindowID	aWinid = wxID_ANY )

Construct an infobar that can exist inside an AUI managed frame.

Parameters

aParent	is the parent
aMgr	is the AUI manager that this infobar is added to
aWinId	is the ID for this infobar object

Definition at line 54 of file wx_infobar.cpp.

References GENERIC, DPI_SCALING_COMMON::GetContentScaleFactor(), KIPLATFORM::UI::GetInfoBarColours(), ID_CLOSE_INFOBAR, m_auiManager, m_showTime, m_showTimer, m_type, m_updateLock, onSize(), RemoveAllButtons(), and WX_INFOBAR().

Referenced by WX_INFOBAR().

◆ ~WX_INFOBAR()

WX_INFOBAR::~WX_INFOBAR ( )

Definition at line 110 of file wx_infobar.cpp.

References m_showTimer, and onSize().

Member Function Documentation

◆ AddButton() [1/3]

void WX_INFOBAR::AddButton ( wxButton * aButton )

Add an already created button to the infobar.

New buttons are added in the right-most position.

Parameters

aButton is the button to add

Definition at line 335 of file wx_infobar.cpp.

Referenced by AddButton(), AddCloseButton(), ZONE_FILLER_TOOL::FillAllZones(), APPEARANCE_CONTROLS::onReadOnlySwatch(), SYMBOL_EDIT_FRAME::SetCurSymbol(), PCB_CONTROL::unfilledZoneCheck(), and ZONE_FILLER_TOOL::ZoneFillDirty().

◆ AddButton() [2/3]

void WX_INFOBAR::AddButton ( wxHyperlinkCtrl * aHypertextButton )

Add an already created hypertext link to the infobar.

New buttons are added in the right-most position.

Parameters

aHypertextButton is the button to add

Definition at line 356 of file wx_infobar.cpp.

◆ AddButton() [3/3]

void WX_INFOBAR::AddButton	(	wxWindowID	aId,
		const wxString &	aLabel = wxEmptyString )

override

Add a button with the provided ID and text.

The new button is created on the right-most position.

Parameters

aId	is the ID to assign to the button
aLabel	is the text for the button

Definition at line 327 of file wx_infobar.cpp.

References AddButton().

◆ AddCloseButton()

void WX_INFOBAR::AddCloseButton ( const wxString & aTooltip = _( "Hide this message." ) )

Add the default close button to the infobar on the right side.

Parameters

aTooltip is the tooltip to give the close button

Definition at line 369 of file wx_infobar.cpp.

References AddButton(), and ID_CLOSE_INFOBAR.

Referenced by APPEARANCE_CONTROLS::onReadOnlySwatch(), onShowInfoBar(), onThemeChange(), and APPEARANCE_CONTROLS_3D::rebuildLayers().

◆ Dismiss()

void WX_INFOBAR::Dismiss ( )

override

Dismisses the infobar and updates the containing layout and AUI manager (if one is provided).

Definition at line 193 of file wx_infobar.cpp.

References m_auiManager, m_callback, m_updateLock, and updateAuiLayout().

Referenced by DRAWING_TOOL::DrawVia(), SYMBOL_EDIT_FRAME::LoadOneLibrarySymbolAux(), onCloseButton(), onDismissInfoBar(), onTimer(), PCB_EDIT_FRAME::OpenProjectFiles(), FOOTPRINT_EDITOR_CONTROL::SaveAs(), and SYMBOL_EDIT_FRAME::SetCurSymbol().

◆ GetCloseButton()

wxBitmapButton * WX_INFOBAR::GetCloseButton ( ) const

Definition at line 409 of file wx_infobar.cpp.

References ID_CLOSE_INFOBAR.

Referenced by HasCloseButton(), and onThemeChange().

◆ GetMessageType()

MESSAGE_TYPE WX_INFOBAR::GetMessageType ( ) const

inline

Definition at line 101 of file wx_infobar.h.

References m_type.

Referenced by DRAWING_TOOL::DrawVia().

◆ HasCloseButton()

bool WX_INFOBAR::HasCloseButton ( ) const

Definition at line 403 of file wx_infobar.cpp.

References GetCloseButton().

Referenced by FOOTPRINT_EDITOR_CONTROL::SaveAs().

◆ IsLocked()

bool WX_INFOBAR::IsLocked ( )

inline

Returns true if the infobar is being updated.

Definition at line 215 of file wx_infobar.h.

References m_updateLock.

Referenced by EDA_DRAW_PANEL_GAL::onSize().

◆ onCloseButton()

void WX_INFOBAR::onCloseButton ( wxCommandEvent & aEvent )

protected

Event handler for the close button.

This is bound to ID_CLOSE_INFOBAR on the infobar.

Definition at line 445 of file wx_infobar.cpp.

References Dismiss().

Referenced by wxDEFINE_EVENT().

◆ onDismissInfoBar()

void WX_INFOBAR::onDismissInfoBar ( wxCommandEvent & aEvent )

protected

Event handler for dismissing the infobar using a wxCommandEvent of the type KIEVT_DISMISS_INFOBAR.

Definition at line 439 of file wx_infobar.cpp.

References Dismiss().

Referenced by wxDEFINE_EVENT().

◆ onShowInfoBar()

void WX_INFOBAR::onShowInfoBar ( wxCommandEvent & aEvent )

protected

Event handler for showing the infobar using a wxCommandEvent of the type KIEVT_SHOW_INFOBAR.

The message is stored inside the string field, and the icon flag is stored inside the int field.

Definition at line 431 of file wx_infobar.cpp.

References AddCloseButton(), RemoveAllButtons(), and ShowMessage().

Referenced by wxDEFINE_EVENT().

◆ onSize()

void WX_INFOBAR::onSize ( wxSizeEvent & aEvent )

protected

Definition at line 232 of file wx_infobar.cpp.

References TOOLS_HOLDER::GetToolCanvas(), and m_message.

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

◆ onThemeChange()

void WX_INFOBAR::onThemeChange ( wxSysColourChangedEvent & aEvent )

protected

Event handler for the color theme change event.

Definition at line 216 of file wx_infobar.cpp.

References AddCloseButton(), GetCloseButton(), KIPLATFORM::UI::GetInfoBarColours(), and RemoveAllButtons().

Referenced by wxDEFINE_EVENT().

◆ onTimer()

void WX_INFOBAR::onTimer ( wxTimerEvent & aEvent )

protected

Event handler for the automatic closing timer.

Definition at line 451 of file wx_infobar.cpp.

References Dismiss(), m_showTime, and m_showTimer.

Referenced by wxDEFINE_EVENT().

◆ QueueDismiss()

void WX_INFOBAR::QueueDismiss ( )

Send the infobar an event telling it to hide itself.

Definition at line 135 of file wx_infobar.cpp.

◆ QueueShowMessage()

void WX_INFOBAR::QueueShowMessage	(	const wxString &	aMessage,
		int	aFlags = wxICON_INFORMATION )

Send the infobar an event telling it to show a message.

Parameters

aMessage	is the message to display
aFlags	is the flag containing the icon to display on the left side of the infobar

Definition at line 124 of file wx_infobar.cpp.

◆ RemoveAllButtons()

void WX_INFOBAR::RemoveAllButtons ( )

Remove all the buttons that have been added by the user.

Definition at line 379 of file wx_infobar.cpp.

Referenced by PAD_TOOL::enterPadEditMode(), ZONE_FILLER_TOOL::FillAllZones(), APPEARANCE_CONTROLS::onReadOnlySwatch(), onShowInfoBar(), onThemeChange(), APPEARANCE_CONTROLS_3D::rebuildLayers(), SYMBOL_EDIT_FRAME::SetCurSymbol(), PCB_CONTROL::unfilledZoneCheck(), WX_INFOBAR(), and ZONE_FILLER_TOOL::ZoneFillDirty().

◆ SetCallback()

void WX_INFOBAR::SetCallback ( std::function< void(void)> aCallback )

inline

Provide a callback to be called when the infobar is dismissed (either by user action or timer).

Parameters

aCallback

Definition at line 160 of file wx_infobar.h.

References m_callback.

◆ SetShowTime()

void WX_INFOBAR::SetShowTime ( int aTime )

Set the time period to show the infobar.

This only applies for the next showing of the infobar, so it must be reset every time. A value of 0 disables the automatic hiding (this is the default).

Parameters

aTime is the time in milliseconds to show the infobar

Definition at line 118 of file wx_infobar.cpp.

References m_showTime.

◆ ShowMessage() [1/2]

void WX_INFOBAR::ShowMessage	(	const wxString &	aMessage,
		int	aFlags,
		MESSAGE_TYPE	aType )

Show the info bar with the provided message and icon, setting the type.

Parameters

aMessage	is the message to display
aFlags	is the flag containing the icon to display on the left side of the infobar
aType	is the type of message being displayed

Definition at line 181 of file wx_infobar.cpp.

References m_type, m_updateLock, and ShowMessage().

◆ ShowMessage() [2/2]

void WX_INFOBAR::ShowMessage	(	const wxString &	aMessage,
		int	aFlags = wxICON_INFORMATION )

override

Show the info bar with the provided message and icon.

Parameters

aMessage	is the message to display
aFlags	is the flag containing the icon to display on the left side of the infobar

Definition at line 157 of file wx_infobar.cpp.

References GENERIC, m_auiManager, m_message, m_showTime, m_showTimer, m_type, m_updateLock, and updateAuiLayout().

Referenced by PAD_TOOL::enterPadEditMode(), onShowInfoBar(), SYMBOL_EDIT_FRAME::SetCurSymbol(), ShowMessage(), and ShowMessageFor().

◆ ShowMessageFor()

void WX_INFOBAR::ShowMessageFor	(	const wxString &	aMessage,
		int	aTime,
		int	aFlags = wxICON_INFORMATION,
		MESSAGE_TYPE	aType = WX_INFOBAR::MESSAGE_TYPE::GENERIC )

Show the infobar with the provided message and icon for a specific period of time.

Parameters

aMessage	is the message to display
aTime	is the amount of time in milliseconds to show the infobar
aFlags	is the flag containing the icon to display on the left side of the infobar

Definition at line 143 of file wx_infobar.cpp.

References m_showTime, m_type, m_updateLock, and ShowMessage().

Referenced by FOOTPRINT_EDIT_FRAME::CanCloseFPFromBoard(), ZONE_FILLER_TOOL::FillAllZones(), ROUTER_TOOL::handleLayerSwitch(), APPEARANCE_CONTROLS::onReadOnlySwatch(), APPEARANCE_CONTROLS_3D::rebuildLayers(), EDA_BASE_FRAME::ShowInfoBarError(), EDA_BASE_FRAME::ShowInfoBarError(), EDA_BASE_FRAME::ShowInfoBarMsg(), EDA_BASE_FRAME::ShowInfoBarWarning(), PCB_CONTROL::unfilledZoneCheck(), and ZONE_FILLER_TOOL::ZoneFillDirty().

◆ updateAuiLayout()

void WX_INFOBAR::updateAuiLayout ( bool aShow )

protected

Update the AUI pane to show or hide this infobar.

Parameters

aShow is true to show the pane

Definition at line 307 of file wx_infobar.cpp.

References m_auiManager.

Referenced by Dismiss(), and ShowMessage().

Member Data Documentation

◆ m_auiManager

wxAuiManager* WX_INFOBAR::m_auiManager

protected

The AUI manager that contains this infobar.

Definition at line 263 of file wx_infobar.h.

Referenced by Dismiss(), ShowMessage(), updateAuiLayout(), and WX_INFOBAR().

◆ m_callback

std::optional<std::function<void(void)> > WX_INFOBAR::m_callback

protected

Optional callback made when closing infobar.

Definition at line 267 of file wx_infobar.h.

Referenced by Dismiss(), and SetCallback().

◆ m_message

wxString WX_INFOBAR::m_message

protected

The original message without wrapping.

Definition at line 265 of file wx_infobar.h.

Referenced by onSize(), and ShowMessage().

◆ m_showTime

int WX_INFOBAR::m_showTime

protected

The time to show the infobar. 0 = don't auto hide.

Definition at line 260 of file wx_infobar.h.

Referenced by onTimer(), SetShowTime(), ShowMessage(), ShowMessageFor(), and WX_INFOBAR().

◆ m_showTimer

wxTimer* WX_INFOBAR::m_showTimer

protected

The timer counting the autoclose period.

Definition at line 262 of file wx_infobar.h.

Referenced by onTimer(), ShowMessage(), WX_INFOBAR(), and ~WX_INFOBAR().

◆ m_type

MESSAGE_TYPE WX_INFOBAR::m_type

protected

The type of message being displayed.

Definition at line 264 of file wx_infobar.h.

Referenced by GetMessageType(), ShowMessage(), ShowMessage(), ShowMessageFor(), and WX_INFOBAR().

◆ m_updateLock

bool WX_INFOBAR::m_updateLock

protected

True if this infobar requested the UI update.

Definition at line 261 of file wx_infobar.h.

Referenced by Dismiss(), IsLocked(), ShowMessage(), ShowMessage(), ShowMessageFor(), and WX_INFOBAR().

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

Public Types

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Member Enumeration Documentation

◆ MESSAGE_TYPE

Constructor & Destructor Documentation

◆ WX_INFOBAR()

◆ ~WX_INFOBAR()

Member Function Documentation

◆ AddButton() [1/3]

◆ AddButton() [2/3]

◆ AddButton() [3/3]

◆ AddCloseButton()

◆ Dismiss()

◆ GetCloseButton()

◆ GetMessageType()

◆ HasCloseButton()

◆ IsLocked()

◆ onCloseButton()

◆ onDismissInfoBar()

◆ onShowInfoBar()

◆ onSize()

◆ onThemeChange()

◆ onTimer()

◆ QueueDismiss()

◆ QueueShowMessage()

◆ RemoveAllButtons()

◆ SetCallback()

◆ SetShowTime()

◆ ShowMessage() [1/2]

◆ ShowMessage() [2/2]

◆ ShowMessageFor()

◆ updateAuiLayout()

Member Data Documentation

◆ m_auiManager

◆ m_callback

◆ m_message

◆ m_showTime

◆ m_showTimer

◆ m_type

◆ m_updateLock