26#include <nlohmann/json.hpp>
73#include <wx/display.h>
74#include <wx/stdpaths.h>
77#include <wx/wupdlock.h>
82#include <nlohmann/json.hpp>
95 return wxWindow::FromDIP( wxSize( 406, 354 ), aWindow );
98 return wxWindow::FromDIP( wxSize( 500, 400 ), aWindow );
108 return wxWindow::FromDIP( wxSize( 850, 540 ), aWindow );
111 return wxWindow::FromDIP( wxSize( 1280, 720 ), aWindow );
178 const wxPoint& aPos,
const wxSize& aSize,
long aStyle,
179 const wxString& aFrameName,
KIWAY* aKiway,
181 wxFrame( aParent, wxID_ANY, aTitle, aPos, aSize, aStyle, aFrameName ),
194 Bind( wxEVT_DPI_CHANGED,
195 [&]( wxDPIChangedEvent& aEvent )
201 wxAuiPaneInfoArray& panes =
m_auimgr.GetAllPanes();
203 for(
size_t ii = 0; ii < panes.GetCount(); ii++ )
205 wxAuiPaneInfo& pinfo = panes.Item( ii );
206 pinfo.best_size = pinfo.window->GetSize();
209 pinfo.best_size.IncTo( pinfo.window->GetBestSize() );
210 pinfo.best_size.IncTo( pinfo.min_size );
224 for( wxWindow* child : aParent->GetChildren() )
228 if( dlg->IsQuasiModal() )
249 wxWindow* cvpcb = wxWindow::FindWindowByName( wxS(
"CvpcbFrame" ) );
277 if( event.CanVeto() )
284 if( event.GetId() == wxEVT_QUERY_END_SESSION
285 || event.GetId() == wxEVT_END_SESSION )
312 if( event.CanVeto() )
342 if( !IsEnabled() && IsActive() )
356 if( aEvent.GetEventType() == wxEVT_DPI_CHANGED )
358 wxFrame::ProcessEvent( aEvent );
363 if( !wxFrame::ProcessEvent( aEvent ) )
366 if(
Pgm().m_Quitting )
375 wxLogTrace(
traceAutoSave, wxT(
"Starting auto save timer." ) );
386 wxLogTrace(
traceAutoSave, wxT(
"Stopping auto save timer." ) );
428 wxString stamp = aStamp.IsValid() ? aStamp.Format( wxS(
"%Y-%m-%d_%H%M%S" ) ) : wxString( wxS(
"unknown-time" ) );
430 wxFileName recovered( aSrcFn );
431 recovered.SetName( aSrcFn.GetName() + wxS(
".recovered." ) + stamp );
435 while( recovered.FileExists() )
437 recovered.SetName( aSrcFn.GetName() + wxS(
".recovered." ) + stamp + wxString::Format( wxS(
".%d" ), seq++ ) );
440 return recovered.GetFullPath();
464 for(
const auto& [autosavePath, srcPath] : selected )
466 if( !wxCopyFile( autosavePath, srcPath,
true ) )
468 wxLogError(
_(
"Failed to recover auto-saved file '%s'." ), srcPath );
472 wxRemoveFile( autosavePath );
477 for(
const auto& [autosavePath, srcPath] : selected )
479 if( wxFileExists( autosavePath ) )
480 wxRemoveFile( autosavePath );
485 for(
const auto& [autosavePath, srcPath] : selected )
487 wxFileName autosaveFn( autosavePath );
488 wxFileName srcFn( srcPath );
489 wxDateTime stamp = autosaveFn.FileExists() ? autosaveFn.GetModificationTime() : wxDateTime::Now();
493 if( !wxCopyFile( autosavePath, target,
true ) )
495 wxLogError(
_(
"Failed to write recovered file '%s'." ), target );
499 wxRemoveFile( autosavePath );
519 wxDateTime now = wxDateTime::Now();
524 wxTimeSpan maxDeferral = wxTimeSpan::Seconds( std::max( 60,
GetAutoSaveInterval() * 12 ) );
528 wxLogTrace(
traceAutoSave, wxT(
"Deferring auto save; an interactive operation is in progress." ) );
532 wxLogTrace(
traceAutoSave, wxT(
"Auto save deferral exceeded; saving despite interactive operation." ) );
592 std::placeholders::_1,
609 it->second( aEvent );
618 bool checkRes =
false;
619 bool enableRes =
true;
632 catch( std::exception& )
641 wxString msg =
_(
"Undo" );
646 aEvent.SetText( msg );
648 else if( showRes && aEvent.GetId() ==
ACTIONS::redo.GetUIId() )
650 wxString msg =
_(
"Redo" );
655 aEvent.SetText( msg );
658 if( isCut || isCopy || isPaste )
660 wxWindow* focus = wxWindow::FindFocus();
661 wxTextEntry* textEntry =
dynamic_cast<wxTextEntry*
>( focus );
663 if( textEntry && isCut && textEntry->CanCut() )
665 else if( textEntry && isCopy && textEntry->CanCopy() )
667 else if( textEntry && isPaste && textEntry->CanPaste() )
669 else if(
dynamic_cast<WX_GRID*
>( focus ) )
673 aEvent.Enable( enableRes );
674 aEvent.Show( showRes );
676 if( aEvent.IsCheckable() )
677 aEvent.Check( checkRes );
685 [] (
const SELECTION& aSel,
int aLangIdentifier )
690 for(
unsigned ii = 0;
LanguagesList[ii].m_KI_Lang_Identifier != 0; ii++ )
693 cond.
Check( std::bind( isCurrentLang, std::placeholders::_1,
711 if( control.first == aName )
712 return &control.second;
742 wxWindowUpdateLocker
dummy(
this );
758 std::optional<TOOLBAR_CONFIGURATION> tbConfig;
763 if( tbConfig.has_value() )
768 new ACTION_TOOLBAR(
this, wxID_ANY, wxDefaultPosition, wxDefaultSize,
773 m_tbRight->ApplyConfiguration( tbConfig.value() );
779 if( tbConfig.has_value() )
788 m_tbLeft->ApplyConfiguration( tbConfig.value() );
794 if( tbConfig.has_value() )
800 | wxAUI_TB_TEXT | wxAUI_TB_OVERFLOW );
804 m_tbTopMain->ApplyConfiguration( tbConfig.value() );
810 if( tbConfig.has_value() )
816 | wxAUI_TB_TEXT | wxAUI_TB_OVERFLOW );
820 m_tbTopAux->ApplyConfiguration( tbConfig.value() );
889 helpMenu->AppendSeparator();
892 aMenuBar->Append( helpMenu,
_(
"&Help" ) );
900 wxMenuBar* menuBar = GetMenuBar();
902 for(
size_t ii = 0; ii < menuBar->GetMenuCount(); ++ii )
904 for( wxMenuItem* menuItem : menuBar->GetMenu( ii )->GetMenuItems() )
906 if( menuItem->GetItemLabelText() == menuItemLabel )
908 wxString menuTitleLabel = menuBar->GetMenuLabelText( ii );
910 menuTitleLabel.Replace( wxS(
"&" ), wxS(
"&&" ) );
911 menuItemLabel.Replace( wxS(
"&" ), wxS(
"&&" ) );
913 return wxString::Format(
_(
"Run: %s > %s" ),
931 GetMenuBar()->Refresh();
952 m_fileHistory->SetMaxFiles( (
unsigned) std::max( 0, historySize ) );
955 if(
Pgm().GetCommonSettings()->m_Backup.enabled )
965 GetMenuBar()->Refresh();
978 wxAuiPaneInfoArray panes =
m_auimgr.GetAllPanes();
980 for(
size_t i = 0; i < panes.GetCount(); ++i )
983 toolbar->RefreshBitmaps();
991 int currentDisplay = wxDisplay::GetFromWindow(
this );
1008 if( !
Pgm().GetCommonSettings()->m_Session.remember_open_files )
1013 if( state !=
nullptr )
1022 bool wasDefault =
false;
1046 if( aState.
display >= wxDisplay::GetCount() )
1052 const unsigned int index = 0;
1053 wxDisplay display(
index );
1054 wxRect clientSize = display.GetGeometry();
1070 wxDisplay display( aState.
display );
1071 wxRect clientSize = display.GetClientArea();
1073 int yLimTop = clientSize.y;
1074 int yLimBottom = clientSize.y + clientSize.height;
1075 int xLimLeft = clientSize.x;
1076 int xLimRight = clientSize.x + clientSize.width;
1078 if( upperLeft.x > xLimRight ||
1079 upperRight.x < xLimLeft ||
1080 upperLeft.y < yLimTop ||
1081 upperLeft.y > yLimBottom )
1092 wxS(
"Clamping window width %d to display width %d" ),
1100 wxS(
"Clamping window height %d to display height %d" ),
1136 wxDisplay display( wxDisplay::GetFromWindow(
this ) );
1137 wxRect clientSize = display.GetClientArea();
1138 wxPoint pos = GetPosition();
1142 wxS(
"ensureWindowIsOnScreen: clientArea (%d, %d) w %d h %d" ),
1143 clientSize.x, clientSize.y,
1144 clientSize.width, clientSize.height );
1146 if( pos.y < clientSize.y )
1149 wxS(
"ensureWindowIsOnScreen: y pos %d below minimum, setting to %d" ), pos.y,
1151 pos.y = clientSize.y;
1154 if( pos.x < clientSize.x )
1157 wxS(
"ensureWindowIsOnScreen: x pos %d is off the client rect, setting to %d" ),
1158 pos.x, clientSize.x );
1159 pos.x = clientSize.x;
1162 if( pos.x + size.x - clientSize.x > clientSize.width )
1164 int newWidth = clientSize.width - ( pos.x - clientSize.x );
1166 wxS(
"ensureWindowIsOnScreen: effective width %d above available %d, setting "
1167 "to %d" ), pos.x + size.x, clientSize.width, newWidth );
1171 if( pos.y + size.y - clientSize.y > clientSize.height )
1173 int newHeight = clientSize.height - ( pos.y - clientSize.y );
1175 wxS(
"ensureWindowIsOnScreen: effective height %d above available %d, setting "
1176 "to %d" ), pos.y + size.y, clientSize.height, newHeight );
1180 wxLogTrace(
traceDisplayLocation, wxS(
"Updating window position (%d, %d) with size (%d, %d)" ),
1181 pos.x, pos.y, size.x, size.y );
1183 SetSize( pos.x, pos.y, size.x, size.y );
1221 aCfg->
state.
display = wxDisplay::GetFromWindow(
this );
1224 IsMaximized() ? wxS(
"true" ) : wxS(
"false" ) );
1231#if wxCHECK_VERSION( 3, 3, 0 )
1234 nlohmann::json state = serializer.
Serialize();
1236 if( state.is_null() || state.empty() )
1276 if(
Pgm().GetCommonSettings()->m_Session.remember_open_files && !currentlyOpenedFile.IsEmpty() )
1278 wxFileName rfn( currentlyOpenedFile );
1279 rfn.MakeRelativeTo(
Prj().GetProjectPath() );
1287 if( !currentlyOpenedFile.IsEmpty() )
1322 SetStatusText(
text );
1328#if defined( __WXOSX_MAC__ )
1340#if defined( __WXOSX_MAC__ )
1348 m_auimgr.GetPane( wxS(
"InfoBar" ) ).Hide();
1359 bool restored =
false;
1361#if wxCHECK_VERSION( 3, 3, 0 )
1384 wxAuiPaneInfoArray& panes =
m_auimgr.GetAllPanes();
1386 for(
size_t i = 0; i < panes.GetCount(); ++i )
1388 if( panes.Item( i ).IsToolbar() )
1389 panes.Item( i ).Show(
true );
1399 if( aShowCloseButton )
1407 std::function<
void(
void)> aCallback )
1411 if( aShowCloseButton )
1425 if( aShowCloseButton )
1436 if( aShowCloseButton )
1448 wxASSERT( aFileHistory );
1456 GetMenuBar()->Refresh();
1466 wxASSERT( aFileHistory );
1468 int baseId = aFileHistory->GetBaseId();
1470 wxASSERT( cmdId >= baseId && cmdId < baseId + (
int) aFileHistory->GetCount() );
1471 int i = cmdId - baseId;
1473 wxString fn = aFileHistory->GetHistoryFile( i );
1475 if( !wxFileName::FileExists( fn ) )
1478 wxYES_NO | wxYES_DEFAULT | wxICON_ERROR | wxCENTER );
1480 dlg.SetExtendedMessage(
_(
"Do you want to remove it from list of recently opened files?" ) );
1481 dlg.SetYesNoLabels( KICAD_MESSAGE_DIALOG::ButtonLabel(
_(
"Remove" ) ),
1482 KICAD_MESSAGE_DIALOG::ButtonLabel(
_(
"Keep" ) ) );
1484 if( dlg.ShowModal() == wxID_YES )
1485 aFileHistory->RemoveFileFromHistory( i );
1494 GetMenuBar()->Refresh();
1511 GetMenuBar()->Refresh();
1531 PAGED_DIALOG dlg(
this,
_(
"Preferences" ),
true,
true, wxEmptyString,
1532 wxWindow::FromDIP( wxSize( 980, 560 ),
nullptr ) );
1534 dlg.SetEvtHandlerEnabled(
false );
1541 std::vector<int> expand;
1547 ACTION_MANAGER* actionMgr = kicadMgr->GetToolManager()->GetActionManager();
1554 []( wxWindow* aParent ) -> wxWindow*
1561 []( wxWindow* aParent ) -> wxWindow*
1564 },
_(
"Mouse and Touchpad" ) );
1566#if defined(__linux__) || defined(__FreeBSD__)
1568 [] ( wxWindow* aParent ) -> wxWindow*
1571 },
_(
"SpaceMouse" ) );
1574 book->AddPage( hotkeysPanel,
_(
"Hotkeys" ) );
1577 []( wxWindow* aParent ) -> wxWindow*
1580 },
_(
"Version Control" ) );
1582#ifdef KICAD_USE_SENTRY
1584 []( wxWindow* aParent ) -> wxWindow*
1587 },
_(
"Data Collection" ) );
1590#define LAZY_CTOR( key ) \
1591 [this, kiface]( wxWindow* aParent ) \
1593 return kiface->CreateKiWindow( aParent, key, &Kiway() ); \
1605 expand.push_back( (
int) book->GetPageCount() );
1607 book->AddPage(
new wxPanel( book ),
_(
"Symbol Editor" ) );
1615 expand.push_back( (
int) book->GetPageCount() );
1617 book->AddPage(
new wxPanel( book ),
_(
"Schematic Editor" ) );
1639 expand.push_back( (
int) book->GetPageCount() );
1641 book->AddPage(
new wxPanel( book ),
_(
"Footprint Editor" ) );
1653 expand.push_back( (
int) book->GetPageCount() );
1655 book->AddPage(
new wxPanel( book ),
_(
"PCB Editor" ) );
1665 expand.push_back( (
int) book->GetPageCount() );
1667 book->AddPage(
new wxPanel( book ),
_(
"3D Viewer" ) );
1685 expand.push_back( (
int) book->GetPageCount() );
1687 book->AddPage(
new wxPanel( book ),
_(
"Gerber Viewer" ) );
1706 expand.push_back( (
int) book->GetPageCount() );
1708 book->AddPage(
new wxPanel( book ),
_(
"Drawing Sheet Editor" ) );
1715 []( wxWindow* aParent ) -> wxWindow*
1718 },
_(
"Packages and Updates" ) );
1733 for(
size_t i = 0; i < book->GetPageCount(); ++i )
1734 book->GetPage( i )->Layout();
1736 for(
int page : expand )
1737 book->ExpandNode( page );
1739 if( !aStartPage.IsEmpty() )
1742 dlg.SetEvtHandlerEnabled(
true );
1761 wxString* files = aEvent.GetFiles();
1763 for(
int nb = 0; nb < aEvent.GetNumberOfFiles(); nb++ )
1765 const wxFileName fn = wxFileName( files[nb] );
1766 wxString ext = fn.GetExt();
1785 wxString fn = file.GetFullPath();
1794 wxFileName fn = aFileName;
1800 if( fn.GetPath().IsEmpty() && fn.HasName() )
1803 wxCHECK_MSG( fn.IsOk(),
false,
1804 wxT(
"File name object is invalid. Bad programmer!" ) );
1805 wxCHECK_MSG( !fn.GetPath().IsEmpty(),
false,
1806 wxT(
"File name object path <" ) + fn.GetFullPath() +
1807 wxT(
"> is not set. Bad programmer!" ) );
1809 if( fn.IsDir() && !fn.IsDirWritable() )
1811 msg.Printf(
_(
"Insufficient permissions to folder '%s'." ), fn.GetPath() );
1813 else if( !fn.FileExists() && !fn.IsDirWritable() )
1815 msg.Printf(
_(
"Insufficient permissions to save file '%s'." ), fn.GetFullPath() );
1817 else if( fn.FileExists() && !fn.IsFileWritable() )
1819 msg.Printf(
_(
"Insufficient permissions to save file '%s'." ), fn.GetFullPath() );
1822 if( !msg.IsEmpty() )
1843 wxAcceleratorEntry entries[1];
1844 entries[0].Set( wxACCEL_CTRL,
int(
'Q' ), wxID_EXIT );
1845 wxAcceleratorTable accel( 1, entries );
1846 SetAcceleratorTable( accel );
1866 if( extraitems > 0 )
1881 if( extraitems > 0 )
1902 return m_undoList.m_CommandsList.back()->GetDescription();
1904 return wxEmptyString;
1911 return m_redoList.m_CommandsList.back()->GetDescription();
1913 return wxEmptyString;
1928 wxCommandEvent e( EDA_EVT_UNITS_CHANGED );
1929 e.SetInt(
static_cast<int>( aUnits ) );
1930 e.SetClientData(
this );
1931 ProcessEventLocally( e );
1943 if( !IsMaximized() )
1949 "Maximizing window - Saving position (%d, %d) with size (%d, %d)",
1961#if defined( __WXGTK__ ) && !wxCHECK_VERSION( 3, 2, 9 )
1962 wxSize winSize = GetSize();
1971 GTKDoGetSize( &width, &height );
1973 winSize.Set( width, height );
1976 wxSize winSize = GetSize();
1994 GetMenuBar()->Refresh();
2020WXLRESULT EDA_BASE_FRAME::MSWWindowProc( WXUINT message, WXWPARAM wParam, WXLPARAM lParam )
2024 if( message == WM_SYSCOMMAND )
2026 if( wParam == SC_KEYMENU && ( lParam >> 16 ) <= 0 )
2030 return wxFrame::MSWWindowProc( message, wParam, lParam );
2038 langsMenu->
SetTitle(
_(
"Set Language" ) );
2043 for(
unsigned ii = 0;
LanguagesList[ii].m_KI_Lang_Identifier != 0; ii++ )
2053 new wxMenuItem( langsMenu,
2055 label, tooltip, wxITEM_CHECK );
2057 langsMenu->Append( item );
2061 aMasterMenu->
Add( langsMenu );
2067 int id =
event.GetId();
void ShowAboutDialog(EDA_BASE_FRAME *aParent)
KIFACE_BASE & Kiface()
Global KIFACE_BASE "get" accessor.
void ClearScaledBitmapCache()
Wipes out the scaled bitmap cache so that the icon theme can be changed.
BITMAP_STORE * GetBitmapStore()
static TOOL_ACTION reportBug
static TOOL_ACTION donate
static TOOL_ACTION listHotKeys
static TOOL_ACTION getInvolved
static TOOL_ACTION gettingStarted
Manage TOOL_ACTION objects.
const std::map< std::string, TOOL_ACTION * > & GetActions() const
Get a list of currently-registered actions mapped by their name.
static const ADVANCED_CFG & GetCfg()
Get the singleton instance's config, which is shared by all consumers.
APP_SETTINGS_BASE is a settings class that should be derived for each standalone KiCad application.
void ThemeChanged()
Notifies the store that the icon theme has been changed by the user, so caches must be invalidated.
Handle actions that are shared between different applications.
std::vector< std::pair< wxString, wxString > > GetSelectedStale() const
AUTOSAVE_RECOVERY_CHOICE GetChoice() const
Dialog helper object to sit in the inheritance tree between wxDialog and any class written by wxFormB...
The base frame for deriving all KiCad main window classes.
virtual wxString help_name()
virtual bool doAutoSave()
This should be overridden by the derived class to handle the auto save feature.
void LoadWindowState(const wxString &aFileName)
FRAME_T GetFrameType() const
virtual void UnregisterUIUpdateHandler(int aID) override
Unregister a UI handler for a given ID that was registered using RegisterUIUpdateHandler.
virtual bool isAutoSaveRequired() const
Return the auto save status of the application.
virtual APP_SETTINGS_BASE * config() const
Return the settings object used in SaveSettings(), and is overloaded in KICAD_MANAGER_FRAME.
virtual void handleIconizeEvent(wxIconizeEvent &aEvent)
Handle a window iconize event.
virtual void PushCommandToUndoList(PICKED_ITEMS_LIST *aItem)
Add a command to undo in the undo list.
void windowClosing(wxCloseEvent &event)
(with its unexpected name so it does not collide with the real OnWindowClose() function provided in d...
virtual void OnCharHook(wxKeyEvent &aKeyEvent)
Capture the key event before it is sent to the GUI.
virtual int GetRedoCommandCount() const
void CommonSettingsChanged(int aFlags) override
Notification event that some of the common (suite-wide) settings have changed.
UNDO_REDO_CONTAINER m_undoList
virtual void OnMove(wxMoveEvent &aEvent)
virtual WINDOW_SETTINGS * GetWindowSettings(APP_SETTINGS_BASE *aCfg)
Return a pointer to the window settings for this frame.
virtual void doCloseWindow()
void OnToolbarSizeChanged()
Update toolbars if desired toolbar icon changed.
void OnMenuEvent(wxMenuEvent &event)
The TOOL_DISPATCHER needs these to work around some issues in wxWidgets where the menu events aren't ...
virtual bool IsModal() const
Return true if the frame is shown in our modal mode and false if the frame is shown as an usual frame...
void ShowChangedLanguage() override
Redraw the menus and what not in current language.
virtual void HandleSystemColorChange()
Update the UI in response to a change in the system colors.
virtual void setupUIConditions()
Setup the UI conditions for the various actions and their controls in this frame.
void ensureWindowIsOnScreen()
bool m_isNonUserClose
Set by NonUserClose() to indicate that the user did not request the current close.
void CheckForAutosaveFiles(const wxString &aProjectPath, const std::vector< wxString > &aExtensions)
Check for autosave files newer than their source files for the given project.
void LoadWindowSettings(const WINDOW_SETTINGS *aCfg)
Load window settings from the given settings object.
std::vector< wxFileName > m_AcceptedFiles
bool m_uiUpdateHandlerBound
True once the single wxID_ANY UPDATE_UI handler has been bound.
bool m_autoSavePermissionError
void OnKicadAbout(wxCommandEvent &event)
virtual void UpdateToolbarControlSizes()
Update the sizes of any controls in the toolbars of the frame.
virtual void ClearUndoRedoList()
Clear the undo and redo list using ClearUndoORRedoList()
virtual void DoWithAcceptedFiles()
Execute action on accepted dropped file.
virtual void OnModify()
Must be called after a model change in order to set the "modify" flag and do other frame-specific pro...
wxWindow * findQuasiModalDialog()
wxDateTime m_autoSaveDeferredSince
virtual void ClearUndoORRedoList(UNDO_REDO_LIST aList, int aItemCount=-1)
Remove the aItemCount of old commands from aList and delete commands, pickers and picked items if nee...
virtual void ThemeChanged()
Process light/dark theme change.
EDA_BASE_FRAME(wxWindow *aParent, FRAME_T aFrameType, const wxString &aTitle, const wxPoint &aPos, const wxSize &aSize, long aStyle, const wxString &aFrameName, KIWAY *aKiway, const EDA_IU_SCALE &aIuScale)
static constexpr int KICAD_AUI_TB_STYLE
Default style flags used for wxAUI toolbars.
ACTION_TOOLBAR * m_tbRight
void ShowPreferences(wxString aStartPage, wxString aStartParentPage)
Display the preferences and settings of all opened editors paged dialog, starting with a particular p...
void initExitKey()
Set the common key-pair for exiting the application (Ctrl-Q) and ties it to the wxID_EXIT event id.
void OnPreferences(wxCommandEvent &event)
virtual const SEARCH_STACK & sys_search()
Return a SEARCH_STACK pertaining to entire program.
void onAutoSaveTimer(wxTimerEvent &aEvent)
Handle the auto save timer event.
void SaveWindowSettings(WINDOW_SETTINGS *aCfg)
Save window settings to the given settings object.
virtual wxString GetRedoActionDescription() const
TOOLBAR_SETTINGS * m_toolbarSettings
void FinishAUIInitialization()
virtual wxString GetCurrentFileName() const
Get the full filename + path of the currently opened file in the frame.
void ChangeUserUnits(EDA_UNITS aUnits)
void AddMenuLanguageList(ACTION_MENU *aMasterMenu, TOOL_INTERACTIVE *aControlTool)
Create a menu list for language choice, and add it as submenu to MasterMenu.
virtual bool canRunAutoSave() const
Return true when it is safe to run an autosave snapshot right now.
void RegisterCustomToolbarControlFactory(const ACTION_TOOLBAR_CONTROL &aControlDesc, const ACTION_TOOLBAR_CONTROL_FACTORY &aControlFactory)
Register a creation factory for toolbar controls that are present in this frame.
void ShowInfoBarMsg(const wxString &aMsg, bool aShowCloseButton=false)
Show the WX_INFOBAR displayed on the top of the canvas with a message and an info icon on the left of...
virtual void configureToolbars()
wxTimer * m_autoSaveTimer
void ShowInfoBarError(const wxString &aErrorMsg, bool aShowCloseButton=false, INFOBAR_MESSAGE_TYPE aType=INFOBAR_MESSAGE_TYPE::GENERIC)
Show the WX_INFOBAR displayed on the top of the canvas with a message and an error icon on the left o...
void UpdateFileHistory(const wxString &FullFileName, FILE_HISTORY *aFileHistory=nullptr)
Update the list of recently opened files.
void PrintMsg(const wxString &text)
void SelectToolbarAction(const TOOL_ACTION &aAction)
Select the given action in the toolbar group which contains it, if any.
void onUpdateUI(wxUpdateUIEvent &aEvent)
void commonInit(FRAME_T aFrameType)
Collect common initialization functions used in all CTORs.
virtual bool IsContentModified() const
Get if the contents of the frame have been modified since the last save.
void ShowInfoBarWarning(const wxString &aWarningMsg, bool aShowCloseButton=false)
Show the WX_INFOBAR displayed on the top of the canvas with a message and a warning icon on the left ...
virtual PICKED_ITEMS_LIST * PopCommandFromRedoList()
Return the last command to undo and remove it from list, nothing is deleted.
virtual void RecreateToolbars()
std::map< int, UIUpdateHandler > m_uiUpdateMap
Map containing the UI update handlers registered with wx for each action.
std::map< std::string, ACTION_TOOLBAR_CONTROL_FACTORY > m_toolbarControlFactories
ACTION_TOOLBAR_CONTROL_FACTORY * GetCustomToolbarControlFactory(const std::string &aName)
static void HandleUpdateUIEvent(wxUpdateUIEvent &aEvent, EDA_BASE_FRAME *aFrame, ACTION_CONDITIONS &aCond)
Handle events generated when the UI is trying to figure out the current state of the UI controls rela...
UNDO_REDO_CONTAINER m_redoList
virtual void LoadSettings(APP_SETTINGS_BASE *aCfg)
Load common frame parameters from a configuration file.
FILE_HISTORY * m_fileHistory
ACTION_TOOLBAR * m_tbLeft
SETTINGS_MANAGER * m_settingsManager
virtual void OnSize(wxSizeEvent &aEvent)
virtual wxString GetUndoActionDescription() const
virtual PICKED_ITEMS_LIST * PopCommandFromUndoList()
Return the last command to undo and remove it from list, nothing is deleted.
void OnLanguageSelectionEvent(wxCommandEvent &aEvent)
An event handler called on a language menu selection.
wxString GetRunMenuCommandDescription(const TOOL_ACTION &aAction)
virtual bool canCloseWindow(wxCloseEvent &aCloseEvent)
bool ProcessEvent(wxEvent &aEvent) override
Override the default process event handler to implement the auto save feature.
bool IsWritable(const wxFileName &aFileName, bool aVerbose=true)
Check if aFileName can be written.
void OnMaximize(wxMaximizeEvent &aEvent)
std::unique_ptr< nlohmann::json > m_auiLayoutState
virtual void ClearFileHistory()
Remove all files from the file history.
ACTION_TOOLBAR * m_tbTopAux
virtual void OnDropFiles(wxDropFilesEvent &aEvent)
Handle event fired when a file is dropped to the window.
std::map< const wxString, TOOL_ACTION * > m_acceptedExts
Associate file extensions with action to execute.
void onIconize(wxIconizeEvent &aEvent)
virtual void unitsChangeRefresh()
Called when when the units setting has changed to allow for any derived classes to handle refreshing ...
wxString GetFileFromHistory(int cmdId, const wxString &type, FILE_HISTORY *aFileHistory=nullptr)
Fetch the file name from the file history list.
wxSize GetWindowSize()
Get the undecorated window size that can be used for restoring the window size.
int GetAutoSaveInterval() const
virtual void SaveSettings(APP_SETTINGS_BASE *aCfg)
Save common frame parameters to a configuration data file.
void onSystemColorChange(wxSysColourChangedEvent &aEvent)
virtual int GetUndoCommandCount() const
virtual void RegisterUIUpdateHandler(int aID, const ACTION_CONDITIONS &aConditions) override
Register a UI update handler for the control with ID aID.
ACTION_TOOLBAR * m_tbTopMain
virtual void PushCommandToRedoList(PICKED_ITEMS_LIST *aItem)
Add a command to redo in the redo list.
bool m_isClosing
Set by the close window event handler after frames are asked if they can close.
void AddStandardHelpMenu(wxMenuBar *aMenuBar)
Add the standard KiCad help menu to the menubar.
void ReCreateMenuBar()
Recreate the menu bar.
virtual void doReCreateMenuBar()
WX_INFOBAR * GetInfoBar()
Specialization of the wxAuiPaneInfo class for KiCad panels.
This class implements a file history object to store a list of files, that can then be added to a men...
void AddFileToHistory(const wxString &aFile) override
Adds a file to the history.
The main KiCad project manager frame.
SEARCH_STACK & KifaceSearch()
Only for DSO specific 'non-library' files.
APP_SETTINGS_BASE * KifaceSettings() const
const wxString & GetHelpFileName() const
Return just the basename portion of the current help file.
PROJECT & Prj() const
Return a reference to the PROJECT associated with this KIWAY.
KIWAY_HOLDER(KIWAY *aKiway, HOLDER_TYPE aType)
KIWAY & Kiway() const
Return a reference to the KIWAY that this object has an opportunity to participate in.
A minimalistic software bus for communications between various DLLs/DSOs (DSOs) within the same KiCad...
virtual void SetLanguage(int aLanguage)
Change the language and then calls ShowChangedLanguage() on all #KIWAY_PLAYERs.
LOCAL_HISTORY & LocalHistory()
Return the LOCAL_HISTORY associated with this KIWAY.
virtual void CommonSettingsChanged(int aFlags=0)
Call CommonSettingsChanged() on all KIWAY_PLAYERs.
bool RunRegisteredSaversAndCommit(const wxString &aProjectPath, const wxString &aTitle, const wxString &aTagFileType=wxEmptyString)
Run all registered savers and, if any staged changes differ from HEAD, create a commit.
std::vector< std::pair< wxString, wxString > > FindStaleAutosaveFiles(const wxString &aProjectPath, const std::vector< wxString > &aExtensions) const
Enumerate autosave files newer than their corresponding source files for the project at aProjectPath,...
bool Init(const wxString &aProjectPath)
Initialize the local history repository for the given project path.
bool RunRegisteredSaversAsAutosaveFiles(const wxString &aProjectPath)
Run all registered savers and write their output to autosave files instead of committing to the local...
WX_TREEBOOK * GetTreebook()
void SetInitialPage(const wxString &aPage, const wxString &aParentPage=wxEmptyString)
std::vector< TOOL_ACTION * > & ActionsList()
static wxString GetDefaultUserProjectsPath()
Gets the default path we point users to create projects.
virtual COMMON_SETTINGS * GetCommonSettings() const
virtual int GetSelectedLanguageIdentifier() const
KICAD_API_SERVER & GetApiServer()
virtual SETTINGS_MANAGER & GetSettingsManager() const
A holder to handle information on schematic or board items.
void SaveFileState(const wxString &aFileName, const WINDOW_SETTINGS *aWindowCfg, bool aOpen)
const PROJECT_FILE_STATE * GetFileState(const wxString &aFileName)
virtual PROJECT_LOCAL_SETTINGS & GetLocalSettings() const
Look for files in a number of paths.
UNITS_PROVIDER(const EDA_IU_SCALE &aIuScale, EDA_UNITS aUnits)
void SetUserUnits(EDA_UNITS aUnits)
bool Deserialize(const nlohmann::json &aState) const
nlohmann::json Serialize() const
Simple wrapper around wxBusyCursor for used with the generic BUSY_INDICATOR interface.
A modified version of the wxInfoBar class that allows us to:
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.
bool AddLazyPage(std::function< wxWindow *(wxWindow *aParent)> aLazyCtor, const wxString &text, bool bSelect=false, int imageId=NO_IMAGE)
bool AddLazySubPage(std::function< wxWindow *(wxWindow *aParent)> aLazyCtor, const wxString &text, bool bSelect=false, int imageId=NO_IMAGE)
@ ZIP
Zip archive snapshots; autosave uses recovery files.
@ INCREMENTAL
Git-based local history (default)
@ PROJECT_DIR
Inside the project directory (default)
void DisplayErrorMessage(wxWindow *aParent, const wxString &aText, const wxString &aExtraInfo)
Display an error message with aMessage.
This file is part of the common library.
#define KICAD_MESSAGE_DIALOG
const int minSize
Push and Shove router track width and via size dialog.
static wxString buildRecoveredFileName(const wxFileName &aSrcFn, const wxDateTime &aStamp)
static const wxSize minSizeLookup(FRAME_T aFrameType, wxWindow *aWindow)
static const wxSize defaultSize(FRAME_T aFrameType, wxWindow *aWindow)
wxWindow * findQuasiModalDialog(wxWindow *aParent)
Base window classes and related definitions.
#define KICAD_MANAGER_FRAME_NAME
std::function< void(ACTION_TOOLBAR *)> ACTION_TOOLBAR_CONTROL_FACTORY
#define DEFAULT_MAX_UNDO_ITEMS
void SocketCleanup()
Must be called to clean up the socket thread used by SendCommand.
EVT_MENU_RANGE(ID_GERBVIEW_DRILL_FILE1, ID_GERBVIEW_DRILL_FILEMAX, GERBVIEW_FRAME::OnDrlFileHistory) EVT_MENU_RANGE(ID_GERBVIEW_ZIP_FILE1
FRAME_T
The set of EDA_BASE_FRAME derivatives, typically stored in EDA_BASE_FRAME::m_Ident.
@ FRAME_SCH_SYMBOL_EDITOR
@ PANEL_SCH_FIELD_NAME_TEMPLATES
@ PANEL_GBR_DISPLAY_OPTIONS
@ PANEL_FP_DEFAULT_GRAPHICS_VALUES
@ PANEL_FP_DISPLAY_OPTIONS
@ PANEL_FP_DEFAULT_FIELDS
@ PANEL_PCB_ACTION_PLUGINS
@ PANEL_3DV_DISPLAY_OPTIONS
@ PANEL_DS_DISPLAY_OPTIONS
@ PANEL_GBR_EXCELLON_OPTIONS
static const std::string GerberFileExtension
static bool IsGerberFileExtension(const wxString &ext)
const wxChar *const traceAutoSave
Flag to enable auto save feature debug tracing.
const wxChar *const kicadTraceKeyEvent
Flag to enable wxKeyEvent debug tracing.
const wxChar *const traceDisplayLocation
Flag to enable debug output of display positioning logic.
void ReadHotKeyConfigIntoActions(const wxString &aFileName, std::vector< TOOL_ACTION * > &aActions)
Read a hotkey config file into a list of actions.
EVT_MENU(ID_COMPARE_PROJECT_BRANCHES, KICAD_MANAGER_FRAME::OnCompareProjectBranches) KICAD_MANAGER_FRAME
PGM_BASE & Pgm()
The global program "get" accessor.
LANGUAGE_DESCR LanguagesList[]
An array containing all the languages that KiCad supports.
std::vector< FAB_LAYER_COLOR > dummy
Functors that can be used to figure out how the action controls should be displayed in the UI and if ...
SELECTION_CONDITION enableCondition
Returns true if the UI control should be enabled.
SELECTION_CONDITION checkCondition
Returns true if the UI control should be checked.
SELECTION_CONDITION showCondition
Returns true if the UI control should be shown.
ACTION_CONDITIONS & Check(const SELECTION_CONDITION &aCondition)
BACKUP_LOCATION location
Where backups, history, and autosave files live.
BACKUP_FORMAT format
Backup format (incremental git history vs zip archives)
int local_history_debounce
Implement a participant in the KIWAY alchemy.
struct WINDOW_STATE window
Store the common settings that are saved and loaded for each window / frame.
Store the window positioning/state.
IFACE KIFACE_BASE kiface("pcb_test_frame", KIWAY::FACE_PCB)
static const long long MM
wxString dump(const wxArrayString &aArray)
Debug helper for printing wxArrayString contents.
wxLogTrace helper definitions.
INFOBAR_MESSAGE_TYPE
Sets the type of message for special handling if needed.