qgsfeaturelistcombobox.h

Go to the documentation of this file.

/***************************************************************************
  qgsfeaturelistcombobox.h - QgsFeatureListComboBox
 ---------------------
 begin                : 10.3.2017
 copyright            : (C) 2017 by Matthias Kuhn
 email                : [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.                                   *
 *                                                                         *
 ***************************************************************************/
#ifndef QGSFIELDLISTCOMBOBOX_H
#define QGSFIELDLISTCOMBOBOX_H
 
#include <QComboBox>
 
#include "qgsfeature.h"
#include "qgis_gui.h"
 
class QgsVectorLayer;
class QgsFeatureFilterModel;
class QgsAnimatedIcon;
class QgsFilterLineEdit;
class QgsFeatureRequest;
 
class GUI_EXPORT QgsFeatureListComboBox : public QComboBox
{
    Q_OBJECT
 
    Q_PROPERTY( QgsVectorLayer *sourceLayer READ sourceLayer WRITE setSourceLayer NOTIFY sourceLayerChanged )
    Q_PROPERTY( QString displayExpression READ displayExpression WRITE setDisplayExpression NOTIFY displayExpressionChanged )
    Q_PROPERTY( QString filterExpression READ filterExpression WRITE setFilterExpression NOTIFY filterExpressionChanged )
    Q_PROPERTY( QVariant identifierValue READ identifierValue WRITE setIdentifierValue NOTIFY identifierValueChanged )
    Q_PROPERTY( QVariantList identifierValues READ identifierValues WRITE setIdentifierValues NOTIFY identifierValueChanged )
    Q_PROPERTY( QString identifierField READ identifierField WRITE setIdentifierField NOTIFY identifierFieldChanged )
    Q_PROPERTY( bool allowNull READ allowNull WRITE setAllowNull NOTIFY allowNullChanged )
 
  public:
    QgsFeatureListComboBox( QWidget *parent = nullptr );
 
    QgsVectorLayer *sourceLayer() const;
 
    void setSourceLayer( QgsVectorLayer *sourceLayer );
 
    void setCurrentFeature( const QgsFeature &feature );
 
    QString displayExpression() const;
 
    void setDisplayExpression( const QString &displayExpression );
 
    int nullIndex() const;
 
    QString filterExpression() const;
 
    void setFilterExpression( const QString &filterExpression );
 
    QgsFeature formFeature() const;
 
    void setFormFeature( const QgsFeature &feature );
 
    QgsFeature parentFormFeature() const;
 
    void setParentFormFeature( const QgsFeature &feature );
 
    Q_DECL_DEPRECATED QVariant identifierValue() const SIP_DEPRECATED;
 
    QVariantList identifierValues() const;
 
 
    Q_DECL_DEPRECATED void setIdentifierValue( const QVariant &identifierValue ) SIP_DEPRECATED;
 
    void setIdentifierValues( const QVariantList &identifierValues );
 
    void setIdentifierValuesToNull();
 
    QgsFeatureRequest currentFeatureRequest() const;
 
    bool allowNull() const;
 
    void setAllowNull( bool allowNull );
 
    int fetchLimit() const;
 
    void setFetchLimit( int fetchLimit );
 
    Q_DECL_DEPRECATED QString identifierField() const SIP_DEPRECATED;
 
    QStringList identifierFields() const;
 
    Q_DECL_DEPRECATED void setIdentifierField( const QString &identifierField ) SIP_DEPRECATED;
 
    void setIdentifierFields( const QStringList &identifierFields );
 
    QModelIndex currentModelIndex() const;
 
    void focusOutEvent( QFocusEvent *event ) override;
 
    void keyPressEvent( QKeyEvent *event ) override;
 
  signals:
 
    void modelUpdated();
 
    void sourceLayerChanged();
 
    void displayExpressionChanged();
 
    void filterExpressionChanged();
 
    void formFeatureChanged();
 
    void parentFormFeatureChanged();
 
    void identifierValueChanged();
 
    void identifierFieldChanged();
 
    void allowNullChanged();
 
    void currentFeatureChanged();
 
    void currentFeatureFoundChanged( bool found );
 
  private slots:
    void onCurrentTextChanged( const QString &text );
    void onFilterLineEditCleared();
    void onFilterUpdateCompleted();
    void onLoadingChanged();
    void onItemSelected( const QModelIndex &index );
    void onCurrentIndexChanged( int i );
    void onActivated( QModelIndex index );
    void storeLineEditState();
    void restoreLineEditState();
    void onDataChanged( const QModelIndex &topLeft, const QModelIndex &bottomRight, const QVector<int> &roles = QVector<int>() );
 
  private:
    QgsFeatureFilterModel *mModel = nullptr;
    QCompleter *mCompleter = nullptr;
    QgsFilterLineEdit *mLineEdit;
    bool mPopupRequested = false;
    bool mIsCurrentlyEdited = false;
 
    friend class TestQgsFeatureListComboBox;
};
 
 
#endif // QGSFIELDLISTCOMBOBOX_H