confirm.h File Reference

This file is part of the common library. More...

#include <wx/richmsgdlg.h>
#include <vector>
#include <functional>

Go to the source code of this file.

Classes
class	KIDIALOG
	Helper class to create more flexible dialogs, including 'do not show again' checkbox handling. More...

Functions
bool	OverrideLock (wxWindow *aParent, const wxString &aMessage)
	Display a dialog indicating the file is already open, with an option to reset the lock. More...
bool	HandleUnsavedChanges (wxWindow *aParent, const wxString &aMessage, const std::function< bool()> &aSaveFunction)
	Display a dialog with Save, Cancel and Discard Changes buttons. More...
int	UnsavedChangesDialog (wxWindow *aParent, const wxString &aMessage, bool *aApplyToAll)
	A specialized version of HandleUnsavedChanges which handles an apply-to-all checkbox. More...
int	UnsavedChangesDialog (wxWindow *aParent, const wxString &aMessage)
bool	ConfirmRevertDialog (wxWindow *parent, const wxString &aMessage)
	Display a confirmation dialog for a revert action. More...
void	DisplayError (wxWindow *aParent, const wxString &aText, int aDisplayTime=0)
	Display an error or warning message box with aMessage. More...
void	DisplayErrorMessage (wxWindow *aParent, const wxString &aMessage, const wxString &aExtraInfo=wxEmptyString)
	Display an error message with aMessage. More...
void	DisplayInfoMessage (wxWindow *parent, const wxString &aMessage, const wxString &aExtraInfo=wxEmptyString)
	Display an informational message box with aMessage. More...
bool	IsOK (wxWindow *aParent, const wxString &aMessage)
	Display a yes/no dialog with aMessage and returns the user response. More...
int	OKOrCancelDialog (wxWindow *aParent, const wxString &aWarning, const wxString &aMessage, const wxString &aDetailedMessage=wxEmptyString, const wxString &aOKLabel=wxEmptyString, const wxString &aCancelLabel=wxEmptyString, bool *aApplyToAll=nullptr)
	Display a warning dialog with aMessage and returns the user response. More...
int	SelectSingleOption (wxWindow *aParent, const wxString &aTitle, const wxString &aMessage, const wxArrayString &aOptions)
	Display a dialog with radioboxes asking the user to select an option. More...
bool	IsGUI ()
	Determine if the application is running with a GUI. More...

Detailed Description

This file is part of the common library.

See also

common.h

Definition in file confirm.h.

Function Documentation

ConfirmRevertDialog()

bool ConfirmRevertDialog	(	wxWindow *	parent,
		const wxString &	aMessage
	)

Display a confirmation dialog for a revert action.

Definition at line 249 of file confirm.cpp.

{
 wxMessageDialog dlg( parent, aMessage, wxEmptyString,
 wxOK | wxCANCEL | wxOK_DEFAULT | wxICON_WARNING | wxCENTER );
 dlg.SetExtendedMessage( _( "Your current changes will be permanently lost." ) );
 dlg.SetOKCancelLabels( _( "Revert" ), _( "Cancel" ) );
 
 return dlg.ShowModal() == wxID_OK;
}

References _.

Referenced by SYMBOL_EDIT_FRAME::Revert(), and FOOTPRINT_EDIT_FRAME::RevertFootprint().

DisplayError()

void DisplayError	(	wxWindow *	aParent,
		const wxString &	aText,
		int	aDisplayTime = 0
	)

Display an error or warning message box with aMessage.

Warning

Setting displaytime does not work. Do not use it.

Definition at line 300 of file confirm.cpp.

{
 if( !wxTheApp || !wxTheApp->IsMainLoopRunning() )
 {
 wxLogError( "%s", aText );
 return;
 }
 
 if( !IsGUI() )
 {
 wxFprintf( stderr, aText );
 return;
 }
 
 wxMessageDialog* dlg;
 int icon = aDisplayTime > 0 ? wxICON_INFORMATION : wxICON_ERROR;
 
 dlg = new wxMessageDialog( aParent, aText, _( "Warning" ),
 wxOK | wxCENTRE | wxRESIZE_BORDER | icon | wxSTAY_ON_TOP );
 
 dlg->ShowModal();
 dlg->Destroy();
}

References _, and IsGUI().

Referenced by DIALOG_COPPER_ZONE::AcceptOptions(), FOOTPRINT_VIEWER_FRAME::AddFootprintToPCB(), PCB_BASE_EDIT_FRAME::AddLibrary(), SYMBOL_EDIT_FRAME::AddLibraryFile(), PCB_CONTROL::AppendBoard(), SYMBOL_EDIT_FRAME::backupFile(), SCH_EDIT_FRAME::CheckSheetForRecursion(), FOOTPRINT_VIEWER_FRAME::ClickOnFootprintList(), SCH_EDIT_FRAME::ConvertPart(), DIALOG_GEN_FOOTPRINT_POSITION::CreateAsciiFiles(), MICROWAVE_TOOL::createFootprint(), DIALOG_GEN_FOOTPRINT_POSITION::CreateGerberFiles(), SIMULATOR::CreateInstance(), PCB_BASE_EDIT_FRAME::createNewLibrary(), SYMBOL_EDIT_FRAME::DdAddLibrary(), UNIT_BINDER::delayedFocusHandler(), FOOTPRINT_EDIT_FRAME::DeleteFootprintFromLibrary(), PANEL_SETUP_LAYERS::DenyChangeCheckBox(), FIELDS_EDITOR_GRID_TRICKS::doPopupSelection(), DIALOG_SIM_COMMAND::evaluateDCControls(), ExecuteFile(), FOOTPRINT_EDIT_FRAME::ExportFootprint(), PCB_EDIT_FRAME::ExportFootprintsToLibrary(), GBR_TO_PCB_EXPORTER::ExportPcb(), DIALOG_EXPORT_SVG::ExportSVGFile(), SYMBOL_EDIT_FRAME::ExportSymbol(), SCH_EDITOR_CONTROL::ExportSymbolsToLibrary(), PCB_EDIT_FRAME::ExportToGenCAD(), DIALOG_GENDRILL::GenDrillAndMapFiles(), PCB_EDIT_FRAME::GenFootprintsReport(), GetAssociatedDocument(), DISPLAY_FOOTPRINTS_FRAME::GetFootprint(), FOOTPRINT_EDIT_FRAME::ImportFootprint(), SCH_EDITOR_CONTROL::ImportFPAssignments(), SYMBOL_EDIT_FRAME::ImportSymbol(), DIALOG_PRINT_GENERIC::initPrintData(), SYMBOL_EDIT_FRAME::LoadSymbol(), SCH_EDIT_FRAME::NewProject(), DIALOG_SYMBOL_FIELDS_TABLE::OnAddField(), DIALOG_CONFIG_EQUFILES::OnAddFiles(), DIALOG_BOM::OnAddGenerator(), DIALOG_NET_INSPECTOR::onAddNet(), DIALOG_SYMBOL_FIELDS_TABLE::OnColumnItemToggled(), DIALOG_FOOTPRINT_PROPERTIES::OnDeleteField(), DIALOG_LABEL_PROPERTIES::OnDeleteField(), DIALOG_LIB_SYMBOL_PROPERTIES::OnDeleteField(), DIALOG_SHEET_PROPERTIES::OnDeleteField(), DIALOG_SYMBOL_PROPERTIES::OnDeleteField(), DIALOG_FOOTPRINT_PROPERTIES_FP_EDITOR::OnDeleteField(), PANEL_FP_EDITOR_DEFAULTS::OnDeleteTextItem(), DIALOG_LIB_SYMBOL_PROPERTIES::OnGridCellChanging(), DIALOG_SYMBOL_PROPERTIES::OnGridCellChanging(), SCH_EDIT_FRAME::OnOpenCvpcb(), DIALOG_PRINT_GENERIC::onPrintButtonClick(), DIALOG_PRINT_GENERIC::onPrintPreview(), DIALOG_NET_INSPECTOR::onRenameNet(), DIALOG_ERC::OnSaveReport(), DIALOG_DRC::OnSaveReport(), DIALOG_SHEET_PROPERTIES::onSheetFilenameChanged(), PCB_DRAW_PANEL_GAL::OnShow(), SCH_EDIT_FRAME::OnUpdatePCB(), DIALOG_FOOTPRINT_PROPERTIES::OnUpdateUI(), DIALOG_LIB_SYMBOL_PROPERTIES::OnUpdateUI(), DIALOG_FOOTPRINT_PROPERTIES_FP_EDITOR::OnUpdateUI(), OpenPDF(), SCH_EDIT_FRAME::OpenProjectFiles(), PCB_EDIT_FRAME::OpenProjectFiles(), SCH_EDITOR_CONTROL::Paste(), SYMBOL_GRID_TRICKS::paste_text(), FP_GRID_TRICKS::paste_text(), DIALOG_PLOT::Plot(), PCB_CONTROL::pruneItemLayers(), MWAVE_POLYGONAL_SHAPE_DLG::ReadDataShapeDescr(), PCB_EDIT_FRAME::RecreateBOMFileFromBoard(), PCB_EDIT_FRAME::RecreateCmpFileFromBoard(), FOOTPRINT_EDITOR_CONTROL::RenameFootprint(), KIGFX::VERTEX_MANAGER::Reserve(), FOOTPRINT_EDIT_FRAME::SaveFootprintAs(), FOOTPRINT_EDIT_FRAME::SaveFootprintInLibrary(), FOOTPRINT_EDIT_FRAME::SaveFootprintToBoard(), FOOTPRINT_EDIT_FRAME::SaveLibraryAs(), PCB_EDIT_FRAME::SavePcbCopy(), PCB_EDIT_FRAME::SavePcbFile(), SCH_EDIT_FRAME::saveSchematicFile(), SYMBOL_EDIT_FRAME::saveSymbolAs(), KIGFX::GPU_MANAGER::SetShader(), EDA_DRAW_PANEL_GAL::SwitchBackend(), PCB_EDIT_FRAME::TestStandalone(), DIALOG_EDIT_SYMBOLS_LIBID::TransferDataFromWindow(), DIALOG_FIELD_PROPERTIES::TransferDataFromWindow(), DIALOG_GLOBAL_SYM_LIB_TABLE_CONFIG::TransferDataFromWindow(), DIALOG_LABEL_PROPERTIES::TransferDataFromWindow(), DIALOG_LIB_TEXT_PROPERTIES::TransferDataFromWindow(), DIALOG_PRINT_USING_PRINTER::TransferDataFromWindow(), DIALOG_SCH_IMPORT_SETTINGS::TransferDataFromWindow(), DIALOG_SHEET_PROPERTIES::TransferDataFromWindow(), DIALOG_SIM_COMMAND::TransferDataFromWindow(), DIALOG_TEXT_PROPERTIES::TransferDataFromWindow(), DIALOG_GLOBAL_FP_LIB_TABLE_CONFIG::TransferDataFromWindow(), DIALOG_IMPORT_SETTINGS::TransferDataFromWindow(), DIALOG_NON_COPPER_ZONES_EDITOR::TransferDataFromWindow(), DIALOG_PAD_PRIMITIVES_PROPERTIES::TransferDataFromWindow(), DIALOG_RULE_AREA_PROPERTIES::TransferDataFromWindow(), DIALOG_TEXTBOX_PROPERTIES::TransferDataFromWindow(), DIALOG_TRACK_VIA_PROPERTIES::TransferDataFromWindow(), DIALOG_TRACK_VIA_SIZE::TransferDataFromWindow(), SPICE_VALIDATOR::Validate(), REGEX_VALIDATOR::Validate(), KIGFX::VERTEX_MANAGER::Vertex(), KIGFX::VERTEX_MANAGER::Vertices(), and LEGACY_RESCUER::WriteRescueLibrary().

DisplayErrorMessage()

void DisplayErrorMessage	(	wxWindow *	aParent,
		const wxString &	aMessage,
		const wxString &	aExtraInfo = wxEmptyString
	)

Display an error message with aMessage.

Parameters

aParent	is the parent window
aMessage	is the message text to display
aExtraInfo	is extra data that can be optionally displayed in a collapsible pane

Definition at line 325 of file confirm.cpp.

{
 if( !wxTheApp || !wxTheApp->IsMainLoopRunning() )
 {
 wxLogError( "%s %s", aText, aExtraInfo );
 return;
 }
 
 if( !IsGUI() )
 {
 wxFprintf( stderr, aText );
 return;
 }
 
 wxMessageDialog* dlg;
 
 dlg = new wxMessageDialog( aParent, aText, _( "Error" ),
 wxOK | wxCENTRE | wxRESIZE_BORDER | wxICON_ERROR | wxSTAY_ON_TOP );
 
 if( !aExtraInfo.IsEmpty() )
 dlg->SetExtendedMessage( aExtraInfo );
 
 dlg->ShowModal();
 dlg->Destroy();
}

References _, and IsGUI().

Referenced by FOOTPRINT_VIEWER_FRAME::AddFootprintToPCB(), FILENAME_RESOLVER::addPath(), SYMBOL_EDITOR_CONTROL::AddSymbolToSchematic(), SIMULATOR_FRAME::AddTuner(), PANEL_SETUP_LAYERS::addUserDefinedLayer(), SIMULATOR_FRAME::applyTuners(), CVPCB_ASSOCIATION_TOOL::Associate(), CVPCB_MAINFRAME::AssociateFootprint(), PANEL_FP_LIB_TABLE::browseLibrariesHandler(), checkGlError(), SIM_MODEL::Create(), SCH_EDIT_FRAME::CreateArchiveLibrary(), PROJECT_TREE_ITEM::Delete(), WIDGET_HOTKEY_LIST::editItem(), SIMULATOR_FRAME::EditSimCommand(), FOOTPRINT_EDIT_FRAME::ExportFootprint(), PCB_EDIT_FRAME::ExportSpecctraFile(), SYMBOL_EDIT_FRAME::ExportSymbol(), BACK_ANNOTATE::FetchNetlistFromPCB(), PCB_EDIT_FRAME::FetchNetlistFromSchematic(), PL_EDITOR_FRAME::Files_io(), EDA_BASE_FRAME::GetFileFromHistory(), SCH_EDIT_FRAME::importFile(), PCB_EDIT_FRAME::ImportSpecctraSession(), SYMBOL_EDIT_FRAME::ImportSymbol(), PGM_BASE::InitPgm(), EDA_BASE_FRAME::IsWritable(), SYMBOL_EDIT_FRAME::KiwayMailIn(), FOOTPRINT_EDIT_FRAME::KiwayMailIn(), SCH::IFACE::loadGlobalLibTable(), PCB::IFACE::loadGlobalLibTable(), DIALOG_SIM_MODEL< T_symbol, T_field >::loadLibrary(), SCH_EDIT_FRAME::LoadSheetFromFile(), SIMULATOR_FRAME::LoadSimulator(), SYMBOL_EDIT_FRAME::LoadSymbol(), SYMBOL_EDIT_FRAME::LoadSymbolFromCurrentLib(), mergeZones(), SETTINGS_MANAGER::MigrateIfNeeded(), KICAD_MANAGER_CONTROL::NewFromTemplate(), KICAD_MANAGER_CONTROL::NewProject(), DIALOG_SCHEMATIC_SETUP::onAuxiliaryAction(), DIALOG_BOARD_SETUP::onAuxiliaryAction(), PANEL_SYM_LIB_TABLE::onConvertLegacyLibraries(), DIALOG_EXPORT_STEP::onExportButton(), PCB_EDIT_FRAME::OnExportSTEP(), PCB_EDIT_FRAME::OnExportVRML(), CV::IFACE::OnKifaceStart(), PANEL_SETUP_NETCLASSES::OnRemoveNetclassClick(), FOOTPRINT_EDIT_FRAME::OnSaveFootprintAsPng(), DIALOG_SHEET_PROPERTIES::onSheetFilenameChanged(), SIMULATOR_FRAME::onSimUpdate(), DIALOG_SIM_MODEL< T_symbol, T_field >::onTypeChoice(), PANEL_SETUP_BUSES::OnUpdateUI(), DIALOG_CONFIGURE_PATHS::OnUpdateUI(), PANEL_TEXT_VARIABLES::OnUpdateUI(), SCH_EDIT_FRAME::OpenProjectFiles(), PCB_EDIT_FRAME::OpenProjectFiles(), PROJECT::PcbFootprintLibs(), KIWAY::Player(), EDA_DRAW_FRAME::PrintPage(), NETLIST_EXPORTER_SPICE::readModel(), PCB_EDIT_FRAME::ReadNetlistFromFile(), FOOTPRINT_EDITOR_CONTROL::RenameFootprint(), SYMBOL_EDITOR_CONTROL::RenameSymbol(), PCB_EDIT_FRAME::RunEeschema(), SYMBOL_EDIT_FRAME::Save(), SYMBOL_EDIT_FRAME::saveCurrentSymbol(), SYMBOL_EDIT_FRAME::saveLibrary(), KICAD_MANAGER_CONTROL::SaveProjectAs(), DIALOG_BOARD_STATISTICS::saveReportClicked(), SCH_BASE_FRAME::saveSymbolLibTables(), SchGetLibSymbol(), KIWAY::SetLanguage(), FOOTPRINT_VIEWER_FRAME::ShowModal(), SYMBOL_VIEWER_FRAME::ShowModal(), SIMULATOR_FRAME::StartSimulation(), DIALOG_LIB_SYMBOL_PROPERTIES::TransferDataFromWindow(), DIALOG_PIN_PROPERTIES::TransferDataFromWindow(), DIALOG_PNS_DIFF_PAIR_DIMENSIONS::TransferDataFromWindow(), DIALOG_SIM_MODEL< T_symbol, T_field >::TransferDataToWindow(), SYMBOL_EDIT_FRAME::UpdateAfterSymbolProperties(), BOARD_EDITOR_CONTROL::UpdateSchematicFromPCB(), SIMULATOR_FRAME::UpdateTunerValue(), DIALOG_SHEET_PROPERTIES::Validate(), DIALOG_SYMBOL_PROPERTIES::Validate(), IPC356D_WRITER::Write(), NETLIST_EXPORTER_SPICE::writeInclude(), and SYMBOL_LIB_TABLE_RESCUER::WriteRescueLibrary().

DisplayInfoMessage()

void DisplayInfoMessage	(	wxWindow *	parent,
		const wxString &	aMessage,
		const wxString &	aExtraInfo = wxEmptyString
	)

Display an informational message box with aMessage.

Parameters

aParent	is the parent window
aMessage	is the message text to display
aExtraInfo	is the extra data that can be optionally displayed in a collapsible pane

Definition at line 352 of file confirm.cpp.

{
 if( !wxTheApp || !wxTheApp->GetTopWindow() )
 {
 wxLogDebug( "%s %s", aMessage, aExtraInfo );
 return;
 }
 
 if( !IsGUI() )
 {
 wxFprintf( stdout, "%s %s", aMessage, aExtraInfo );
 return;
 }
 
 wxMessageDialog* dlg;
 int icon = wxICON_INFORMATION;
 
 dlg = new wxMessageDialog( aParent, aMessage, _( "Information" ),
 wxOK | wxCENTRE | wxRESIZE_BORDER | icon | wxSTAY_ON_TOP );
 
 if( !aExtraInfo.IsEmpty() )
 dlg->SetExtendedMessage( aExtraInfo );
 
 dlg->ShowModal();
 dlg->Destroy();
}

References _, and IsGUI().

Referenced by SCH_EDIT_FRAME::checkForNoFullyDefinedLibIds(), EE_INSPECTION_TOOL::CheckSymbol(), PCB_BASE_FRAME::CreateNewFootprint(), FOOTPRINT_EDIT_FRAME::DeleteFootprintFromLibrary(), DIALOG_SYMBOL_REMAP::DIALOG_SYMBOL_REMAP(), EDA_DRAW_PANEL_GAL::DoRePaint(), FOOTPRINT_EDIT_FRAME::DuplicateFootprint(), FOOTPRINT_EDIT_FRAME::ExportFootprint(), PCB_EDIT_FRAME::ExportFootprintsToLibrary(), GERBVIEW_CONTROL::ExportToPcbnew(), PCB_EDIT_FRAME::Files_io_from_id(), DIALOG_PRINT_GENERIC::getScaleValue(), PGM_BASE::GetTextEditor(), PCB_EDIT_FRAME::inferLegacyEdgeClearance(), CV::IFACE::OnKifaceStart(), SCH_DRAW_PANEL::OnShow(), SCH_EDIT_FRAME::OpenProjectFiles(), DIALOG_PLOT::Plot(), BOARD_EDITOR_CONTROL::RepairBoard(), FOOTPRINT_EDITOR_CONTROL::RepairFootprint(), SCH_EDITOR_CONTROL::RepairSchematic(), FOOTPRINT_EDIT_FRAME::SaveFootprint(), FOOTPRINT_EDIT_FRAME::SaveFootprintAs(), FOOTPRINT_EDIT_FRAME::SaveLibraryAs(), PCB_EDIT_FRAME::SavePcbCopy(), ROUTER_TOOL::SelectCopperLayerPair(), KICAD_MANAGER_CONTROL::ShowPlayer(), EDA_DRAW_PANEL_GAL::SwitchBackend(), DIALOG_LABEL_PROPERTIES::TransferDataFromWindow(), and DIALOG_SCH_FIELD_PROPERTIES::UpdateField().

HandleUnsavedChanges()

bool HandleUnsavedChanges	(	wxWindow *	aParent,
		const wxString &	aMessage,
		const std::function< bool()> &	aSaveFunction
	)

Display a dialog with Save, Cancel and Discard Changes buttons.

Parameters

aParent	= the parent window
aMessage	= the main message to put in dialog
aSaveFunction	= a function to save changes, if requested. Must return true if the save was successful and false otherwise (which will result in HandleUnsavedChanges() returning wxID_CANCEL).

Returns

wxID_YES, wxID_CANCEL, wxID_NO.

Definition at line 260 of file confirm.cpp.

{
 switch( UnsavedChangesDialog( aParent, aMessage ) )
 {
 case wxID_YES: return aSaveFunction();
 case wxID_NO: return true;
 default:
 case wxID_CANCEL: return false;
 }
}

References UnsavedChangesDialog().

Referenced by SCH_EDIT_FRAME::AskToSaveChanges(), FOOTPRINT_EDIT_FRAME::CanCloseFPFromBoard(), CVPCB_MAINFRAME::canCloseWindow(), SCH_EDIT_FRAME::canCloseWindow(), PL_EDITOR_FRAME::canCloseWindow(), PCB_EDIT_FRAME::canCloseWindow(), SIMULATOR_FRAME::canCloseWindow(), FOOTPRINT_EDIT_FRAME::canCloseWindow(), FOOTPRINT_EDIT_FRAME::Clear_Pcb(), FOOTPRINT_EDITOR_CONTROL::CreateFootprint(), PL_EDITOR_FRAME::Files_io(), PCB_EDIT_FRAME::Files_io_from_id(), SYMBOL_EDIT_FRAME::LoadSymbol(), DIALOG_SYMBOL_FIELDS_TABLE::OnClose(), DIALOG_LIB_EDIT_PIN_TABLE::OnClose(), PL_EDITOR_FRAME::OnFileHistory(), and PCB_EDIT_FRAME::OpenProjectFiles().

IsGUI()

bool IsGUI

(

)

Determine if the application is running with a GUI.

Returns

true if there is a GUI and false otherwise

Definition at line 40 of file confirm.cpp.

{
 if( !wxTheApp )
 return false;
 
#if wxCHECK_VERSION( 3, 1, 6 )
 return wxTheApp->IsGUI();
#else
 // wxWidgets older than version 3.1.6 do not have a way to know if the app
 // has a GUI or is a console application.
 // So the trick is to set the App class name when starting kicad-cli, and when
 // the app class name is the kicad-cli class name the app is a console app
 bool run_gui = wxTheApp->GetClassName() != KICAD_CLI_APP_NAME;
 return run_gui;
#endif
}

References KICAD_CLI_APP_NAME.

Referenced by EDA_BASE_FRAME::CheckForAutoSaveFile(), SCH_EDIT_FRAME::CheckForAutoSaveFile(), DisplayError(), DisplayErrorMessage(), DisplayInfoMessage(), and PCB_PLUGIN::FootprintSave().

IsOK()

bool IsOK	(	wxWindow *	aParent,
		const wxString &	aMessage
	)

Display a yes/no dialog with aMessage and returns the user response.

Parameters

aParent	is the parent window. NULL can be used if the parent is the top level window.
aMessage	is the message to display in the dialog box.

Returns

True if user selected the yes button, otherwise false.

Definition at line 380 of file confirm.cpp.

{
 // wxMessageDialog no longer responds correctly to the <ESC> key (on at least OSX and MSW)
 // so we're now using wxRichMessageDialog.
 //
 // Note also that we have to repurpose an OK/Cancel version of it because otherwise wxWidgets
 // uses "destructive" spacing for the "No" button.
 
#ifdef __APPLE__
 // Why is wxICON_QUESTION a light-bulb on Mac? That has more of a hint or info connotation.
 int icon = wxICON_WARNING;
#else
 int icon = wxICON_QUESTION;
#endif
 
#if !defined( __WXGTK__ )
 wxRichMessageDialog dlg( aParent, aMessage, _( "Confirmation" ),
 wxOK | wxCANCEL | wxOK_DEFAULT | wxCENTRE | icon | wxSTAY_ON_TOP );
#else
 wxMessageDialog dlg( aParent, aMessage, _( "Confirmation" ),
  wxOK | wxCANCEL | wxOK_DEFAULT | wxCENTRE | icon | wxSTAY_ON_TOP );
#endif
 
 dlg.SetOKCancelLabels( _( "Yes" ), _( "No" ) );
 
 return dlg.ShowModal() == wxID_OK;
}

References _.

Referenced by PANEL_IMAGE_EDITOR::CheckValues(), SCH_EDIT_TOOL::CleanupSheetPins(), GERBVIEW_FRAME::Clear_DrawLayers(), PCB_EDIT_FRAME::Clear_Pcb(), CVPCB_ASSOCIATION_TOOL::DeleteAll(), FOOTPRINT_EDIT_FRAME::DeleteFootprintFromLibrary(), SYMBOL_EDIT_FRAME::DeleteSymbolFromLibrary(), DIALOG_GLOBAL_DELETION::DoGlobalDeletions(), GERBVIEW_FRAME::Erase_Current_DrawLayer(), PCB_EDIT_FRAME::ExportFootprintsToLibrary(), SCH_EDITOR_CONTROL::ExportSymbolsToLibrary(), PCB_EDIT_FRAME::Files_io_from_id(), KICAD_MANAGER_CONTROL::NewProject(), SCH_EDIT_FRAME::OnAppendProject(), DIALOG_BOARD_REANNOTATE::OnApplyClick(), PANEL_SETUP_RULES::onCharHook(), PANEL_SYM_LIB_TABLE::onConvertLegacyLibraries(), DIALOG_NET_INSPECTOR::onDeleteNet(), DIALOG_SYMBOL_FIELDS_TABLE::OnRemoveField(), DIALOG_SHEET_PROPERTIES::onSheetFilenameChanged(), SCH_EDIT_FRAME::OpenProjectFiles(), PCB_EDIT_FRAME::OpenProjectFiles(), CVPCB_MAINFRAME::readNetListAndFpFiles(), SCH_EDIT_FRAME::ReadyToNetlist(), DIALOG_BOARD_REANNOTATE::ReannotateBoard(), SCH_EDITOR_CONTROL::Revert(), SIMULATOR_FRAME::StartSimulation(), DIALOG_PIN_PROPERTIES::TransferDataFromWindow(), PANEL_SETUP_LAYERS::TransferDataFromWindow(), and DIALOG_LIB_SYMBOL_PROPERTIES::Validate().

OKOrCancelDialog()

int OKOrCancelDialog	(	wxWindow *	aParent,
		const wxString &	aWarning,
		const wxString &	aMessage,
		const wxString &	aDetailedMessage = wxEmptyString,
		const wxString &	aOKLabel = wxEmptyString,
		const wxString &	aCancelLabel = wxEmptyString,
		bool *	aApplyToAll = nullptr
	)

Display a warning dialog with aMessage and returns the user response.

Parameters

aParent	is the parent window. NULL can be used if the parent is the top level window.
aWarning	is the warning to display in the top part of the dialog box using a bold font.
aMessage	is the message to display in the lower part of the dialog box using the default system UI font.
aDetailedMessage	is the message to display in the "Show detailed information" section. Passing wxEmptyString will hide this portion of the dialog.
aOKLabel	is the text to display in the OK button.
aCancelLabel	is the text to display in the cancel button.

Returns

wxID_OK or wxID_CANCEL depending on the button the user selected.

Definition at line 273 of file confirm.cpp.

{
 wxRichMessageDialog dlg( aParent, aMessage, aWarning,
 wxOK | wxCANCEL | wxOK_DEFAULT | wxICON_WARNING | wxCENTER );
 
 dlg.SetOKCancelLabels( ( aOKLabel.IsEmpty() ) ? _( "OK" ) : aOKLabel,
 ( aCancelLabel.IsEmpty() ) ? _( "Cancel" ) : aCancelLabel );
 
 if( !aDetailedMessage.IsEmpty() )
 dlg.SetExtendedMessage( aDetailedMessage );
 
 if( aApplyToAll )
 dlg.ShowCheckBox( _( "Apply to all" ), true );
 
 int ret = dlg.ShowModal();
 
 if( aApplyToAll )
 *aApplyToAll = dlg.IsCheckBoxChecked();
 
 // Returns wxID_OK or wxID_CANCEL
 return ret;
}

References _.

Referenced by PANEL_FP_LIB_TABLE::browseLibrariesHandler(), PANEL_SYM_LIB_TABLE::browseLibrariesHandler(), DIALOG_SYMBOL_FIELDS_TABLE::OnExport(), SYMBOL_EDIT_FRAME::Save(), SYMBOL_EDIT_FRAME::saveAllLibraries(), and ROUTER_TOOL::saveRouterDebugLog().

OverrideLock()

bool OverrideLock	(	wxWindow *	aParent,
		const wxString &	aMessage
	)

Display a dialog indicating the file is already open, with an option to reset the lock.

Returns

true if the lock was reset.

Definition at line 175 of file confirm.cpp.

{
#ifdef __APPLE__
 // wxMessageDialog gets the button spacing wrong on Mac so we have to use wxRichMessageDialog.
 // Note that its warning icon is more like wxMessageDialog's error icon, so we use it instead
 // of wxICON_ERROR.
 wxRichMessageDialog dlg( aParent, aMessage, _( "File Open Warning" ),
 wxYES_NO | wxICON_WARNING | wxCENTER );
 dlg.SetExtendedMessage( _( "Interleaved saves may produce very unexpected results." )
 + wxS( "\n" ) );
 dlg.SetYesNoLabels( _( "Cancel" ), _( "Open Anyway" ) );
#else
 wxMessageDialog dlg( aParent, aMessage, _( "File Open Warning" ),
 wxYES_NO | wxICON_ERROR | wxCENTER );
 dlg.SetExtendedMessage( _( "Interleaved saves may produce very unexpected results." ) );
 dlg.SetYesNoLabels( _( "Cancel" ), _( "Open Anyway" ) );
#endif
 
 return dlg.ShowModal() == wxID_NO;
}

References _.

Referenced by SCH_EDIT_FRAME::importFile(), SCH_EDIT_FRAME::OpenProjectFiles(), and PCB_EDIT_FRAME::OpenProjectFiles().

SelectSingleOption()

int SelectSingleOption	(	wxWindow *	aParent,
		const wxString &	aTitle,
		const wxString &	aMessage,
		const wxArrayString &	aOptions
	)

Display a dialog with radioboxes asking the user to select an option.

Parameters

aParent	is the parent window.
aTitle	is the dialog title.
aMessage	is a text label displayed in the first row of the dialog.
aOptions	is a vector of possible options.

Returns

Index of the selected option or -1 when the dialog has been canceled.

Definition at line 409 of file confirm.cpp.

{
 wxSingleChoiceDialog dlg( aParent, aMessage, aTitle, aOptions );
 
 if( dlg.ShowModal() != wxID_OK )
 return -1;
 
 return dlg.GetSelection();
}

UnsavedChangesDialog() [1/2]

int UnsavedChangesDialog	(	wxWindow *	aParent,
		const wxString &	aMessage
	)

Definition at line 223 of file confirm.cpp.

{
#ifdef __APPLE__
 // wxMessageDialog gets the button order (and spacing) wrong on Mac so we have to use
 // wxRichMessageDialog.
 return UnsavedChangesDialog( parent, aMessage, nullptr );
#else
 #ifdef _WIN32
 // wxMessageDialog on windows invokes TaskDialogIndirect which is a native function for a dialog
 // As a result it skips wxWidgets for modal management...and we don't parent frames properly
 // among other things for Windows to do the right thing by default
 // Disable all the windows manually to avoid being able to hit this dialog from the tool frame and kicad frame at the same time
 wxWindowDisabler disable( true );
 #endif
 
 wxMessageDialog dlg( parent, aMessage, _( "Save Changes?" ),
 wxYES_NO | wxCANCEL | wxYES_DEFAULT | wxICON_WARNING | wxCENTER );
 dlg.SetExtendedMessage( _( "If you don't save, all your changes will be permanently lost." ) );
 dlg.SetYesNoLabels( _( "Save" ), _( "Discard Changes" ) );
 
 // Returns wxID_YES, wxID_NO, or wxID_CANCEL
 return dlg.ShowModal();
#endif
}

References _, and UnsavedChangesDialog().

UnsavedChangesDialog() [2/2]

int UnsavedChangesDialog	(	wxWindow *	aParent,
		const wxString &	aMessage,
		bool *	aApplyToAll
	)

A specialized version of HandleUnsavedChanges which handles an apply-to-all checkbox.

Parameters

aParent	= the parent window
aMessage	= the main message to put in dialog
aApplyToAll	= if non-null an "Apply to all" checkbox will be shown and it's value written back to the bool.

Returns

wxID_YES, wxID_CANCEL, wxID_NO.

Definition at line 197 of file confirm.cpp.

{
 static bool s_apply_to_all = false;
 
 wxRichMessageDialog dlg( parent, aMessage, _( "Save Changes?" ),
 wxYES_NO | wxCANCEL | wxYES_DEFAULT | wxICON_WARNING | wxCENTER );
 dlg.SetExtendedMessage( _( "If you don't save, all your changes will be permanently lost." )
 + wxS( "\n" ) );
 dlg.SetYesNoLabels( _( "Save" ), _( "Discard Changes" ) );
 
 if( aApplyToAll )
 dlg.ShowCheckBox( _( "Apply to all" ), s_apply_to_all );
 
 int ret = dlg.ShowModal();
 
 if( aApplyToAll )
 {
 *aApplyToAll = dlg.IsCheckBoxChecked();
 s_apply_to_all = dlg.IsCheckBoxChecked();
 }
 
 // Returns wxID_YES, wxID_NO, or wxID_CANCEL
 return ret;
}

References _.

Referenced by SYMBOL_EDIT_FRAME::CanCloseSymbolFromSchematic(), HandleUnsavedChanges(), InvokeSchEditSymbolLibTable(), SYMBOL_EDIT_FRAME::saveAllLibraries(), and UnsavedChangesDialog().