grid_text_helpers.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.
 * @author Jon Evans <[email protected]>
 *
 * 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 3 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 <kicommon.h>
#include <functional>
#include <memory>
#include <wx/generic/gridctrl.h>
#include <wx/combo.h>
 
class wxGrid;
class wxStyledTextCtrl;
class wxStyledTextEvent;
class SCINTILLA_TRICKS;
 

class KICOMMON_API GRID_CELL_TEXT_EDITOR : public wxGridCellTextEditor
{
public:
    GRID_CELL_TEXT_EDITOR();
 
    void SetSize( const wxRect& aRect ) override;
 
    virtual void SetValidator( const wxValidator& validator ) override;
    virtual void StartingKey( wxKeyEvent& event ) override;
 
protected:
    std::unique_ptr<wxValidator> m_validator;
};
 

class KICOMMON_API GRID_CELL_ESCAPED_TEXT_RENDERER : public wxGridCellStringRenderer
{
public:
    GRID_CELL_ESCAPED_TEXT_RENDERER();
 
    void Draw( wxGrid& aGrid, wxGridCellAttr& aAttr, wxDC& aDC, const wxRect& aRect, int aRow,
               int aCol, bool isSelected ) override;
 
    wxSize GetBestSize( wxGrid& grid, wxGridCellAttr& attr, wxDC& dc, int row, int col ) override;
};
 
 
class KICOMMON_API GRID_CELL_STC_EDITOR : public wxGridCellEditor
{
public:
    GRID_CELL_STC_EDITOR( bool aIgnoreCase, bool aSingleLine,
                          std::function<void( wxStyledTextEvent&, SCINTILLA_TRICKS* )> onCharFn );
 
    void SetSize( const wxRect& aRect ) override;
    void Create( wxWindow* aParent, wxWindowID aId, wxEvtHandler* aEventHandler ) override;
 
    wxGridCellEditor* Clone() const override
    {
        return new GRID_CELL_STC_EDITOR( m_ignoreCase, m_singleLine, m_onCharFn );
    }
 
    wxString GetValue() const override;
 
    void StartingKey( wxKeyEvent& event ) override;
    void Show( bool aShow, wxGridCellAttr *aAttr = nullptr ) override;
    void BeginEdit( int aRow, int aCol, wxGrid* aGrid ) override;
    bool EndEdit( int aRow, int aCol, const wxGrid*, const wxString&, wxString* aNewVal ) override;
    void ApplyEdit( int aRow, int aCol, wxGrid* aGrid ) override;
    void Reset() override {}
 
protected:
    void onFocusLoss( wxFocusEvent& aEvent );
 
    wxStyledTextCtrl* stc_ctrl() const;
 
protected:
    SCINTILLA_TRICKS* m_scintillaTricks;
    bool              m_ignoreCase;
    bool              m_singleLine;
    wxString          m_value;
 
    std::function<void( wxStyledTextEvent&, SCINTILLA_TRICKS* )> m_onCharFn;
};
 
 
class KICOMMON_API GRID_CELL_TEXT_BUTTON : public wxGridCellEditor
{
public:
    GRID_CELL_TEXT_BUTTON() :
            m_grid( nullptr ),
            m_row( -1 ),
            m_col( -1 )
    {};
 
    wxString GetValue() const override;
 
    void SetSize( const wxRect& aRect ) override;
 
    void StartingKey( wxKeyEvent& event ) override;
    void BeginEdit( int aRow, int aCol, wxGrid* aGrid ) override;
    bool EndEdit( int , int , const wxGrid* , const wxString& , wxString *aNewVal ) override;
    void ApplyEdit( int aRow, int aCol, wxGrid* aGrid ) override;
    void Reset() override;
 
    void OnTextChange( wxCommandEvent& event );
 
#if wxUSE_VALIDATORS
    void SetValidator( const wxValidator& validator );
#endif
 
protected:
    wxComboCtrl* Combo() const { return static_cast<wxComboCtrl*>( m_control ); }
 
protected:
#if wxUSE_VALIDATORS
    std::unique_ptr< wxValidator > m_validator;
#endif
 
    wxGrid*  m_grid;
    int      m_row;
    int      m_col;
    wxString m_value;
 
    wxDECLARE_NO_COPY_CLASS( GRID_CELL_TEXT_BUTTON );
};
 
 
class KICOMMON_API GRID_CELL_NULLABLE_INTERFACE
{
public:
    GRID_CELL_NULLABLE_INTERFACE() :
            m_isNullable( true )
    {
    }
    GRID_CELL_NULLABLE_INTERFACE( bool aIsNullable ) :
            m_isNullable( aIsNullable )
    {
    }
    virtual ~GRID_CELL_NULLABLE_INTERFACE() = default;
 
    virtual bool IsNullable() const { return m_isNullable; }
 
protected:
    bool m_isNullable{ false };
};
 
 
//---- Grid helpers: custom wxGridCellTextEditor ------------------------------------------
//
// Note: This is used to mark WX_GRID cell as nullable
class KICOMMON_API GRID_CELL_MARK_AS_NULLABLE : public wxGridCellTextEditor, public GRID_CELL_NULLABLE_INTERFACE
{
public:
    GRID_CELL_MARK_AS_NULLABLE() :
            GRID_CELL_NULLABLE_INTERFACE( true )
    {
    }
    GRID_CELL_MARK_AS_NULLABLE( const bool aIsNullable ) :
            GRID_CELL_NULLABLE_INTERFACE( aIsNullable )
    {
    }
 
    wxGridCellEditor* Clone() const override { return new GRID_CELL_MARK_AS_NULLABLE( IsNullable() ); }
 
    void Reset() override {}
 
 
    wxDECLARE_NO_COPY_CLASS( GRID_CELL_MARK_AS_NULLABLE );
};