filter_combobox.h

Go to the documentation of this file.

 
/*
 * 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, see <https://www.gnu.org/licenses/>.
 */
 
#pragma once
 
#include <memory>
#include <optional>
 
#include <wx/panel.h>
#include <wx/combo.h>
#include <wx/listbox.h>
 
 
class wxTextValidator;
class wxTextCtrl;
class wxListBox;
 
 
class FILTER_COMBOPOPUP : public wxPanel, public wxComboPopup
{
public:
    FILTER_COMBOPOPUP();
 
    bool Create( wxWindow* aParent ) override;
 
    wxWindow* GetControl() override { return this; }
 
    void SetStringList( const wxArrayString& aStringList );
 
    wxString GetStringValue() const override;
    void SetStringValue( const wxString& aNetName ) override;
 
    void SetSelectedString( const wxString& aString );
 
    void OnPopup() override;
 
    void OnStartingKey( wxKeyEvent& aEvent );
 
    wxSize GetAdjustedSize( int aMinWidth, int aPrefHeight, int aMaxHeight ) override;
 
    virtual void Accept();
 
protected:
    std::optional<wxString> getSelectedValue() const;

    wxString getFilterValue() const;

    virtual void getListContent( wxArrayString& aStringList );

    void rebuildList();
 
private:
    wxSize updateSize();
 
    void onIdle( wxIdleEvent& aEvent );
 
    // Hot-track the mouse (for focus and listbox selection)
    void onMouseMoved( const wxPoint aScreenPos );
    void onMouseClick( wxMouseEvent& aEvent );
    void onKeyDown( wxKeyEvent& aEvent );
    void onEnter( wxCommandEvent& aEvent );
    void onFilterEdit( wxCommandEvent& aEvent );
    void doStartingKey( wxKeyEvent& aEvent );
    void doSetFocus( wxWindow* aWindow );
 
protected:
    wxTextValidator* m_filterValidator;
    wxTextCtrl*      m_filterCtrl;
    wxListBox*       m_listBox;
    int              m_minPopupWidth;
    int              m_maxPopupHeight;
 
    wxEvtHandler*    m_focusHandler;
 
    wxString         m_selectedString;
    wxArrayString    m_stringList;
};
 
 
wxDECLARE_EVENT( FILTERED_ITEM_SELECTED, wxCommandEvent );

class FILTER_COMBOBOX : public wxComboCtrl
{
public:
    // C'tor matching wxFormBuilder's Custom Control
    FILTER_COMBOBOX( wxWindow* parent, wxWindowID id, const wxPoint& pos = wxDefaultPosition,
                     const wxSize& size = wxDefaultSize, long style = 0 );
 
    // C'tor matching wxFormBuilder's ComboxBox.
    FILTER_COMBOBOX( wxWindow* parent, wxWindowID id, const wxString& value,
                     const wxPoint& pos = wxDefaultPosition, const wxSize& size = wxDefaultSize,
                     int count = 0, wxString strings[] = nullptr, long style = 0 );
 
    ~FILTER_COMBOBOX();
 
    virtual void SetStringList( const wxArrayString& aStringList );
 
    virtual void SetSelectedString( const wxString& aString );
 
protected:
    void setFilterPopup( FILTER_COMBOPOPUP* aPopup );
 
    void onKeyDown( wxKeyEvent& aEvt );
 
    FILTER_COMBOPOPUP* m_filterPopup;
};