qgscollapsiblegroupbox.h

Go to the documentation of this file.

/***************************************************************************
                          qgscollapsiblegroupbox.h
                             -------------------
    begin                : August 2012
    copyright            : (C) 2012 by Etienne Tourigny
    email                : etourigny dot dev at gmail dot com
 ***************************************************************************/
 
/***************************************************************************
 *                                                                         *
 *   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.                                   *
 *                                                                         *
 ***************************************************************************/
 
#ifndef QGSCOLLAPSIBLEGROUPBOX_H
#define QGSCOLLAPSIBLEGROUPBOX_H
 
#include "qgis_gui.h"
#include "qgis_sip.h"
#include "qgssettings.h"
 
#include <QGroupBox>
#include <QPointer>
#include <QToolButton>
 
class QMouseEvent;
class QToolButton;
class QScrollArea;

class GUI_EXPORT QgsGroupBoxCollapseButton : public QToolButton
{
    Q_OBJECT
 
  public:
    QgsGroupBoxCollapseButton( QWidget *parent SIP_TRANSFERTHIS = nullptr )
      : QToolButton( parent )
    {}
 
    bool altDown() const { return mAltDown; }
    void setAltDown( bool updown ) { mAltDown = updown; }
 
    bool shiftDown() const { return mShiftDown; }
    void setShiftDown( bool shiftdown ) { mShiftDown = shiftdown; }
 
  protected:
    void mouseReleaseEvent( QMouseEvent *event ) override;
 
  private:
    bool mAltDown = false;
    bool mShiftDown = false;
};

 
class GUI_EXPORT QgsCollapsibleGroupBoxBasic : public QGroupBox
{
    Q_OBJECT

    Q_PROPERTY( bool collapsed READ isCollapsed WRITE setCollapsed USER true )
 
    
    Q_PROPERTY( QString syncGroup READ syncGroup WRITE setSyncGroup )

    Q_PROPERTY( bool scrollOnExpand READ scrollOnExpand WRITE setScrollOnExpand )
 
  public:
    QgsCollapsibleGroupBoxBasic( QWidget *parent SIP_TRANSFERTHIS = nullptr );
    QgsCollapsibleGroupBoxBasic( const QString &title, QWidget *parent SIP_TRANSFERTHIS = nullptr );

    bool isCollapsed() const { return mCollapsed; }

    void setCollapsed( bool collapse );

    QString syncGroup() const { return mSyncGroup; }

    void setSyncGroup( const QString &grp );

    void setScrollOnExpand( bool scroll ) { mScrollOnExpand = scroll; }

    bool scrollOnExpand() const { return mScrollOnExpand; }
 
  signals:
    void collapsedStateChanged( bool collapsed );
 
  public slots:
    void checkToggled( bool ckd );
    void checkClicked( bool ckd );
    void toggleCollapsed();

    void setStyleSheet( const QString &style );
 
  protected:
    void collapseExpandFixes();
 
    void showEvent( QShowEvent *event ) override;
    void mousePressEvent( QMouseEvent *event ) override;
    void mouseReleaseEvent( QMouseEvent *event ) override;
    void changeEvent( QEvent *event ) override;
 
    void updateStyle();
    QRect titleRect() const;
    void clearModifiers();
 
    bool mCollapsed;
    bool mInitFlat;
    bool mInitFlatChecked;
    bool mScrollOnExpand;
    bool mShown;
    QScrollArea *mParentScrollArea = nullptr;
    QgsGroupBoxCollapseButton *mCollapseButton = nullptr;
    QWidget *mSyncParent = nullptr;
    QString mSyncGroup;
    bool mAltDown;
    bool mShiftDown;
    bool mTitleClicked;
 
    QIcon mCollapseIcon;
    QIcon mExpandIcon;
 
  private:
    void init();
};

 
class GUI_EXPORT QgsCollapsibleGroupBox : public QgsCollapsibleGroupBoxBasic
{
    Q_OBJECT

    Q_PROPERTY( bool saveCollapsedState READ saveCollapsedState WRITE setSaveCollapsedState )
 
    
    Q_PROPERTY( bool saveCheckedState READ saveCheckedState WRITE setSaveCheckedState )
 
  public:
    QgsCollapsibleGroupBox( QWidget *parent SIP_TRANSFERTHIS = nullptr, QgsSettings *settings = nullptr );
    QgsCollapsibleGroupBox( const QString &title, QWidget *parent SIP_TRANSFERTHIS = nullptr, QgsSettings *settings = nullptr );
    ~QgsCollapsibleGroupBox() override;
 
    // set custom QgsSettings pointer if group box was already created from QtDesigner promotion
    void setSettings( QgsSettings *settings );

    void setSaveCollapsedState( bool save ) { mSaveCollapsedState = save; }

    void setSaveCheckedState( bool save ) { mSaveCheckedState = save; }

    bool saveCollapsedState() const { return mSaveCollapsedState; }

    bool saveCheckedState() const { return mSaveCheckedState; }

    void setSettingGroup( const QString &group ) { mSettingGroup = group; }
    QString settingGroup() const { return mSettingGroup; }
 
  protected slots:

    void loadState();

    void saveState() const;
 
  protected:
    void showEvent( QShowEvent *event ) override;
    QString saveKey() const;
 
  private:
    void init();
 
    // pointer to app or custom, external QgsSettings
    // QPointer in case custom settings obj gets deleted while groupbox's dialog is open
    QPointer<QgsSettings> mSettings;
    bool mDelSettings;
 
    bool mSaveCollapsedState;
    bool mSaveCheckedState;
    QString mSettingGroup;
};
 
#endif