Class EDA_BASE_FRAME is the base frame for deriving all KiCad main window classes. More...

#include <wxstruct.h>

Inheritance diagram for EDA_BASE_FRAME:

Public Member Functions
	EDA_BASE_FRAME (wxWindow *aParent, FRAME_T aFrameType, const wxString &aTitle, const wxPoint &aPos, const wxSize &aSize, long aStyle, const wxString &aFrameName)

	~EDA_BASE_FRAME ()

bool	ProcessEvent (wxEvent &aEvent) override
	Function ProcessEvent overrides the default process event handler to implement the auto save feature. More...

bool	Enable (bool enable) override

void	SetAutoSaveInterval (int aInterval)

int	GetAutoSaveInterval () const

bool	IsType (FRAME_T aType) const

void	GetKicadHelp (wxCommandEvent &event)

void	GetKicadContribute (wxCommandEvent &event)

void	GetKicadAbout (wxCommandEvent &event)

void	PrintMsg (const wxString &text)

virtual void	LoadSettings (wxConfigBase *aCfg)
	Function LoadSettings loads common frame parameters from a configuration file. More...

virtual void	SaveSettings (wxConfigBase *aCfg)
	Function SaveSettings saves common frame parameters to a configuration data file. More...

wxString	ConfigBaseName ()
	Function ConfigBaseName. More...

virtual void	SaveProjectSettings (bool aAskForSave)
	Function SaveProjectSettings saves changes to the project settings to the project (.pro) file. More...

virtual void	OnSelectPreferredEditor (wxCommandEvent &event)
	Function OnSelectPreferredEditor Open a dialog to select the editor that will used in KiCad to edit or display files (reports ... More...

int	ReadHotkeyConfig (struct EDA_HOTKEY_CONFIG *aDescList)
	Function ReadHotkeyConfig Read configuration data and fill the current hotkey list with hotkeys. More...

virtual int	WriteHotkeyConfig (struct EDA_HOTKEY_CONFIG aDescList, wxString aFullFileName=NULL)
	Function WriteHotkeyConfig Store the current hotkey list It is stored using the standard wxConfig mechanism or a file. More...

int	ReadHotkeyConfigFile (const wxString &aFilename, struct EDA_HOTKEY_CONFIG *aDescList)
	Function ReadHotkeyConfigFile Read an old configuration file (&ltfile&gt.key) and fill the current hotkey list with hotkeys. More...

void	ImportHotkeyConfigFromFile (EDA_HOTKEY_CONFIG *aDescList, const wxString &aDefaultShortname)
	Function ImportHotkeyConfigFromFile Prompt the user for an old hotkey file to read, and read it. More...

void	ExportHotkeyConfigToFile (EDA_HOTKEY_CONFIG *aDescList, const wxString &aDefaultShortname)
	Function ExportHotkeyConfigToFile Prompt the user for an old hotkey file to read, and read it. More...

wxString	GetFileFromHistory (int cmdId, const wxString &type, wxFileHistory *aFileHistory=NULL)
	Function GetFileFromHistory fetches the file name from the file history list. More...

void	UpdateFileHistory (const wxString &FullFileName, wxFileHistory *aFileHistory=NULL)
	Function UpdateFileHistory Updates the list of recently opened files. More...

void	SetMruPath (const wxString &aPath)

wxString	GetMruPath () const

virtual void	ReCreateMenuBar ()
	Function ReCreateMenuBar Creates recreates the menu bar. More...

bool	IsWritable (const wxFileName &aFileName)
	Function IsWritable checks if aFileName can be written. More...

void	CheckForAutoSaveFile (const wxFileName &aFileName, const wxString &aBackupFileExtension)
	Function CheckForAutoSaveFile checks if an auto save file exists for aFileName and takes the appropriate action depending on the user input. More...

virtual void	ShowChangedLanguage ()
	Function ShowChangedLanguage redraws the menus and what not in current language. More...

virtual void	OnChangeIconsOptions (wxCommandEvent &event)
	Function OnChangeIconsOptions Selects the current icons options in menus (or toolbars) in Kicad (the default for toolbars/menus is 26x26 pixels, and shows icons in menus). More...

virtual void	ShowChangedIcons ()
	Function ShowChangedIcons redraws items menus after a icon was changed option. More...

void	AddMenuIconsOptions (wxMenu *MasterMenu)
	Function AddMenuIconsOptions creates a menu list for icons in menu and icon sizes choice, and add it as submenu to MasterMenu. More...

bool	PostCommandMenuEvent (int evt_type)
	Function PostCommandMenuEvent. More...

Protected Member Functions
void	onAutoSaveTimer (wxTimerEvent &aEvent)
	Function onAutoSaveTimer handles the auto save timer event. More...

virtual bool	isAutoSaveRequired () const
	Function autoSaveRequired returns the auto save status of the application. More...

virtual bool	doAutoSave ()
	Function doAutoSave should be overridden by the derived class to handle the auto save feature. More...

virtual wxConfigBase *	config ()
	Function config returns the wxConfigBase used in SaveSettings(), and is overloaded in KICAD_MANAGER_FRAME. More...

virtual const SEARCH_STACK &	sys_search ()
	Function sys_search returns a SEARCH_STACK pertaining to entire program, and is overloaded in KICAD_MANAGER_FRAME. More...

virtual wxString	help_name ()

Protected Attributes
FRAME_T	m_Ident
	Id Type (pcb, schematic, library..) More...

wxPoint	m_FramePos

wxSize	m_FrameSize

wxString	m_configFrameName
	prefix used in config to identify some params (frame size...) if empty, the frame name defined in CTOR is used More...

wxAuiToolBar *	m_mainToolBar
	Standard horizontal Toolbar. More...

wxString	m_AboutTitle
	Name of program displayed in About. More...

wxAuiManager	m_auimgr

bool	m_hasAutoSave
	Flag to indicate if this frame supports auto save. More...

bool	m_autoSaveState
	Flag to indicate the last auto save state. More...

int	m_autoSaveInterval
	The auto save interval time in seconds. More...

wxTimer *	m_autoSaveTimer
	The timer used to implement the auto save feature;. More...

wxString	m_perspective
	wxAuiManager perspective. More...

wxString	m_mruPath
	Most recently used path. More...

Private Member Functions
void	windowClosing (wxCloseEvent &event)
	Function windowClosing (with its unexpected name so it does not collide with the real OnWindowClose() function provided in derived classes) is called just before a window closing, and is used to call a derivation specific SaveSettings(). More...

Detailed Description

Class EDA_BASE_FRAME is the base frame for deriving all KiCad main window classes.

This class is not intended to be used directly. It provides support for automatic calls to a SaveSettings() function. SaveSettings() for a derived class can choose to do nothing, or rely on basic SaveSettings() support in this base class to do most of the work by calling it from the derived class's SaveSettings().

This class is not a KIWAY_PLAYER because KICAD_MANAGER_FRAME is derived from it and that class is not a player.

Definition at line 117 of file wxstruct.h.

Constructor & Destructor Documentation

EDA_BASE_FRAME::EDA_BASE_FRAME	(	wxWindow *	aParent,
		FRAME_T	aFrameType,
		const wxString &	aTitle,
		const wxPoint &	aPos,
		const wxSize &	aSize,
		long	aStyle,
		const wxString &	aFrameName
	)

Definition at line 74 of file basicframe.cpp.

References ID_AUTO_SAVE_TIMER, m_autoSaveInterval, m_autoSaveState, m_autoSaveTimer, m_FramePos, m_FrameSize, m_hasAutoSave, m_Ident, m_mainToolBar, m_mruPath, onAutoSaveTimer(), windowClosing(), wxPoint::x, and wxPoint::y.

                                                   :
     wxFrame( aParent, wxID_ANY, aTitle, aPos, aSize, aStyle, aFrameName )
 {
     wxSize minsize;
 
     m_Ident = aFrameType;
     m_mainToolBar = NULL;
     m_hasAutoSave = false;
     m_autoSaveState = false;
     m_autoSaveInterval = -1;
     m_autoSaveTimer = new wxTimer( this, ID_AUTO_SAVE_TIMER );
     m_mruPath = wxStandardPaths::Get().GetDocumentsDir();
     minsize.x = 470;
     minsize.y = 350;
 
     SetSizeHints( minsize.x, minsize.y, -1, -1, -1, -1 );
 
     if( ( aSize.x < minsize.x ) || ( aSize.y < minsize.y ) )
         SetSize( 0, 0, minsize.x, minsize.y );
 
     // Create child subwindows.
 
     // Dimensions of the user area of the main window.
     GetClientSize( &m_FrameSize.x, &m_FrameSize.y );
 
     m_FramePos.x = m_FramePos.y = 0;
 
     Connect( ID_AUTO_SAVE_TIMER, wxEVT_TIMER,
              wxTimerEventHandler( EDA_BASE_FRAME::onAutoSaveTimer ) );
 
     // hook wxEVT_CLOSE_WINDOW so we can call SaveSettings().  This function seems
     // to be called before any other hook for wxCloseEvent, which is necessary.
     Connect( wxEVT_CLOSE_WINDOW, wxCloseEventHandler( EDA_BASE_FRAME::windowClosing ) );
 }

EDA_BASE_FRAME::~EDA_BASE_FRAME ( )

Definition at line 156 of file basicframe.cpp.

References m_autoSaveTimer.

 {
     delete m_autoSaveTimer;
 
     // This is needed for OSX: avoids further OnDraw processing after this
     // destructor and before the native window is destroyed
     this->Freeze();
 }

Member Function Documentation

void EDA_BASE_FRAME::AddMenuIconsOptions ( wxMenu * MasterMenu )

Function AddMenuIconsOptions creates a menu list for icons in menu and icon sizes choice, and add it as submenu to MasterMenu.

Parameters

MasterMenu The main menu. The sub menu list will be accessible from the menu item with id ID_KICAD_SELECT_ICONS_OPTIONS

Definition at line 673 of file basicframe.cpp.

References AddMenuItem(), ID_KICAD_SELECT_ICONS_IN_MENUS, ID_KICAD_SELECT_ICONS_OPTIONS, KiBitmap(), and Pgm().

Referenced by preparePreferencesMenu(), PL_EDITOR_FRAME::ReCreateMenuBar(), KICAD_MANAGER_FRAME::ReCreateMenuBar(), and GERBVIEW_FRAME::ReCreateMenuBar().

 {
     wxMenu*      menu = NULL;
     wxMenuItem*  item = MasterMenu->FindItem( ID_KICAD_SELECT_ICONS_OPTIONS );
 
     if( item )     // This menu exists, do nothing
         return;
 
     menu = new wxMenu;
 
     menu->Append( new wxMenuItem( menu, ID_KICAD_SELECT_ICONS_IN_MENUS,
                   _( "Icons in Menus" ), wxEmptyString,
                   wxITEM_CHECK ) );
     menu->Check( ID_KICAD_SELECT_ICONS_IN_MENUS, Pgm().GetUseIconsInMenus() );
 
     AddMenuItem( MasterMenu, menu,
                  ID_KICAD_SELECT_ICONS_OPTIONS,
                  _( "Icons Options" ),
                  _( "Select show icons in menus and icons sizes" ),
                  KiBitmap( icon_xpm ) );
 }

void EDA_BASE_FRAME::CheckForAutoSaveFile	(	const wxFileName &	aFileName,
		const wxString &	aBackupFileExtension
	)

Function CheckForAutoSaveFile checks if an auto save file exists for aFileName and takes the appropriate action depending on the user input.

If an auto save file exists for aFileName, the user is prompted if they wish to replace file aFileName with the auto saved file. If the user chooses to replace the file, the backup file of aFileName is removed, aFileName is renamed to the backup file name, and the auto save file is renamed to aFileName. If user chooses to keep the existing version of aFileName, the auto save file is removed.

Parameters

aFileName	A wxFileName object containing the file name to check.
aBackupFileExtension	A wxString object containing the backup file extension used to create the backup file name.

Definition at line 578 of file basicframe.cpp.

References AUTOSAVE_PREFIX_FILENAME, Format(), GetChars(), Pgm(), and traceAutoSave.

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

 {
     wxCHECK_RET( aFileName.IsOk(), wxT( "Invalid file name!" ) );
     wxCHECK_RET( !aBackupFileExtension.IsEmpty(), wxT( "Invalid backup file extension!" ) );
 
     wxFileName autoSaveFileName = aFileName;
 
     // Check for auto save file.
     autoSaveFileName.SetName( AUTOSAVE_PREFIX_FILENAME + aFileName.GetName() );
 
     wxLogTrace( traceAutoSave,
                 wxT( "Checking for auto save file " ) + autoSaveFileName.GetFullPath() );
 
     if( !autoSaveFileName.FileExists() )
         return;
 
     wxString msg = wxString::Format( _(
             "Well this is potentially embarrassing!\n"
             "It appears that the last time you were editing the file\n"
             "'%s'\n"
             "it was not saved properly.  Do you wish to restore the last saved edits you made?" ),
             GetChars( aFileName.GetFullName() )
         );
 
     int response = wxMessageBox( msg, Pgm().App().GetAppName(), wxYES_NO | wxICON_QUESTION, this );
 
     // Make a backup of the current file, delete the file, and rename the auto save file to
     // the file name.
     if( response == wxYES )
     {
         // Get the backup file name.
         wxFileName backupFileName = aFileName;
         backupFileName.SetExt( aBackupFileExtension );
 
         // If an old backup file exists, delete it.  If an old copy of the file exists, rename
         // it to the backup file name
         if( aFileName.FileExists() )
         {
             // Remove the old file backup file.
             if( backupFileName.FileExists() )
                 wxRemoveFile( backupFileName.GetFullPath() );
 
             // Rename the old file to the backup file name.
             if( !wxRenameFile( aFileName.GetFullPath(), backupFileName.GetFullPath() ) )
             {
                 msg.Printf( _( "Could not create backup file <%s>" ),
                             GetChars( backupFileName.GetFullPath() ) );
                 wxMessageBox( msg );
             }
         }
 
         if( !wxRenameFile( autoSaveFileName.GetFullPath(), aFileName.GetFullPath() ) )
         {
             wxMessageBox( _( "The auto save file could not be renamed to the board file name." ),
                           Pgm().App().GetAppName(), wxOK | wxICON_EXCLAMATION, this );
         }
     }
     else
     {
         wxLogTrace( traceAutoSave,
                     wxT( "Removing auto save file " ) + autoSaveFileName.GetFullPath() );
 
         // Remove the auto save file when using the previous file as is.
         wxRemoveFile( autoSaveFileName.GetFullPath() );
     }
 }

wxConfigBase * EDA_BASE_FRAME::config ( )

protectedvirtual

Function config returns the wxConfigBase used in SaveSettings(), and is overloaded in KICAD_MANAGER_FRAME.

Reimplemented in KICAD_MANAGER_FRAME.

Definition at line 361 of file basicframe.cpp.

References Kiface(), and KIFACE_I::KifaceSettings().

Referenced by CVPCB_MAINFRAME::CVPCB_MAINFRAME(), FOOTPRINT_WIZARD_FRAME::DisplayBuildMessage(), FOOTPRINT_EDIT_FRAME::Export_Module(), GERBVIEW_FRAME::GERBVIEW_FRAME(), PCB_EDIT_FRAME::GetSettings(), FOOTPRINT_EDIT_FRAME::Import_Module(), LIB_EDIT_FRAME::LIB_EDIT_FRAME(), SIM_PLOT_FRAME::onClose(), FOOTPRINT_WIZARD_FRAME::OnCloseWindow(), LIB_EDIT_FRAME::OnPreferencesOptions(), SCH_EDIT_FRAME::OnPreferencesOptions(), SCH_EDIT_FRAME::OpenProjectFiles(), PL_EDITOR_FRAME::PL_EDITOR_FRAME(), SIM_PLOT_FRAME::SIM_PLOT_FRAME(), windowClosing(), and WriteHotkeyConfig().

 {
     // KICAD_MANAGER_FRAME overrides this
     wxConfigBase* ret = Kiface().KifaceSettings();
     //wxASSERT( ret );
     return ret;
 }

wxString EDA_BASE_FRAME::ConfigBaseName ( )

inline

Function ConfigBaseName.

Returns: a base name prefix used in Load/Save settings to build the full name of keys used in config. This is usually the name of the frame set by CTOR, unless m_configFrameName contains a base name. this is the case of frames which can be shown in normal or modal mode. This is needed because we want only one base name prefix, regardless the mode used.

Definition at line 260 of file wxstruct.h.

References m_configFrameName.

Referenced by LoadSettings(), EDA_DRAW_FRAME::LoadSettings(), SaveSettings(), and EDA_DRAW_FRAME::SaveSettings().

     {
         wxString baseCfgName = m_configFrameName.IsEmpty() ? GetName() : m_configFrameName;
         return baseCfgName;
     }

bool EDA_BASE_FRAME::doAutoSave ( )

protectedvirtual

Function doAutoSave should be overridden by the derived class to handle the auto save feature.

Returns: true if the auto save was successful otherwise false.

Reimplemented in PCB_EDIT_FRAME, and SCH_EDIT_FRAME.

Definition at line 231 of file basicframe.cpp.

Referenced by onAutoSaveTimer().

 {
     wxCHECK_MSG( false, true, wxT( "Auto save timer function not overridden.  Bad programmer!" ) );
 }

bool EDA_BASE_FRAME::Enable ( bool enable )

override

Definition at line 192 of file basicframe.cpp.

Referenced by FOOTPRINT_EDIT_FRAME::OnUpdateLoadModuleFromBoard(), and KIWAY_PLAYER::ShowModal().

 {
     // so we can do logging of this state change:
 
 #if defined(DEBUG)
     const char* type_id = typeid( *this ).name();
     printf( "wxFrame %-28s: %s\n", type_id, enable ? "enabled" : "disabled" );
 #endif
 
     return wxFrame::Enable( enable );
 }

void EDA_BASE_FRAME::ExportHotkeyConfigToFile	(	EDA_HOTKEY_CONFIG *	aDescList,
		const wxString &	aDefaultShortname
	)

Function ExportHotkeyConfigToFile Prompt the user for an old hotkey file to read, and read it.

Parameters

aDescList	= current hotkey list descr. to initialize.
aDefaultShortname	= a default short name (extention not needed) like eechema, kicad...

Definition at line 768 of file hotkeys_basic.cpp.

References DEFAULT_HOTKEY_FILENAME_EXT, EDA_FILE_SELECTOR(), GetMruPath(), Prj(), SetMruPath(), and WriteHotkeyConfig().

Referenced by KICAD_MANAGER_FRAME::Process_Config(), LIB_EDIT_FRAME::Process_Config(), SCH_EDIT_FRAME::Process_Config(), PL_EDITOR_FRAME::Process_Config(), PCB_EDIT_FRAME::Process_Config(), GERBVIEW_FRAME::Process_Config(), and FOOTPRINT_EDIT_FRAME::ProcessPreferences().

 {
     wxString ext  = DEFAULT_HOTKEY_FILENAME_EXT;
     wxString mask = wxT( "*." ) + ext;
 
 #if 0
     wxString path = wxPathOnly( Prj().GetProjectFullName() );
 #else
     wxString path = GetMruPath();
 #endif
     wxFileName fn( aDefaultShortname );
     fn.SetExt( DEFAULT_HOTKEY_FILENAME_EXT );
 
     wxString filename = EDA_FILE_SELECTOR( _( "Write Hotkey Configuration File:" ),
                                            path,
                                            fn.GetFullPath(),
                                            ext,
                                            mask,
                                            this,
                                            wxFD_SAVE,
                                            true );
 
     if( filename.IsEmpty() )
         return;
 
     WriteHotkeyConfig( aDescList, &filename );
     SetMruPath( wxFileName( filename ).GetPath() );
 }

int EDA_BASE_FRAME::GetAutoSaveInterval ( ) const

inline

Definition at line 219 of file wxstruct.h.

References m_autoSaveInterval.

Referenced by DIALOG_GENERALOPTIONS::init(), and SCH_EDIT_FRAME::OnPreferencesOptions().

219 { return m_autoSaveInterval; }

EDA_BASE_FRAME::m_autoSaveInterval

int m_autoSaveInterval

The auto save interval time in seconds.

Definition: wxstruct.h:153

wxString EDA_BASE_FRAME::GetFileFromHistory	(	int	cmdId,
		const wxString &	type,
		wxFileHistory *	aFileHistory = `NULL`
	)

Function GetFileFromHistory fetches the file name from the file history list.

and removes the selected file, if this file does not exists Note also the menu is updated, if wxFileHistory::UseMenu was called at init time

Parameters

cmdId	The command ID associated with the aFileHistory object.
type	Please document me!
aFileHistory	The wxFileHistory in use. If null, the main application file history is used

Returns: a wxString containing the selected filename

Definition at line 400 of file basicframe.cpp.

References Format(), GetChars(), KIFACE_I::GetFileHistory(), and Kiface().

Referenced by GERBVIEW_FRAME::OnDrlFileHistory(), KICAD_MANAGER_FRAME::OnFileHistory(), PL_EDITOR_FRAME::OnFileHistory(), PCB_EDIT_FRAME::OnFileHistory(), GERBVIEW_FRAME::OnGbrFileHistory(), GERBVIEW_FRAME::OnJobFileHistory(), and GERBVIEW_FRAME::OnZipFileHistory().

 {
     wxFileHistory* fileHistory = aFileHistory;
 
     if( !fileHistory )
         fileHistory = &Kiface().GetFileHistory();
 
     int baseId = fileHistory->GetBaseId();
 
     wxASSERT( cmdId >= baseId && cmdId < baseId + (int) fileHistory->GetCount() );
 
     unsigned i = cmdId - baseId;
 
     if( i < fileHistory->GetCount() )
     {
         wxString fn = fileHistory->GetHistoryFile( i );
 
         if( wxFileName::FileExists( fn ) )
             return fn;
         else
         {
             wxString msg = wxString::Format(
                         wxT( "file '%s' was not found." ),
                         GetChars( fn ) );
 
             wxMessageBox( msg );
 
             fileHistory->RemoveFileFromHistory( i );
         }
     }
 
     return wxEmptyString;
 }

void EDA_BASE_FRAME::GetKicadAbout ( wxCommandEvent & event )

Definition at line 527 of file basicframe.cpp.

References ShowAboutDialog().

 {
     void ShowAboutDialog(EDA_BASE_FRAME * aParent); // See AboutDialog_main.cpp
     ShowAboutDialog( this );
 }

void EDA_BASE_FRAME::GetKicadContribute ( wxCommandEvent & event )

Definition at line 514 of file basicframe.cpp.

References URL_GET_INVOLVED.

 {
     if( !wxLaunchDefaultBrowser( URL_GET_INVOLVED ) )
     {
         wxString msg;
         msg.Printf( _( "Could not launch the default browser.\n"
                        "For information on how to help the KiCad project, visit %s" ),
                     URL_GET_INVOLVED );
         wxMessageBox( msg, _( "Get involved with KiCad" ), wxOK, this );
     }
 }

void EDA_BASE_FRAME::GetKicadHelp ( wxCommandEvent & event )

Definition at line 436 of file basicframe.cpp.

References DIM, Format(), GetAssociatedDocument(), GetChars(), help_name(), SearchHelpFileFullPath(), and sys_search().

 {
     const SEARCH_STACK& search = sys_search();
 
     /* We have to get document for beginners,
      * or the full specific doc
      * if event id is wxID_INDEX, we want the document for beginners.
      * else the specific doc file (its name is in Kiface().GetHelpFileName())
      * The document for beginners is the same for all KiCad utilities
      */
     if( event.GetId() == wxID_INDEX )
     {
         // List of possible names for Getting Started in KiCad
         const wxChar* names[2] = {
             wxT( "getting_started_in_kicad" ),
             wxT( "Getting_Started_in_KiCad" )
             };
 
         wxString helpFile;
         // Search for "getting_started_in_kicad.html" or "getting_started_in_kicad.pdf"
         // or "Getting_Started_in_KiCad.html" or "Getting_Started_in_KiCad.pdf"
         for( unsigned ii = 0; ii < DIM( names ); ii++ )
         {
             helpFile = SearchHelpFileFullPath( search, names[ii] );
 
             if( !helpFile.IsEmpty() )
                break;
         }
 
         if( !helpFile )
         {
             wxString msg = wxString::Format( _(
                 "Html or pdf help file \n'%s'\n or\n'%s' could not be found." ), names[0], names[1] );
             wxMessageBox( msg );
         }
         else
         {
             GetAssociatedDocument( this, helpFile );
         }
 
         return;
     }
 
     wxString base_name = help_name();
     wxString helpFile = SearchHelpFileFullPath( search, base_name );
 
     if( !helpFile )
     {
         wxString msg = wxString::Format( _(
             "Help file '%s' could not be found." ),
             GetChars( base_name )
             );
         wxMessageBox( msg );
     }
     else
     {
         GetAssociatedDocument( this, helpFile );
     }
 }

wxString EDA_BASE_FRAME::GetMruPath ( ) const

inline

Definition at line 363 of file wxstruct.h.

References m_mruPath.

Referenced by ExportHotkeyConfigToFile(), ImportHotkeyConfigFromFile(), KICAD_MANAGER_FRAME::OnLoadProject(), and KICAD_MANAGER_FRAME::OnNewProject().

363 { return m_mruPath; }

EDA_BASE_FRAME::m_mruPath

wxString m_mruPath

Most recently used path.

Definition: wxstruct.h:160

wxString EDA_BASE_FRAME::help_name ( )

protectedvirtual

Reimplemented in KICAD_MANAGER_FRAME.

Definition at line 376 of file basicframe.cpp.

References KIFACE_I::GetHelpFileName(), and Kiface().

Referenced by GetKicadHelp().

 {
     return Kiface().GetHelpFileName();
 }

void EDA_BASE_FRAME::ImportHotkeyConfigFromFile	(	EDA_HOTKEY_CONFIG *	aDescList,
		const wxString &	aDefaultShortname
	)

Function ImportHotkeyConfigFromFile Prompt the user for an old hotkey file to read, and read it.

Parameters

aDescList	= current hotkey list descr. to initialize.
aDefaultShortname	= a default short name (extention not needed) like eechema, kicad...

Definition at line 737 of file hotkeys_basic.cpp.

References DEFAULT_HOTKEY_FILENAME_EXT, EDA_FILE_SELECTOR(), GetMruPath(), Prj(), ReadHotkeyConfigFile(), and SetMruPath().

Referenced by KICAD_MANAGER_FRAME::Process_Config(), LIB_EDIT_FRAME::Process_Config(), SCH_EDIT_FRAME::Process_Config(), PL_EDITOR_FRAME::Process_Config(), PCB_EDIT_FRAME::Process_Config(), GERBVIEW_FRAME::Process_Config(), and FOOTPRINT_EDIT_FRAME::ProcessPreferences().

 {
     wxString ext  = DEFAULT_HOTKEY_FILENAME_EXT;
     wxString mask = wxT( "*." ) + ext;
 
 #if 0   // pass in the project dir as an argument
     wxString path = wxPathOnly( Prj().GetProjectFullName() );
 #else
     wxString path = GetMruPath();
 #endif
     wxFileName fn( aDefaultShortname );
     fn.SetExt( DEFAULT_HOTKEY_FILENAME_EXT );
 
     wxString  filename = EDA_FILE_SELECTOR( _( "Read Hotkey Configuration File:" ),
                                            path,
                                            fn.GetFullPath(),
                                            ext,
                                            mask,
                                            this,
                                            wxFD_OPEN,
                                            true );
 
     if( filename.IsEmpty() )
         return;
 
     ReadHotkeyConfigFile( filename, aDescList );
     SetMruPath( wxFileName( filename ).GetPath() );
 }

virtual bool EDA_BASE_FRAME::isAutoSaveRequired ( ) const

inlineprotectedvirtual

Function autoSaveRequired returns the auto save status of the application.

Override this function if your derived frame supports automatic file saving.

Reimplemented in PCB_EDIT_FRAME, and SCH_EDIT_FRAME.

Definition at line 173 of file wxstruct.h.

Referenced by ProcessEvent().

173 { return false; }

bool EDA_BASE_FRAME::IsType ( FRAME_T aType ) const

inline

Definition at line 221 of file wxstruct.h.

Referenced by BOARD_COMMIT::BOARD_COMMIT(), LIB_PIN::drawGraphic(), BOARD_PRINTOUT_CONTROLLER::DrawPage(), DIALOG_EDIT_ONE_FIELD::init(), DIALOG_PAD_PROPERTIES::initValues(), PCB_BASE_FRAME::PlaceTexteModule(), and PCB_BASE_FRAME::RotateTextModule().

221 { return m_Ident == aType; }

EDA_BASE_FRAME::m_Ident

FRAME_T m_Ident

Id Type (pcb, schematic, library..)

Definition: wxstruct.h:133

bool EDA_BASE_FRAME::IsWritable ( const wxFileName & aFileName )

Function IsWritable checks if aFileName can be written.

The function performs a number of tests on aFileName to verify that it can be saved. If aFileName defines a path with no file name, them the path is tested for user write permission. If aFileName defines a file name that does not exist in the path, the path is tested for user write permission. If aFileName defines a file that already exits, the file name is tested for user write permissions.

Note: The file name path must be set or an assertion will be raised on debug builds and return false on release builds.

Parameters

aFileName The full path and/or file name of the file to test.

Returns: False if aFileName cannot be written.

Definition at line 534 of file basicframe.cpp.

References GetChars().

Referenced by SCH_EDIT_FRAME::doAutoSave(), LIB_EDIT_FRAME::SaveActiveLibrary(), SCH_EDIT_FRAME::SaveEEFile(), PCB_EDIT_FRAME::SavePcbCopy(), PCB_EDIT_FRAME::SavePcbFile(), CVPCB_MAINFRAME::SaveProjectFile(), and SCH_EDIT_FRAME::SaveProjectSettings().

 {
     wxString msg;
     wxFileName fn = aFileName;
 
     // Check for absence of a file path with a file name.  Unfortunately KiCad
     // uses paths relative to the current project path without the ./ part which
     // confuses wxFileName. Making the file name path absolute may be less than
     // elegant but it solves the problem.
     if( fn.GetPath().IsEmpty() && fn.HasName() )
         fn.MakeAbsolute();
 
     wxCHECK_MSG( fn.IsOk(), false,
                  wxT( "File name object is invalid.  Bad programmer!" ) );
     wxCHECK_MSG( !fn.GetPath().IsEmpty(), false,
                  wxT( "File name object path <" ) + fn.GetFullPath() +
                  wxT( "> is not set.  Bad programmer!" ) );
 
     if( fn.IsDir() && !fn.IsDirWritable() )
     {
         msg.Printf( _( "You do not have write permissions to folder <%s>." ),
                     GetChars( fn.GetPath() ) );
     }
     else if( !fn.FileExists() && !fn.IsDirWritable() )
     {
         msg.Printf( _( "You do not have write permissions to save file <%s> to folder <%s>." ),
                     GetChars( fn.GetFullName() ), GetChars( fn.GetPath() ) );
     }
     else if( fn.FileExists() && !fn.IsFileWritable() )
     {
         msg.Printf( _( "You do not have write permissions to save file <%s>." ),
                     GetChars( fn.GetFullPath() ) );
     }
 
     if( !msg.IsEmpty() )
     {
         wxMessageBox( msg );
         return false;
     }
 
     return true;
 }

void EDA_BASE_FRAME::LoadSettings ( wxConfigBase * aCfg )

virtual

Function LoadSettings loads common frame parameters from a configuration file.

Don't forget to call the base method or your frames won't remember their positions and sizes.

Reimplemented in EDA_DRAW_FRAME, PCB_BASE_FRAME, GERBVIEW_FRAME, PCB_EDIT_FRAME, SCH_EDIT_FRAME, LIB_EDIT_FRAME, KICAD_MANAGER_FRAME, CVPCB_MAINFRAME, PL_EDITOR_FRAME, EDA_3D_VIEWER, FOOTPRINT_WIZARD_FRAME, SIM_PLOT_FRAME, FOOTPRINT_VIEWER_FRAME, LIB_VIEW_FRAME, and FOOTPRINT_EDIT_FRAME.

Definition at line 256 of file basicframe.cpp.

References ConfigBaseName(), DEFAULT_AUTO_SAVE_INTERVAL, entryAutoSaveInterval, entryMaximized, entryMruPath, entryPerspective, entryPosX, entryPosY, entrySizeX, entrySizeY, m_autoSaveInterval, m_FramePos, m_FrameSize, m_hasAutoSave, m_mruPath, m_perspective, wxPoint::x, and wxPoint::y.

Referenced by SIM_PLOT_FRAME::LoadSettings(), EDA_3D_VIEWER::LoadSettings(), CVPCB_MAINFRAME::LoadSettings(), KICAD_MANAGER_FRAME::LoadSettings(), and EDA_DRAW_FRAME::LoadSettings().

 {
     int maximized = 0;
 
     wxString baseCfgName = ConfigBaseName();
 
     wxString text = baseCfgName + entryPosX;
     aCfg->Read( text, &m_FramePos.x );
 
     text = baseCfgName + entryPosY;
     aCfg->Read( text, &m_FramePos.y );
 
     text = baseCfgName + entrySizeX;
     aCfg->Read( text, &m_FrameSize.x, 600 );
 
     text = baseCfgName + entrySizeY;
     aCfg->Read( text, &m_FrameSize.y, 400 );
 
     text = baseCfgName + entryMaximized;
     aCfg->Read( text, &maximized, 0 );
 
     if( m_hasAutoSave )
     {
         text = baseCfgName + entryAutoSaveInterval;
         aCfg->Read( text, &m_autoSaveInterval, DEFAULT_AUTO_SAVE_INTERVAL );
     }
 
     // Ensure the window is on a connected display, and is visible.
     // (at least a corner of the frame must be visible on screen)
     // Sometimes, if a window was moved on an auxiliary display, and when this
     // display is no more available, it is not the case.
     wxRect rect( m_FramePos, m_FrameSize );
 
     if( wxDisplay::GetFromPoint( rect.GetTopLeft() ) == wxNOT_FOUND &&
         wxDisplay::GetFromPoint( rect.GetTopRight() ) == wxNOT_FOUND &&
         wxDisplay::GetFromPoint( rect.GetBottomLeft() ) == wxNOT_FOUND &&
         wxDisplay::GetFromPoint( rect.GetBottomRight() ) == wxNOT_FOUND )
     {
         m_FramePos = wxDefaultPosition;
     }
 
     // Ensure Window title bar is visible
 #if defined( __WXMAC__ )
     // for macOSX, the window must be below system (macOSX) toolbar
     // Ypos_min = GetMBarHeight(); seems no more exist in new API (subject to change)
     int Ypos_min = 20;
 #else
     int Ypos_min = 0;
 #endif
     if( m_FramePos.y < Ypos_min )
         m_FramePos.y = Ypos_min;
 
     if( maximized )
         Maximize();
 
     aCfg->Read( baseCfgName + entryPerspective, &m_perspective );
     aCfg->Read( baseCfgName + entryMruPath, &m_mruPath );
 }

void EDA_BASE_FRAME::onAutoSaveTimer ( wxTimerEvent & aEvent )

protected

Function onAutoSaveTimer handles the auto save timer event.

Definition at line 224 of file basicframe.cpp.

References doAutoSave(), m_autoSaveInterval, and m_autoSaveTimer.

Referenced by EDA_BASE_FRAME().

 {
     if( !doAutoSave() )
         m_autoSaveTimer->Start( m_autoSaveInterval * 1000, wxTIMER_ONE_SHOT );
 }

void EDA_BASE_FRAME::OnChangeIconsOptions ( wxCommandEvent & event )

virtual

Function OnChangeIconsOptions Selects the current icons options in menus (or toolbars) in Kicad (the default for toolbars/menus is 26x26 pixels, and shows icons in menus).

Reimplemented in KIWAY_PLAYER, and KICAD_MANAGER_FRAME.

Definition at line 662 of file basicframe.cpp.

References ID_KICAD_SELECT_ICONS_IN_MENUS, Pgm(), ReCreateMenuBar(), and PGM_BASE::SetUseIconsInMenus().

Referenced by KICAD_MANAGER_FRAME::OnChangeIconsOptions(), and KIWAY_PLAYER::OnChangeIconsOptions().

 {
     if( event.GetId() == ID_KICAD_SELECT_ICONS_IN_MENUS )
     {
         Pgm().SetUseIconsInMenus( event.IsChecked() );
     }
 
     ReCreateMenuBar();
 }

void EDA_BASE_FRAME::OnSelectPreferredEditor ( wxCommandEvent & event )

virtual

Function OnSelectPreferredEditor Open a dialog to select the editor that will used in KiCad to edit or display files (reports ...

) The full filename editor is saved in configuration (global params)

Definition at line 497 of file basicframe.cpp.

References PGM_BASE::AskUserForPreferredEditor(), PGM_BASE::GetEditorName(), Pgm(), and PGM_BASE::SetEditorName().

 {
     // Ask for the current editor and instruct GetEditorName() to not show
     // unless we pass false as argument.
     wxString editorname = Pgm().GetEditorName( false );
 
     // Ask the user to select a new editor, but suggest the current one as the default.
     editorname = Pgm().AskUserForPreferredEditor( editorname );
 
     // If we have a new editor name request it to be copied to m_editor_name and saved
     // to the preferences file. If the user cancelled the dialog then the previous
     // value will be retained.
     if( !editorname.IsEmpty() )
         Pgm().SetEditorName( editorname );
 }

bool EDA_BASE_FRAME::PostCommandMenuEvent ( int evt_type )

Function PostCommandMenuEvent.

Post a menu event to the frame, which can be used to trigger actions bound to menu items.

Definition at line 647 of file basicframe.cpp.

Referenced by FOOTPRINT_EDIT_FRAME::OnHotKey(), FOOTPRINT_EDIT_FRAME::OnHotkeyDeleteItem(), FOOTPRINT_EDIT_FRAME::OnHotkeyDuplicateItem(), PCB_EDIT_FRAME::OnHotkeyDuplicateOrArrayItem(), FOOTPRINT_EDIT_FRAME::OnHotkeyEditItem(), FOOTPRINT_EDIT_FRAME::OnHotkeyMoveItem(), FOOTPRINT_EDIT_FRAME::OnHotkeyMoveItemExact(), and FOOTPRINT_EDIT_FRAME::OnHotkeyRotateItem().

 {
     if( evt_type != 0 )
     {
         wxCommandEvent evt( wxEVT_COMMAND_MENU_SELECTED );
         evt.SetEventObject( this );
         evt.SetId( evt_type );
         wxPostEvent( this, evt );
         return true;
     }
 
     return false;
 }

void EDA_BASE_FRAME::PrintMsg ( const wxString & text )

Definition at line 382 of file basicframe.cpp.

Referenced by SCH_EDIT_FRAME::LoadOneEEFile(), and EDA_DRAW_PANEL::OnMouseEvent().

 {
     SetStatusText( text );
 }

bool EDA_BASE_FRAME::ProcessEvent ( wxEvent & aEvent )

override

Function ProcessEvent overrides the default process event handler to implement the auto save feature.

Warning: If you override this function in a derived class, make sure you call down to this or the auto save feature will be disabled.

Definition at line 166 of file basicframe.cpp.

References isAutoSaveRequired(), m_autoSaveInterval, m_autoSaveState, m_autoSaveTimer, m_hasAutoSave, and traceAutoSave.

Referenced by LIB_VIEW_FRAME::onSelectNextSymbol(), LIB_VIEW_FRAME::onSelectPreviousSymbol(), KIWAY::ProcessEvent(), LIB_VIEW_FRAME::ReCreateListCmp(), and PCBNEW_CONTROL::SwitchUnits().

 {
     if( !wxFrame::ProcessEvent( aEvent ) )
         return false;
 
     if( IsShown() && m_hasAutoSave && IsActive() &&
         (m_autoSaveState != isAutoSaveRequired()) && (m_autoSaveInterval > 0) )
     {
         if( !m_autoSaveState )
         {
             wxLogTrace( traceAutoSave, wxT( "Starting auto save timer." ) );
             m_autoSaveTimer->Start( m_autoSaveInterval * 1000, wxTIMER_ONE_SHOT );
             m_autoSaveState = true;
         }
         else if( m_autoSaveTimer->IsRunning() )
         {
             wxLogTrace( traceAutoSave, wxT( "Stopping auto save timer." ) );
             m_autoSaveTimer->Stop();
             m_autoSaveState = false;
         }
     }
 
     return true;
 }

int EDA_BASE_FRAME::ReadHotkeyConfig ( struct EDA_HOTKEY_CONFIG * aDescList )

Function ReadHotkeyConfig Read configuration data and fill the current hotkey list with hotkeys.

Parameters

aDescList = current hotkey list descr. to initialize.

Definition at line 658 of file hotkeys_basic.cpp.

 {
     ::ReadHotkeyConfig( GetName(), aDescList );
     return 1;
 }

int EDA_BASE_FRAME::ReadHotkeyConfigFile	(	const wxString &	aFilename,
		struct EDA_HOTKEY_CONFIG *	aDescList
	)

Function ReadHotkeyConfigFile Read an old configuration file (&ltfile&gt.key) and fill the current hotkey list with hotkeys.

Parameters

aFilename	= file name to read.
aDescList	= current hotkey list descr. to initialize.

Definition at line 601 of file hotkeys_basic.cpp.

References DEFAULT_HOTKEY_FILENAME_EXT, and ParseHotkeyConfig().

Referenced by ImportHotkeyConfigFromFile().

 {
     wxFileName fn( aFilename );
     fn.SetExt( DEFAULT_HOTKEY_FILENAME_EXT );
 
     wxFile cfgfile( fn.GetFullPath() );
 
     if( !cfgfile.IsOpened() )       // There is a problem to open file
         return 0;
 
     // get length
     cfgfile.SeekEnd();
     wxFileOffset size = cfgfile.Tell();
     cfgfile.Seek( 0 );
 
     // read data
     char*    buffer = new char[size];
     cfgfile.Read( buffer, size );
 
     wxString data( buffer, wxConvUTF8 );
 
     // parse
     ParseHotkeyConfig( data, aDescList );
 
     // cleanup
     delete[] buffer;
     cfgfile.Close();
     return 1;
 }

void EDA_BASE_FRAME::ReCreateMenuBar ( void )

virtual

Function ReCreateMenuBar Creates recreates the menu bar.

Needed when the language is changed

Reimplemented in PCB_EDIT_FRAME, EDA_DRAW_FRAME, SCH_EDIT_FRAME, GERBVIEW_FRAME, PCB_BASE_FRAME, KICAD_MANAGER_FRAME, LIB_EDIT_FRAME, PL_EDITOR_FRAME, FOOTPRINT_EDIT_FRAME, CVPCB_MAINFRAME, FOOTPRINT_VIEWER_FRAME, and LIB_VIEW_FRAME.

Definition at line 237 of file basicframe.cpp.

Referenced by InstallHotkeyFrame(), OnChangeIconsOptions(), ShowChangedIcons(), and ShowChangedLanguage().

238 {

239 }

virtual void EDA_BASE_FRAME::SaveProjectSettings ( bool aAskForSave )

inlinevirtual

Function SaveProjectSettings saves changes to the project settings to the project (.pro) file.

The method is virtual so you can override it to call the suitable save method. The base method do nothing

Parameters

aAskForSave = true to open a dialog before saving the settings

Reimplemented in PCB_EDIT_FRAME, and SCH_EDIT_FRAME.

Definition at line 274 of file wxstruct.h.

Referenced by DIALOG_PAGES_SETTINGS::OnOkClick().

274 {};

void EDA_BASE_FRAME::SaveSettings ( wxConfigBase * aCfg )

virtual

Function SaveSettings saves common frame parameters to a configuration data file.

Don't forget to call the base class's SaveSettings() from your derived SaveSettings() otherwise the frames won't remember their positions and sizes.

Reimplemented in EDA_DRAW_FRAME, PCB_BASE_FRAME, GERBVIEW_FRAME, PCB_EDIT_FRAME, SCH_EDIT_FRAME, LIB_EDIT_FRAME, KICAD_MANAGER_FRAME, CVPCB_MAINFRAME, PL_EDITOR_FRAME, EDA_3D_VIEWER, FOOTPRINT_WIZARD_FRAME, SIM_PLOT_FRAME, FOOTPRINT_VIEWER_FRAME, LIB_VIEW_FRAME, and FOOTPRINT_EDIT_FRAME.

Definition at line 316 of file basicframe.cpp.

References ConfigBaseName(), entryAutoSaveInterval, entryMruPath, entryPerspective, m_auimgr, m_autoSaveInterval, m_FramePos, m_FrameSize, m_hasAutoSave, m_mruPath, wxPoint::x, and wxPoint::y.

Referenced by SIM_PLOT_FRAME::SaveSettings(), EDA_3D_VIEWER::SaveSettings(), CVPCB_MAINFRAME::SaveSettings(), KICAD_MANAGER_FRAME::SaveSettings(), EDA_DRAW_FRAME::SaveSettings(), and windowClosing().

 {
     wxString        text;
 
     if( IsIconized() )
         return;
 
     wxString baseCfgName = ConfigBaseName();
 
     m_FrameSize = GetSize();
     m_FramePos  = GetPosition();
 
     text = baseCfgName + wxT( "Pos_x" );
     aCfg->Write( text, (long) m_FramePos.x );
 
     text = baseCfgName + wxT( "Pos_y" );
     aCfg->Write( text, (long) m_FramePos.y );
 
     text = baseCfgName + wxT( "Size_x" );
     aCfg->Write( text, (long) m_FrameSize.x );
 
     text = baseCfgName + wxT( "Size_y" );
     aCfg->Write( text, (long) m_FrameSize.y );
 
     text = baseCfgName + wxT( "Maximized" );
     aCfg->Write( text, IsMaximized() );
 
     if( m_hasAutoSave )
     {
         text = baseCfgName + entryAutoSaveInterval;
         aCfg->Write( text, m_autoSaveInterval );
     }
 
     // Once this is fully implemented, wxAuiManager will be used to maintain
     // the persistance of the main frame and all it's managed windows and
     // all of the legacy frame persistence position code can be removed.
     wxString perspective = m_auimgr.SavePerspective();
 
     // printf( "perspective(%s): %s\n",
     //    TO_UTF8( m_FrameName + entryPerspective ), TO_UTF8( perspective ) );
     aCfg->Write( baseCfgName + entryPerspective, perspective );
     aCfg->Write( baseCfgName + entryMruPath, m_mruPath );
 }

void EDA_BASE_FRAME::SetAutoSaveInterval ( int aInterval )

Definition at line 205 of file basicframe.cpp.

References m_autoSaveInterval, m_autoSaveState, and m_autoSaveTimer.

Referenced by DIALOG_GENERALOPTIONS::OnOkClick(), and SCH_EDIT_FRAME::OnPreferencesOptions().

 {
     m_autoSaveInterval = aInterval;
 
     if( m_autoSaveTimer->IsRunning() )
     {
         if( m_autoSaveInterval > 0 )
         {
             m_autoSaveTimer->Start( m_autoSaveInterval * 1000, wxTIMER_ONE_SHOT );
         }
         else
         {
             m_autoSaveTimer->Stop();
             m_autoSaveState = false;
         }
     }
 }

void EDA_BASE_FRAME::SetMruPath ( const wxString & aPath )

inline

Definition at line 361 of file wxstruct.h.

Referenced by ExportHotkeyConfigToFile(), ImportHotkeyConfigFromFile(), and KICAD_MANAGER_FRAME::LoadProject().

361 { m_mruPath = aPath; }

EDA_BASE_FRAME::m_mruPath

wxString m_mruPath

Most recently used path.

Definition: wxstruct.h:160

void EDA_BASE_FRAME::ShowChangedIcons ( )

virtual

Function ShowChangedIcons redraws items menus after a icon was changed option.

Definition at line 249 of file basicframe.cpp.

References ReCreateMenuBar().

Referenced by KIWAY::ShowChangedIcons().

 {
     ReCreateMenuBar();
     GetMenuBar()->Refresh();
 }

void EDA_BASE_FRAME::ShowChangedLanguage ( )

virtual

Function ShowChangedLanguage redraws the menus and what not in current language.

Reimplemented in PCB_EDIT_FRAME, and GERBVIEW_FRAME.

Definition at line 242 of file basicframe.cpp.

References ReCreateMenuBar().

Referenced by KIWAY::SetLanguage(), GERBVIEW_FRAME::ShowChangedLanguage(), and PCB_EDIT_FRAME::ShowChangedLanguage().

 {
     ReCreateMenuBar();
     GetMenuBar()->Refresh();
 }

const SEARCH_STACK & EDA_BASE_FRAME::sys_search ( )

protectedvirtual

Function sys_search returns a SEARCH_STACK pertaining to entire program, and is overloaded in KICAD_MANAGER_FRAME.

Reimplemented in KICAD_MANAGER_FRAME.

Definition at line 370 of file basicframe.cpp.

References Kiface(), and KIFACE_I::KifaceSearch().

Referenced by GetKicadHelp().

 {
     return Kiface().KifaceSearch();
 }

void EDA_BASE_FRAME::UpdateFileHistory	(	const wxString &	FullFileName,
		wxFileHistory *	aFileHistory = `NULL`
	)

Function UpdateFileHistory Updates the list of recently opened files.

Note also the menu is updated, if wxFileHistory::UseMenu was called at init time

Parameters

FullFileName	The full file name including the path.
aFileHistory	The wxFileHistory in use. If NULL, the main application file history is used.

Definition at line 388 of file basicframe.cpp.

References KIFACE_I::GetFileHistory(), and Kiface().

Referenced by GERBVIEW_FRAME::LoadExcellonFiles(), GERBVIEW_FRAME::LoadGerberFiles(), GERBVIEW_FRAME::LoadGerberJobFile(), PL_EDITOR_FRAME::LoadPageLayoutDescrFile(), KICAD_MANAGER_FRAME::LoadProject(), KICAD_MANAGER_FRAME::OnCloseWindow(), SCH_EDIT_FRAME::OpenProjectFiles(), PCB_EDIT_FRAME::OpenProjectFiles(), PCB_EDIT_FRAME::SavePcbFile(), and GERBVIEW_FRAME::unarchiveFiles().

 {
     wxFileHistory* fileHistory = aFileHistory;
 
     if( !fileHistory )
         fileHistory = &Kiface().GetFileHistory();
 
     fileHistory->AddFileToHistory( FullFileName );
 }

void EDA_BASE_FRAME::windowClosing ( wxCloseEvent & event )

private

Function windowClosing (with its unexpected name so it does not collide with the real OnWindowClose() function provided in derived classes) is called just before a window closing, and is used to call a derivation specific SaveSettings().

SaveSettings() is called for all derived wxFrames in this base class overload. (Calling it from a destructor is deprecated since the wxFrame's position is not available in the destructor on linux.) In other words, you should not need to call SaveSettings() anywhere, except in this one function found only in this class.

Definition at line 112 of file basicframe.cpp.

References config(), DIALOG_SHIM::IsQuasiModal(), and SaveSettings().

Referenced by EDA_BASE_FRAME().

 {
     DIALOG_SHIM* dlg  = NULL;
     wxWindowList list = GetChildren();
 
     // Quasi modal dialogs create issues (crashes) when closing Kicad.
     // I am guessing they are delete too late, when deleting main frames.
     // AFAIK, only these DIALOG_SHIM dialogs create such issues.
     // The policy is do not allow closing Kicad if a Quasi modal dialog is open.
     // (Anyway, closing without prompting the user is certainly bad,
     // because an edit is in preogress)
     // Therefore, iterate through the child list to find at least
     // a DIALOG_SHIM opened in quasi modal mode
     for( wxWindowList::iterator iter = list.begin(); iter != list.end(); ++iter )
     {
         if( (dlg = dynamic_cast<DIALOG_SHIM*> (*iter) ) != NULL )
         {
             if( dlg->IsQuasiModal() )
                 break;
             else
                 dlg = NULL;
         }
     }
 
     if( dlg )
     {
         // Happens when a quasi modal dialog is currently open.
         // For example: if the Kicad manager try to close Kicad.
         wxMessageBox( _(
                 "The program cannot be closed\n"
                 "A quasi-modal dialog window is currently open, please close it first." ) );
         event.Veto();
         return;
     }
 
     wxConfigBase* cfg = config();
 
     if( cfg )
         SaveSettings( cfg );       // virtual, wxFrame specific
 
     event.Skip();       // we did not "handle" the event, only eavesdropped on it.
 }

int EDA_BASE_FRAME::WriteHotkeyConfig	(	struct EDA_HOTKEY_CONFIG *	aDescList,
		wxString *	aFullFileName = `NULL`
	)

virtual

Function WriteHotkeyConfig Store the current hotkey list It is stored using the standard wxConfig mechanism or a file.

Parameters

aDescList	= pointer to the current hotkey list.
aFullFileName	= a wxString pointer to a full file name. if NULL, use the standard wxConfig mechanism (default) the output format is: shortcut "key" "function" lines starting with # are comments

Reimplemented in EDA_DRAW_FRAME.

Definition at line 534 of file hotkeys_basic.cpp.

References AddDelimiterString(), config(), DEFAULT_HOTKEY_FILENAME_EXT, GetChars(), GetNewConfig(), HOTKEYS_CONFIG_KEY, KeyNameFromKeyCode(), EDA_HOTKEY_CONFIG::m_HK_InfoList, EDA_HOTKEY::m_InfoMsg, EDA_HOTKEY::m_KeyCode, EDA_HOTKEY_CONFIG::m_SectionTag, EDA_HOTKEY_CONFIG::m_Title, and TO_UTF8.

Referenced by ExportHotkeyConfigToFile(), HOTKEYS_EDITOR_DIALOG::TransferDataFromWindow(), and EDA_DRAW_FRAME::WriteHotkeyConfig().

 {
     wxString msg;
     wxString keyname, infokey;
 
     msg = wxT( "$hotkey list\n" );
 
     // Print the current hotkey list
     EDA_HOTKEY** list;
 
     for( ; aDescList->m_HK_InfoList != NULL; aDescList++ )
     {
         if( aDescList->m_Title )
         {
             msg += wxT( "# " );
             msg += *aDescList->m_Title;
             msg += wxT( "\n" );
         }
 
         msg += *aDescList->m_SectionTag;
         msg += wxT( "\n" );
 
         list = aDescList->m_HK_InfoList;
 
         for( ; *list != NULL; list++ )
         {
             EDA_HOTKEY* hk_decr = *list;
             msg    += wxT( "shortcut   " );
             keyname = KeyNameFromKeyCode( hk_decr->m_KeyCode );
             AddDelimiterString( keyname );
             infokey = hk_decr->m_InfoMsg;
             AddDelimiterString( infokey );
             msg += keyname + wxT( ":    " ) + infokey + wxT( "\n" );
         }
     }
 
     msg += wxT( "$Endlist\n" );
 
     if( aFullFileName )
     {
         FILE* file = wxFopen( *aFullFileName, wxT( "wt" ) );
 
         if( file )
         {
             fputs( TO_UTF8( msg ), file );
             fclose( file );
         }
         else
         {
             msg.Printf( wxT( "Unable to write file %s" ), GetChars( *aFullFileName ) );
             return 0;
         }
     }
     else
     {
         wxFileName fn( GetName() );
         fn.SetExt( DEFAULT_HOTKEY_FILENAME_EXT );
         wxConfigBase* config = GetNewConfig( fn.GetFullPath() );
         config->Write( HOTKEYS_CONFIG_KEY, msg );
         delete config;
     }
 
     return 1;
 }

Member Data Documentation

wxString EDA_BASE_FRAME::m_AboutTitle

protected

Name of program displayed in About.

Definition at line 142 of file wxstruct.h.

wxAuiManager EDA_BASE_FRAME::m_auimgr

protected

Definition at line 144 of file wxstruct.h.

Referenced by CVPCB_MAINFRAME::CVPCB_MAINFRAME(), GERBVIEW_FRAME::GERBVIEW_FRAME(), KICAD_MANAGER_FRAME::KICAD_MANAGER_FRAME(), LIB_EDIT_FRAME::LIB_EDIT_FRAME(), GERBVIEW_FRAME::OnSelectOptionToolbar(), PCB_EDIT_FRAME::OnSelectOptionToolbar(), LIB_VIEW_FRAME::OnSize(), FOOTPRINT_VIEWER_FRAME::OnSize(), FOOTPRINT_WIZARD_FRAME::OnSize(), KICAD_MANAGER_FRAME::OnSize(), PCB_EDIT_FRAME::OnUpdateShowLayerManager(), PCB_EDIT_FRAME::OnUpdateShowMicrowaveToolbar(), PL_EDITOR_FRAME::PL_EDITOR_FRAME(), PCB_EDIT_FRAME::Process_Config(), GERBVIEW_FRAME::ReCreateAuxiliaryToolbar(), PCB_EDIT_FRAME::ReCreateAuxiliaryToolbar(), PCB_EDIT_FRAME::ReCreateLayerBox(), GERBVIEW_FRAME::ReFillLayerWidget(), CVPCB_MAINFRAME::refreshAfterComponentSearch(), SaveSettings(), GERBVIEW_FRAME::ShowChangedLanguage(), GERBVIEW_FRAME::updateDCodeSelectBox(), GERBVIEW_FRAME::UpdateTitleAndInfo(), EDA_DRAW_FRAME::UseGalCanvas(), CVPCB_MAINFRAME::~CVPCB_MAINFRAME(), EDA_3D_VIEWER::~EDA_3D_VIEWER(), EDA_DRAW_FRAME::~EDA_DRAW_FRAME(), and KICAD_MANAGER_FRAME::~KICAD_MANAGER_FRAME().

int EDA_BASE_FRAME::m_autoSaveInterval

protected

The auto save interval time in seconds.

Definition at line 153 of file wxstruct.h.

Referenced by EDA_BASE_FRAME(), GetAutoSaveInterval(), LoadSettings(), onAutoSaveTimer(), ProcessEvent(), SaveSettings(), and SetAutoSaveInterval().

bool EDA_BASE_FRAME::m_autoSaveState

protected

Flag to indicate the last auto save state.

Definition at line 150 of file wxstruct.h.

Referenced by SCH_EDIT_FRAME::doAutoSave(), PCB_EDIT_FRAME::doAutoSave(), EDA_BASE_FRAME(), ProcessEvent(), and SetAutoSaveInterval().

wxTimer* EDA_BASE_FRAME::m_autoSaveTimer

protected

The timer used to implement the auto save feature;.

Definition at line 156 of file wxstruct.h.

Referenced by EDA_BASE_FRAME(), onAutoSaveTimer(), ProcessEvent(), SetAutoSaveInterval(), and ~EDA_BASE_FRAME().

wxString EDA_BASE_FRAME::m_configFrameName

protected

prefix used in config to identify some params (frame size...) if empty, the frame name defined in CTOR is used

Definition at line 137 of file wxstruct.h.

Referenced by ConfigBaseName().

wxPoint EDA_BASE_FRAME::m_FramePos

protected

Definition at line 134 of file wxstruct.h.

Referenced by CVPCB_MAINFRAME::CVPCB_MAINFRAME(), EDA_BASE_FRAME(), GERBVIEW_FRAME::GERBVIEW_FRAME(), KICAD_MANAGER_FRAME::KICAD_MANAGER_FRAME(), LIB_EDIT_FRAME::LIB_EDIT_FRAME(), SIM_PLOT_FRAME::LoadSettings(), LoadSettings(), KICAD_MANAGER_FRAME::OnCloseWindow(), PL_EDITOR_FRAME::PL_EDITOR_FRAME(), and SaveSettings().

wxSize EDA_BASE_FRAME::m_FrameSize

protected

Definition at line 135 of file wxstruct.h.

Referenced by CVPCB_MAINFRAME::CVPCB_MAINFRAME(), EDA_BASE_FRAME(), GERBVIEW_FRAME::GERBVIEW_FRAME(), KICAD_MANAGER_FRAME::KICAD_MANAGER_FRAME(), LIB_EDIT_FRAME::LIB_EDIT_FRAME(), LIB_VIEW_FRAME::LoadSettings(), SIM_PLOT_FRAME::LoadSettings(), FOOTPRINT_WIZARD_FRAME::LoadSettings(), LoadSettings(), KICAD_MANAGER_FRAME::OnCloseWindow(), EDA_DRAW_FRAME::OnSize(), PL_EDITOR_FRAME::PL_EDITOR_FRAME(), and SaveSettings().

bool EDA_BASE_FRAME::m_hasAutoSave

protected

Flag to indicate if this frame supports auto save.

Definition at line 147 of file wxstruct.h.

Referenced by EDA_BASE_FRAME(), LoadSettings(), ProcessEvent(), and SaveSettings().

FRAME_T EDA_BASE_FRAME::m_Ident

protected

Id Type (pcb, schematic, library..)

Definition at line 133 of file wxstruct.h.

Referenced by EDA_BASE_FRAME().

wxAuiToolBar* EDA_BASE_FRAME::m_mainToolBar

protected

Standard horizontal Toolbar.

Definition at line 140 of file wxstruct.h.

wxString EDA_BASE_FRAME::m_mruPath

protected

Most recently used path.

Definition at line 160 of file wxstruct.h.

Referenced by EDA_BASE_FRAME(), FOOTPRINT_EDIT_FRAME::Export_Module(), GERBVIEW_FRAME::ExportDataInPcbnewFormat(), GetMruPath(), FOOTPRINT_EDIT_FRAME::Import_Module(), GERBVIEW_FRAME::LoadExcellonFiles(), GERBVIEW_FRAME::LoadGerberFiles(), GERBVIEW_FRAME::LoadGerberJobFile(), LoadSettings(), GERBVIEW_FRAME::LoadZipArchiveFile(), LIB_EDIT_FRAME::OnExportPart(), LIB_EDIT_FRAME::OnImportPart(), GERBVIEW_FRAME::OpenProjectFiles(), and SaveSettings().

wxString EDA_BASE_FRAME::m_perspective

protected

wxAuiManager perspective.

Definition at line 158 of file wxstruct.h.

Referenced by LoadSettings().

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

Public Member Functions

Protected Member Functions

Protected Attributes

Private Member Functions

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation