/* * This program source code file is part of KICAD, a free EDA CAD application. * * Copyright (C) 1992-2023 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 #include #include #include #include #include /** * Helper function to add a filter box to a panel, with some * sensible defaults for that purpose. * * @param aParent The parent widget/panel * @param aDescriptiveText The text to show when the box is empty. * @return A newly constructed filter box - the caller owns it */ static wxSearchCtrl* CreateTextFilterBox( wxWindow* aParent, const wxString& aDescriptiveText ) { wxSearchCtrl* search_widget = new wxSearchCtrl( aParent, wxID_ANY ); search_widget->ShowSearchButton( false ); search_widget->ShowCancelButton( true ); search_widget->SetDescriptiveText( aDescriptiveText ); #ifdef __WXGTK__ // wxSearchCtrl vertical height is not calculated correctly on some GTK setups // See https://gitlab.com/kicad/code/kicad/-/issues/9019 search_widget->SetMinSize( wxSize( -1, aParent->GetTextExtent( wxT( "qb" ) ).y + 10 ) ); #endif return search_widget; } PANEL_HOTKEYS_EDITOR::PANEL_HOTKEYS_EDITOR( EDA_BASE_FRAME* aFrame, wxWindow* aWindow, bool aReadOnly ) : RESETTABLE_PANEL( aWindow, wxID_ANY, wxDefaultPosition, wxDefaultSize ), m_frame( aFrame ), m_readOnly( aReadOnly ), m_hotkeyStore() { wxBoxSizer* mainSizer = new wxBoxSizer( wxVERTICAL ); wxBoxSizer* bMargins = new wxBoxSizer( wxVERTICAL ); m_filterSearch = CreateTextFilterBox( this, _( "Type filter text" ) ); bMargins->Add( m_filterSearch, 0, wxEXPAND, 0 ); m_hotkeyListCtrl = new WIDGET_HOTKEY_LIST( this, m_hotkeyStore, m_readOnly ); bMargins->Add( m_hotkeyListCtrl, 1, wxEXPAND | wxTOP, 5 ); if( !m_readOnly ) installButtons( bMargins ); mainSizer->Add( bMargins, 1, wxEXPAND, 0 ); #ifdef __WXGTK__ // It appears that this may have been fixed in wxWidgets 3.2.3. #if wxVERSION_NUMBER < 3203 // Work around a bug that clips the text vertically in the wxSearchCtrl on GTK m_filterSearch->SetMinSize( wxSize( m_filterSearch->GetSize().x, int( m_filterSearch->GetSize().y * 1.6 ) ) ); #endif #endif SetSizer( mainSizer ); Layout(); mainSizer->Fit( this ); // Connect Events m_filterSearch->Bind( wxEVT_COMMAND_TEXT_UPDATED, &PANEL_HOTKEYS_EDITOR::OnFilterSearch, this ); } PANEL_HOTKEYS_EDITOR::~PANEL_HOTKEYS_EDITOR() { m_filterSearch->Unbind( wxEVT_COMMAND_TEXT_UPDATED, &PANEL_HOTKEYS_EDITOR::OnFilterSearch, this ); } void PANEL_HOTKEYS_EDITOR::ResetPanel() { m_hotkeyListCtrl->ResetAllHotkeys( true ); } void PANEL_HOTKEYS_EDITOR::installButtons( wxSizer* aSizer ) { BUTTON_ROW_PANEL::BTN_DEF_LIST l_btn_defs = { { wxID_RESET, _( "Undo All Changes" ), _( "Undo all changes made so far in this dialog" ), [this]( wxCommandEvent& ) { m_hotkeyListCtrl->ResetAllHotkeys( false ); } }, { wxID_ANY, _( "Import Hotkeys..." ), _( "Import hotkey definitions from an external file, replacing the current values" ), [this]( wxCommandEvent& ) { ImportHotKeys(); } } }; if( ADVANCED_CFG::GetCfg().m_HotkeysDumper ) { // Add hotkeys dumper (does not need translation, it's a dev tool only) l_btn_defs.push_back( { wxID_ANY, wxT( "Dump Hotkeys" ), wxEmptyString, [this]( wxCommandEvent& ) { dumpHotkeys(); } } ); } const BUTTON_ROW_PANEL::BTN_DEF_LIST r_btn_defs = { }; auto btnPanel = std::make_unique( this, l_btn_defs, r_btn_defs ); aSizer->Add( btnPanel.release(), 0, wxEXPAND | wxALL, KIUI::GetStdMargin() * 2 ); } bool PANEL_HOTKEYS_EDITOR::TransferDataToWindow() { m_hotkeyStore.Init( m_actions, m_readOnly ); if( !m_hotkeyListCtrl->TransferDataToControl() ) return false; return true; } bool PANEL_HOTKEYS_EDITOR::TransferDataFromWindow() { if( m_readOnly ) return true; if( !m_hotkeyListCtrl->TransferDataFromControl() ) return false; WriteHotKeyConfig( m_actions ); return true; } void PANEL_HOTKEYS_EDITOR::OnFilterSearch( wxCommandEvent& aEvent ) { const auto searchStr = aEvent.GetString(); m_hotkeyListCtrl->ApplyFilterString( searchStr ); } void PANEL_HOTKEYS_EDITOR::ImportHotKeys() { wxString filename = wxFileSelector( _( "Import Hotkeys File:" ), m_frame->GetMruPath(), wxEmptyString, FILEEXT::HotkeyFileExtension, FILEEXT::HotkeyFileWildcard(), wxFD_OPEN, this ); if( filename.IsEmpty() ) return; std::map> importedHotKeys; ReadHotKeyConfig( filename, importedHotKeys ); m_frame->SetMruPath( wxFileName( filename ).GetPath() ); // Overlay the imported hotkeys onto the hotkey store for( HOTKEY_SECTION& section: m_hotkeyStore.GetSections() ) { for( HOTKEY& hotkey: section.m_HotKeys ) { if( importedHotKeys.count( hotkey.m_Actions[ 0 ]->GetName() ) ) { hotkey.m_EditKeycode = importedHotKeys[ hotkey.m_Actions[ 0 ]->GetName() ].first; hotkey.m_EditKeycodeAlt = importedHotKeys[ hotkey.m_Actions[ 0 ]->GetName() ].second; } } } m_hotkeyListCtrl->TransferDataToControl(); } void PANEL_HOTKEYS_EDITOR::dumpHotkeys() { wxString filename = wxFileSelector( wxT( "Hotkeys File" ), m_frame->GetMruPath(), wxEmptyString, FILEEXT::TextFileExtension, FILEEXT::TextFileWildcard(), wxFD_SAVE, this ); if( filename.IsEmpty() ) return; wxFileName fn( filename ); wxFFileOutputStream fileStream( fn.GetFullPath(), "w" ); wxTextOutputStream stream( fileStream ); if( !fn.IsDirWritable() || ( fn.Exists() && !fn.IsFileWritable() ) ) return; for( HOTKEY_SECTION& section : m_hotkeyStore.GetSections() ) { stream << wxT( "=== " ) << section.m_SectionName << endl << endl; stream << wxT( "[width=\"100%\",options=\"header\",cols=\"20%,15%,65%\"]" ) << endl; stream << wxT( "|===" ) << endl; stream << _( "| Action | Default Hotkey | Description" ) << endl; for( HOTKEY& hk : section.m_HotKeys ) { stream << wxT( "| " ) << hk.m_Actions[0]->GetFriendlyName() << endl; if( hk.m_EditKeycode > 0 ) { stream << wxT( " | kbd:[" ) << KeyNameFromKeyCode( hk.m_EditKeycode ) << ']' << endl; } else { stream << wxT( " |" ) << endl; } stream << wxT( " | " ) << hk.m_Actions[0]->GetDescription() << endl; } stream << wxT( "|===" ) << endl << endl; } stream.Flush(); fileStream.Close(); }