wx_collapsible_pane.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 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/>.
 */
 
#ifndef KICAD_WX_COLLAPSIBLE_PANE_H
#define KICAD_WX_COLLAPSIBLE_PANE_H
 
#include <wx/control.h>
#include <wx/containr.h>
#include <wx/statbox.h> // needed to provide a hint that wx libraries instantiated
                        // wxNavigationEnabled<wxControl>
#include <kicommon.h>
 
 
extern const KICOMMON_API wxEventTypeTag<wxCommandEvent> WX_COLLAPSIBLE_PANE_HEADER_CHANGED;
extern const KICOMMON_API wxEventTypeTag<wxCommandEvent> WX_COLLAPSIBLE_PANE_CHANGED;
 
class WX_COLLAPSIBLE_PANE;
 

class KICOMMON_API WX_COLLAPSIBLE_PANE_HEADER : public wxControl
{
public:
    WX_COLLAPSIBLE_PANE_HEADER( WX_COLLAPSIBLE_PANE* aParent, wxWindowID aId, const wxString& aLabel );
 
    bool Create( wxWindow* aParent, wxWindowID aId, const wxString& aLabel );
 
    void SetCollapsed( bool aCollapsed = true );
 
    bool IsCollapsed() const { return m_collapsed; }
 
protected:
    wxSize DoGetBestClientSize() const override;
 
private:
    void init();
 
    void onPaint( wxPaintEvent& aEvent );
 
    void onFocus( wxFocusEvent& aEvent );
 
    void onEnterWindow( wxMouseEvent& aEvent );
 
    void onLeaveWindow( wxMouseEvent& aEvent );
 
    void onLeftUp( wxMouseEvent& aEvent );
 
    void onChar( wxKeyEvent& aEvent );
 
    void doSetCollapsed( bool aCollapsed );
 
    void drawArrow( wxDC& aDC, wxRect aRect, bool aIsActive );
 
private:
    WX_COLLAPSIBLE_PANE* m_parent;
    wxString             m_label;
    bool                 m_collapsed;
    bool                 m_inWindow;
};
 

class KICOMMON_API WX_COLLAPSIBLE_PANE : public wxNavigationEnabled<wxControl>
{
public:
    WX_COLLAPSIBLE_PANE( wxWindow* aParent, wxWindowID aId, const wxString& aLabel )
    {
        init();
        Create( aParent, aId, aLabel );
    }
 
    ~WX_COLLAPSIBLE_PANE();
 
    bool Create( wxWindow* aParent, wxWindowID aId, const wxString& aLabel );
 
    void Collapse( bool aCollapse = true );
 
    void Expand()
    {
        Collapse( false );
    }
 
    bool IsCollapsed() const;
 
    bool IsExpanded() const { return !IsCollapsed(); }
 
    wxWindow* GetPane() { return m_pane; }
 
    int GetMargin() const;
 
    wxString GetLabel() const override
    {
        return m_header->GetLabel();
    }
 
    void SetLabel( const wxString& aLabel ) override;
 
    bool SetBackgroundColour( const wxColour& aColor ) override;
 
    bool InformFirstDirection( int aDirection, int aSize, int aAvailableOtherDir ) override;
 
    bool Layout() override;
 
protected:
    wxSize DoGetBestClientSize() const override;
 
private:
    void init();
 
    void onSize( wxSizeEvent& aEvent );
 
    void onHeaderClicked( wxCommandEvent& aEvent );
 
private:
    wxWindow*                   m_pane;
    wxSizer*                    m_sizer;
    WX_COLLAPSIBLE_PANE_HEADER* m_header;
};
 
#endif // KICAD_WX_COLLAPSIBLE_PANE_H