/* * This program source code file is part of KICAD, a free EDA CAD application. * * Copyright The KiCad Developers, see AUTHORS.txt for contributors. * * This program is free software; you can redistribute it and/or * modify it under the terms of the GNU General Public License * as published by the Free Software Foundation; either version 2 * of the License, or (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program; if not, you may find one here: * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html * or you may search the http://www.gnu.org website for the version 2 license, * or you may write to the Free Software Foundation, Inc., * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA */ #include #include #include #include #include #include #include #include #include #include enum TEXT_VAR_GRID_COLUMNS { TV_NAME_COL = 0, TV_VALUE_COL }; PANEL_TEXT_VARIABLES::PANEL_TEXT_VARIABLES( wxWindow* aParent, PROJECT* aProject ) : PANEL_TEXT_VARIABLES_BASE( aParent ), m_project( aProject ), m_lastCheckedTicker( 0 ), m_errorRow( -1 ), m_errorCol( -1 ) { m_btnAddTextVar->SetBitmap( KiBitmapBundle( BITMAPS::small_plus ) ); m_btnDeleteTextVar->SetBitmap( KiBitmapBundle( BITMAPS::small_trash ) ); m_TextVars->ClearRows(); m_TextVars->SetUseNativeColLabels(); // prohibit these characters in the alias names: []{}()%~<>"='`;:.,&?/\|$ m_nameValidator.SetStyle( wxFILTER_EXCLUDE_CHAR_LIST ); m_nameValidator.SetCharExcludes( wxT( "{}[]()%~<>\"='`;:.,&?/\\|$" ) ); m_TextVars->PushEventHandler( new GRID_TRICKS( m_TextVars, [this]( wxCommandEvent& aEvent ) { OnAddTextVar( aEvent ); } ) ); m_TextVars->SetSelectionMode( wxGrid::wxGridSelectionModes::wxGridSelectRows ); // wxFormBuilder doesn't include this event... m_TextVars->Connect( wxEVT_GRID_CELL_CHANGING, wxGridEventHandler( PANEL_TEXT_VARIABLES::OnGridCellChanging ), nullptr, this ); Bind( wxEVT_IDLE, [this]( wxIdleEvent& aEvent ) { // Careful of consuming CPU in an idle event handler. Check the ticker first to // see if there's even a possibility of the text variables having changed. if( m_project->GetTextVarsTicker() > m_lastCheckedTicker ) { wxWindow* dialog = wxGetTopLevelParent( this ); wxWindow* topLevelFocus = wxGetTopLevelParent( wxWindow::FindFocus() ); if( topLevelFocus == dialog && m_lastLoaded != m_project->GetTextVars() ) checkReload(); } } ); m_autoSizer = std::make_unique( *m_TextVars, WX_GRID_AUTOSIZER::COL_MIN_WIDTHS{ { TV_NAME_COL, 72 }, { TV_VALUE_COL, 120 }, }, TV_VALUE_COL ); } PANEL_TEXT_VARIABLES::~PANEL_TEXT_VARIABLES() { // Delete the GRID_TRICKS. m_TextVars->PopEventHandler( true ); m_TextVars->Disconnect( wxEVT_GRID_CELL_CHANGING, wxGridEventHandler( PANEL_TEXT_VARIABLES::OnGridCellChanging ), nullptr, this ); } void PANEL_TEXT_VARIABLES::checkReload() { // MUST update the ticker before calling IsOK (or we'll end up re-entering through the idle // event until we crash the stack). m_lastCheckedTicker = m_project->GetTextVarsTicker(); if( IsOK( m_parent, _( "The text variables have been changed outside the Setup dialog.\n" "Do you wish to reload them?" ) ) ) { m_TextVars->ClearRows(); m_lastLoaded = m_project->GetTextVars(); for( const auto& var : m_lastLoaded ) AppendTextVar( var.first, var.second ); } } bool PANEL_TEXT_VARIABLES::TransferDataToWindow() { m_lastLoaded = m_project->GetTextVars(); m_lastCheckedTicker = m_project->GetTextVarsTicker(); for( const auto& var : m_lastLoaded ) AppendTextVar( var.first, var.second ); return true; } void PANEL_TEXT_VARIABLES::AppendTextVar( const wxString& aName, const wxString& aValue ) { int i = m_TextVars->GetNumberRows(); m_TextVars->AppendRows( 1 ); m_TextVars->SetCellValue( i, TV_NAME_COL, aName ); wxGridCellAttr* nameCellAttr = m_TextVars->GetOrCreateCellAttr( i, TV_NAME_COL ); wxGridCellTextEditor* nameTextEditor = new GRID_CELL_TEXT_EDITOR(); nameTextEditor->SetValidator( m_nameValidator ); nameCellAttr->SetEditor( nameTextEditor ); nameCellAttr->DecRef(); m_TextVars->SetCellValue( i, TV_VALUE_COL, aValue ); } bool PANEL_TEXT_VARIABLES::TransferDataFromWindow() { if( !m_TextVars->CommitPendingChanges() ) return false; for( int row = 0; row < m_TextVars->GetNumberRows(); ++row ) { if( m_TextVars->GetCellValue( row, TV_NAME_COL ).IsEmpty() ) { m_errorRow = row; m_errorCol = TV_NAME_COL; m_errorMsg = _( "Variable name cannot be empty." ); return false; } } std::map& variables = m_project->GetTextVars(); variables.clear(); for( int row = 0; row < m_TextVars->GetNumberRows(); ++row ) { wxString name = m_TextVars->GetCellValue( row, TV_NAME_COL ); wxString value = m_TextVars->GetCellValue( row, TV_VALUE_COL ); variables[ name ] = value; } return true; } void PANEL_TEXT_VARIABLES::OnGridCellChanging( wxGridEvent& event ) { int row = event.GetRow(); int col = event.GetCol(); wxString text = event.GetString(); if( text.IsEmpty() && col == TV_NAME_COL ) { m_errorMsg = _( "Variable name cannot be empty." ); m_errorRow = row; m_errorCol = col; event.Veto(); } } void PANEL_TEXT_VARIABLES::OnAddTextVar( wxCommandEvent& event ) { m_TextVars->OnAddRow( [&]() -> std::pair { AppendTextVar( wxEmptyString, wxEmptyString ); return { m_TextVars->GetNumberRows() - 1, TV_NAME_COL }; } ); } void PANEL_TEXT_VARIABLES::OnRemoveTextVar( wxCommandEvent& event ) { m_TextVars->OnDeleteRows( [&]( int row ) { m_TextVars->DeleteRows( row, 1 ); } ); } void PANEL_TEXT_VARIABLES::OnUpdateUI( wxUpdateUIEvent& event ) { // Handle a grid error. This is delayed to OnUpdateUI so that we can change focus // even when the original validation was triggered from a killFocus event (and for // dialog with notebooks, so that the corresponding notebook page can be shown in // the background when triggered from an OK). if( !m_errorMsg.IsEmpty() ) { // We will re-enter this routine when the error dialog is displayed, so make // sure we don't keep putting up more dialogs. wxString errorMsg = m_errorMsg; m_errorMsg = wxEmptyString; wxWindow* topLevelParent = wxGetTopLevelParent( this ); DisplayErrorMessage( topLevelParent, errorMsg ); m_TextVars->SetFocus(); m_TextVars->MakeCellVisible( m_errorRow, m_errorCol ); m_TextVars->SetGridCursor( m_errorRow, m_errorCol ); m_TextVars->EnableCellEditControl( true ); m_TextVars->ShowCellEditControl(); } } void PANEL_TEXT_VARIABLES::ImportSettingsFrom( const PROJECT* aOtherProject ) { // Fetch from other project... m_lastLoaded = aOtherProject->GetTextVars(); // ... but use ticker from current project: m_lastCheckedTicker = m_project->GetTextVarsTicker(); m_TextVars->ClearRows(); for( const auto& var : m_lastLoaded ) AppendTextVar( var.first, var.second ); }