qgscheckablecombobox.h

Go to the documentation of this file.

/***************************************************************************
                              qgscheckablecombobox.h
                              ------------------------
  begin                : March 21, 2017
  copyright            : (C) 2017 by Alexander Bruy
  email                : alexander dot bruy 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 QGSCHECKABLECOMBOBOX_H
#define QGSCHECKABLECOMBOBOX_H

#include <QComboBox>
#include <QMenu>
#include <QStandardItemModel>
#include <QStyledItemDelegate>

#include "qgis_sip.h"
#include "qgis_gui.h"

class QEvent;

#ifndef SIP_RUN
class QgsCheckableItemModel : public QStandardItemModel
{
    Q_OBJECT

  public:

    QgsCheckableItemModel( QObject *parent = nullptr );

    Qt::ItemFlags flags( const QModelIndex &index ) const override;

    QVariant data( const QModelIndex &index, int role = Qt::DisplayRole ) const override;

    bool setData( const QModelIndex &index, const QVariant &value, int role = Qt::EditRole ) override;

  signals:

    void itemCheckStateChanged();
};


class QgsCheckBoxDelegate : public QStyledItemDelegate
{
    Q_OBJECT

  public:

    QgsCheckBoxDelegate( QObject *parent = nullptr );

    void paint( QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index ) const override;
};
#endif

class GUI_EXPORT QgsCheckableComboBox : public QComboBox
{
    Q_OBJECT

    Q_PROPERTY( QString separator READ separator WRITE setSeparator )
    Q_PROPERTY( QString defaultText READ defaultText WRITE setDefaultText )
    Q_PROPERTY( QStringList checkedItems READ checkedItems WRITE setCheckedItems )

  public:

    QgsCheckableComboBox( QWidget *parent SIP_TRANSFERTHIS = nullptr );

    QString separator() const;

    void setSeparator( const QString &separator );

    QString defaultText() const;

    void setDefaultText( const QString &text );

    QStringList checkedItems() const;

    Qt::CheckState itemCheckState( int index ) const;

    void setItemCheckState( int index, Qt::CheckState state );

    void toggleItemCheckState( int index );

    void hidePopup() override;

    bool eventFilter( QObject *object, QEvent *event ) override;

  signals:

    void checkedItemsChanged( const QStringList &items );

  public slots:

    void setCheckedItems( const QStringList &items );

  protected:

    void resizeEvent( QResizeEvent *event ) override;

  protected slots:

    void showContextMenu( QPoint pos );

    void selectAllOptions();

    void deselectAllOptions();

  private:
    void updateCheckedItems();
    void updateDisplayText();

    QString mSeparator;
    QString mDefaultText;

    bool mSkipHide = false;

    QMenu *mContextMenu = nullptr;
    QAction *mSelectAllAction = nullptr;
    QAction *mDeselectAllAction = nullptr;
};

#endif // QGSCHECKABLECOMBOBOX_H