dialog_find.cpp

Go to the documentation of this file.

/*
 * This program source code file is part of KICAD, a free EDA CAD application.
 *
 * Copyright (C) 2012 Marco Mattila <[email protected]>
 * Copyright (C) 2018 Jean-Pierre Charras jp.charras at wanadoo.fr
 * 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, see <https://www.gnu.org/licenses/>.
 */
 
#include <pcb_edit_frame.h> // Keep this include at top to avoid compil issue on MSYS2
#include <board.h>
#include <pcb_marker.h>
#include <footprint.h>
#include <pcb_text.h>
#include <zone.h>
#include <dialog_find.h>
#include <string_utils.h>
#include <hotkeys_basic.h>
#include <string>
#include <tool/tool_dispatcher.h>
#include <tool/tool_manager.h>
#include <tools/pcb_actions.h>
#include <wx/fdrepdlg.h>
 
 
DIALOG_FIND::DIALOG_FIND( PCB_EDIT_FRAME *aFrame ) :
        DIALOG_FIND_BASE( aFrame, wxID_ANY, _( "Find" ) ),
        m_frame( aFrame )
{
    GetSizer()->SetSizeHints( this );
 
    OptOut( m_searchCombo );
 
    m_searchCombo->Append( m_frame->GetFindHistoryList() );
 
    while( m_searchCombo->GetCount() > 10 )
    {
        m_frame->GetFindHistoryList().pop_back();
        m_searchCombo->Delete( 9 );
    }
 
    if( m_searchCombo->GetCount() )
    {
        m_searchCombo->SetSelection( 0 );
        m_searchCombo->SelectAll();
    }
 
    m_status->SetLabel( wxEmptyString);
    m_upToDate = false;
 
    m_hitList.clear();
    m_it = m_hitList.begin();
 
    m_board = m_frame->GetBoard();
 
    if( m_board )
        m_board->AddListener( this );
 
    m_frame->Bind( EDA_EVT_BOARD_CHANGED, &DIALOG_FIND::OnBoardChanged, this );
 
    if( int hotkey = ACTIONS::showSearch.GetHotKey() )
    {
        wxString hotkeyHint = wxString::Format( wxT( " (%s)" ), KeyNameFromKeyCode( hotkey ) );
        m_searchPanelLink->SetLabel( m_searchPanelLink->GetLabel() + hotkeyHint );
        m_searchPanelLink->GetParent()->Layout();
    }
 
    m_findNext->SetDefault();
    SetInitialFocus( m_searchCombo );
 
    Center();
}
 
 
DIALOG_FIND::~DIALOG_FIND()
{
    if( m_board )
        m_board->RemoveListener( this );
 
    m_frame->Unbind( EDA_EVT_BOARD_CHANGED, &DIALOG_FIND::OnBoardChanged, this );
}
 
 
void DIALOG_FIND::Preload( const wxString& aFindString )
{
    if( !aFindString.IsEmpty() )
    {
        m_searchCombo->SetValue( aFindString );
        m_searchCombo->SelectAll();
    }
}
 
 
void DIALOG_FIND::onTextEnter( wxCommandEvent& aEvent )
{
    search( true );
}
 
 
void DIALOG_FIND::onFindNextClick( wxCommandEvent& aEvent )
{
    search( true );
}
 
 
void DIALOG_FIND::onFindPreviousClick( wxCommandEvent& aEvent )
{
    search( false );
}
 
 
void DIALOG_FIND::OnCharHook( wxKeyEvent& aEvent )
{
    bool                      special = false;
    std::optional<TOOL_EVENT> evt = m_frame->GetToolDispatcher()->GetToolEvent( &aEvent, &special );
 
    if( evt && evt->IsKeyPressed() && evt->KeyCode() )
    {
        // Match the user's hotkeys for the find actions, so they work while the dialog has focus
        int hotkey = evt->Modifier() | evt->KeyCode();
 
        for( TOOL_ACTION* action : { &ACTIONS::findNext, &ACTIONS::findPrevious } )
        {
            if( hotkey == action->GetHotKey() || hotkey == action->GetHotKeyAlt() )
            {
                FindNext( action == &ACTIONS::findPrevious );
                return;
            }
        }
    }
 
    DIALOG_SHIM::OnCharHook( aEvent );
}
 
 
void DIALOG_FIND::onSearchAgainClick( wxCommandEvent& aEvent )
{
    m_upToDate = false;
    search( true );
}
 
 
void DIALOG_FIND::onShowSearchPanel( wxHyperlinkEvent& event )
{
    m_frame->GetToolManager()->RunAction( ACTIONS::showSearch );
 
    Show( false );
 
    CallAfter(
            []()
            {
                if( wxWindow* frame = wxWindow::FindWindowByName( PCB_EDIT_FRAME_NAME ) )
                    static_cast<PCB_EDIT_FRAME*>( frame )->FocusSearch();
            } );
}
 
 
void DIALOG_FIND::search( bool aDirection )
{
    PCB_SCREEN* screen = m_frame->GetScreen();
    int         index;
    wxString    msg;
    wxString    searchString;
    bool        endIsReached = false;
    bool        isFirstSearch = false;
 
    searchString = m_searchCombo->GetValue();
 
    if( searchString.IsEmpty() )
    {
        Show();
        return;
    }
 
    // Add/move the search string to the top of the list if it isn't already there
    index = m_searchCombo->FindString( searchString, true );
 
    if( index == wxNOT_FOUND )
    {
        m_searchCombo->Insert( searchString, 0 );
        m_searchCombo->SetSelection( 0 );
        m_upToDate = false;
        m_frame->GetFindHistoryList().Insert( searchString, 0 );
 
        if( m_searchCombo->GetCount() > 10 )
        {
            m_frame->GetFindHistoryList().pop_back();
            m_searchCombo->Delete( 10 );
        }
    }
    else if( index != 0 )
    {
        m_searchCombo->Delete( index );
        m_searchCombo->Insert( searchString, 0 );
        m_searchCombo->SetSelection( 0 );
        m_upToDate = false;
 
        if( m_frame->GetFindHistoryList().Index( searchString ) )
            m_frame->GetFindHistoryList().Remove( searchString );
 
        m_frame->GetFindHistoryList().Insert( searchString, 0 );
    }
 
    EDA_SEARCH_DATA& frd = m_frame->GetFindReplaceData();
 
    frd.matchCase = m_matchCase->GetValue();
 
    if( m_matchWords->GetValue() )
        frd.matchMode = EDA_SEARCH_MATCH_MODE::WHOLEWORD;
    else if( m_wildcards->GetValue() )
        frd.matchMode = EDA_SEARCH_MATCH_MODE::WILDCARD;
    else
        frd.matchMode = EDA_SEARCH_MATCH_MODE::PLAIN;
 
    frd.searchAllFields = m_checkAllFields->GetValue();
 
    // Search parameters
    frd.findString = searchString;
 
    m_frame->GetCanvas()->GetViewStart( &screen->m_StartVisu.x, &screen->m_StartVisu.y );
 
    BOARD* board = m_frame->GetBoard();
 
    // Refresh the list of results
    if( !m_upToDate )
    {
        m_status->SetLabel( _( "Searching..." ) );
        m_hitList.clear();
 
        if( m_includeTexts->GetValue() || m_includeValues->GetValue() || m_includeReferences->GetValue() )
        {
            for( FOOTPRINT* fp : board->Footprints() )
            {
                bool found = false;
 
                if( m_includeReferences->GetValue() && fp->Reference().Matches( frd, nullptr ) )
                    found = true;
 
                if( !found && m_includeValues->GetValue() && fp->Value().Matches( frd, nullptr ) )
                    found = true;
 
                if( !found && m_includeTexts->GetValue() )
                {
                    for( BOARD_ITEM* item : fp->GraphicalItems() )
                    {
                        if( item->Type() == PCB_TEXT_T )
                        {
                            PCB_TEXT* text = static_cast<PCB_TEXT*>( item );
 
                            if( text->Matches( frd, nullptr ) )
                            {
                                found = true;
                                break;
                            }
                        }
                    }
                }
 
                if( !found && m_includeTexts->GetValue() )
                {
                    for( PCB_FIELD* field : fp->GetFields() )
                    {
                        wxCHECK2( field, continue );
 
                        if( field->Matches( frd, nullptr ) )
                        {
                            found = true;
                            break;
                        }
                    }
                }
 
                if( found )
                    m_hitList.push_back( fp );
            }
 
            if( m_includeTexts->GetValue() )
            {
                for( BOARD_ITEM* item : board->Drawings() )
                {
                    if( item->Type() == PCB_TEXT_T )
                    {
                        PCB_TEXT* text = static_cast<PCB_TEXT*>( item );
 
                        if( text && text->Matches( frd, nullptr ) )
                            m_hitList.push_back( text );
                    }
                }
 
                for( BOARD_ITEM* item : board->Zones() )
                {
                    ZONE* zone = static_cast<ZONE*>( item );
 
                    if( zone->Matches( frd, nullptr ) )
                        m_hitList.push_back( zone );
                }
            }
        }
 
        if( m_includeMarkers->GetValue() )
        {
            for( PCB_MARKER* marker : board->Markers() )
            {
                if( marker->Matches( frd, nullptr ) )
                    m_hitList.push_back( marker );
            }
        }
 
        if( m_includeNets->GetValue() )
        {
            for( NETINFO_ITEM* net : board->GetNetInfo() )
            {
                if( net && net->Matches( frd, nullptr ) )
                    m_hitList.push_back( net );
            }
        }
 
        m_upToDate = true;
        isFirstSearch = true;
 
        if( aDirection )
            m_it = m_hitList.begin();
        else
            m_it = m_hitList.end();
    }
 
    // Do we want a sorting algorithm ? If so, implement it here.
 
    // Get the item to display
    if( m_hitList.empty() )
    {
        m_frame->SetStatusText( wxEmptyString );
    }
    else
    {
        if( aDirection )
        {
            if( m_it != m_hitList.end() && !isFirstSearch )
                m_it++;
 
            if( m_it == m_hitList.end() )
            {
                if( m_wrap->GetValue() )
                {
                    m_it = m_hitList.begin();
                }
                else
                {
                    endIsReached = true;
                    m_it--; // point to the last REAL result
                }
            }
        }
        else
        {
            if( m_it == m_hitList.begin() )
            {
                if( m_wrap->GetValue() )
                    m_it = m_hitList.end();
                else
                    endIsReached = true;
            }
 
            if( m_it != m_hitList.begin() )
                m_it--;
        }
    }
 
    // Display the item
    if( m_hitList.empty() )
    {
        m_frame->SetStatusText( wxEmptyString );
        msg.Printf( _( "'%s' not found" ), searchString );
        m_frame->ShowInfoBarMsg( msg );
 
        m_status->SetLabel( msg );
    }
    else if( endIsReached || m_it == m_hitList.end() )
    {
        m_frame->SetStatusText( wxEmptyString );
        m_frame->ShowInfoBarMsg( _( "No more items to show" ) );
 
        m_status->SetLabel( _( "No hits" ) );
    }
    else
    {
        m_frame->GetToolManager()->RunAction( ACTIONS::selectionClear );
        m_frame->GetToolManager()->RunAction<EDA_ITEM*>( ACTIONS::selectItem, *m_it );
 
        msg.Printf( _( "'%s' found" ), searchString );
        m_frame->SetStatusText( msg );
 
        msg.Printf( _( "Hit(s): %d / %zu" ),
                    (int)std::distance( m_hitList.begin(), m_it ) + 1,
                    m_hitList.size() );
        m_status->SetLabel( msg );
    }
 
    if( m_highlightCallback )
        m_highlightCallback( GetItem() );
}
 
 
bool DIALOG_FIND::Show( bool show )
{
    bool ret = DIALOG_FIND_BASE::Show( show );
 
    if( show )
        m_searchCombo->SetFocus();
 
    return ret;
}
 
 
void DIALOG_FIND::OnBoardChanged( wxCommandEvent& event )
{
    m_board = m_frame->GetBoard();
 
    if( m_board )
        m_board->AddListener( this );
 
    m_upToDate = false;
 
    event.Skip();
}