properties_panel.h

Go to the documentation of this file.

/*
 * This program source code file is part of KICAD, a free EDA CAD application.
 *
 * Copyright (C) 2016 CERN
 * @author Maciej Suminski <[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 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/>.
 */
#ifndef PROPERTIES_PANEL_H
#define PROPERTIES_PANEL_H
 
#include <wx/panel.h>
#include <wx/propgrid/propgrid.h>
 
#include <vector>
#include <memory>
 
class EDA_BASE_FRAME;
class EDA_ITEM;
class SELECTION;
class PROPERTY_BASE;
class wxStaticText;
 
class PROPERTIES_PANEL : public wxPanel
{
public:
    PROPERTIES_PANEL( wxWindow* aParent, EDA_BASE_FRAME* aFrame );
 
    virtual ~PROPERTIES_PANEL();
 
    virtual void UpdateData() = 0;
 
    virtual void AfterCommit() {}
 
    wxPropertyGrid* GetPropertyGrid()
    {
        return m_grid;
    }
 
    int PropertiesCount() const
    {
        return m_displayed.size();
    }
 
    const std::vector<PROPERTY_BASE*>& Properties() const
    {
        return m_displayed;
    }
 
    void RecalculateSplitterPos();
 
    void SetSplitterProportion( float aProportion );
    float SplitterProportion() const { return m_splitter_key_proportion; }
 
protected:
    virtual void rebuildProperties( const SELECTION& aSelection );
 
    virtual wxPGProperty* createPGProperty( const PROPERTY_BASE* aProperty ) const = 0;
 
    // Event handlers
    virtual void valueChanging( wxPropertyGridEvent& aEvent ) { aEvent.Skip(); }
    virtual void valueChanged( wxPropertyGridEvent& aEvent ) { aEvent.Skip(); }
    void onCharHook( wxKeyEvent& aEvent );
    void onShow( wxShowEvent& aEvent );
 
    virtual void OnLanguageChanged( wxCommandEvent& aEvent );

    virtual bool getItemValue( EDA_ITEM* aItem, PROPERTY_BASE* aProperty, wxVariant& aValue );

    bool extractValueAndWritability( const SELECTION& aSelection, const wxString& aPropName,
                                     wxVariant& aValue, bool& aWritable, wxPGChoices& aChoices );
 
public:
    int                         m_SuppressGridChangeEvents;
 
protected:
    std::vector<PROPERTY_BASE*> m_displayed;    // no ownership of pointers
    wxPropertyGrid*             m_grid;
    EDA_BASE_FRAME*             m_frame;
    wxStaticText*               m_caption;

    float m_splitter_key_proportion;
};
 
class SUPPRESS_GRID_CHANGED_EVENTS
{
public:
    SUPPRESS_GRID_CHANGED_EVENTS( PROPERTIES_PANEL* aPanel );
    ~SUPPRESS_GRID_CHANGED_EVENTS();
 
private:
    PROPERTIES_PANEL* m_panel;
};
 
#endif /* PROPERTIES_PANEL_H */