QGIS API Documentation  3.2.0-Bonn (bc43194)
qgsfeaturelistcombobox.cpp
Go to the documentation of this file.
1 /***************************************************************************
2  qgsfieldlistcombobox.cpp - QgsFieldListComboBox
3 
4  ---------------------
5  begin : 10.3.2017
6  copyright : (C) 2017 by Matthias Kuhn
7  email : [email protected]
8  ***************************************************************************
9  * *
10  * This program is free software; you can redistribute it and/or modify *
11  * it under the terms of the GNU General Public License as published by *
12  * the Free Software Foundation; either version 2 of the License, or *
13  * (at your option) any later version. *
14  * *
15  ***************************************************************************/
16 #include "qgsfeaturelistcombobox.h"
17 
18 #include "qgsfeaturefiltermodel.h"
19 #include "qgsanimatedicon.h"
20 #include "qgsfilterlineedit.h"
21 #include "qgslogger.h"
22 
23 #include <QCompleter>
24 #include <QLineEdit>
25 #include <QKeyEvent>
26 
28  : QComboBox( parent )
29  , mModel( new QgsFeatureFilterModel( this ) )
30  , mCompleter( new QCompleter( mModel ) )
31 {
32  mCompleter->setCaseSensitivity( Qt::CaseInsensitive );
33  mCompleter->setFilterMode( Qt::MatchContains );
34  setCompleter( mCompleter );
35  mCompleter->setWidget( this );
39  connect( mModel, &QgsFeatureFilterModel::isLoadingChanged, this, &QgsFeatureListComboBox::onLoadingChanged );
40  connect( mModel, &QgsFeatureFilterModel::filterJobCompleted, this, &QgsFeatureListComboBox::onFilterUpdateCompleted );
43  connect( mModel, &QgsFeatureFilterModel::extraIdentifierValueIndexChanged, this, &QgsFeatureListComboBox::setCurrentIndex );
45  connect( mCompleter, static_cast<void( QCompleter::* )( const QModelIndex & )>( &QCompleter::highlighted ), this, &QgsFeatureListComboBox::onItemSelected );
46  connect( mCompleter, static_cast<void( QCompleter::* )( const QModelIndex & )>( &QCompleter::activated ), this, &QgsFeatureListComboBox::onActivated );
47  connect( mModel, &QgsFeatureFilterModel::beginUpdate, this, &QgsFeatureListComboBox::storeLineEditState );
48  connect( mModel, &QgsFeatureFilterModel::endUpdate, this, &QgsFeatureListComboBox::restoreLineEditState );
50  connect( mModel, &QgsFeatureFilterModel::dataChanged, this, &QgsFeatureListComboBox::onDataChanged );
51 
52  connect( this, static_cast<void( QgsFeatureListComboBox::* )( int )>( &QgsFeatureListComboBox::currentIndexChanged ), this, &QgsFeatureListComboBox::onCurrentIndexChanged );
53 
54  mLineEdit = new QgsFilterLineEdit();
55  mLineEdit->setSelectOnFocus( true );
56  setEditable( true );
57  setLineEdit( mLineEdit );
58  setModel( mModel );
59 
60  connect( mLineEdit, &QgsFilterLineEdit::textEdited, this, &QgsFeatureListComboBox::onCurrentTextChanged );
61 
62  setToolTip( tr( "Just start typing what you are looking for." ) );
63 }
64 
66 {
67  return mModel->sourceLayer();
68 }
69 
71 {
72  mModel->setSourceLayer( sourceLayer );
73 }
74 
76 {
77  return mModel->displayExpression();
78 }
79 
80 void QgsFeatureListComboBox::setDisplayExpression( const QString &expression )
81 {
82  mModel->setDisplayExpression( expression );
83 }
84 
85 void QgsFeatureListComboBox::onCurrentTextChanged( const QString &text )
86 {
87  mIsCurrentlyEdited = true;
88  mPopupRequested = true;
89  mModel->setFilterValue( text );
90 }
91 
92 void QgsFeatureListComboBox::onFilterUpdateCompleted()
93 {
94  if ( mPopupRequested )
95  mCompleter->complete();
96 
97  mPopupRequested = false;
98 }
99 
100 void QgsFeatureListComboBox::onLoadingChanged()
101 {
102  mLineEdit->setShowSpinner( mModel->isLoading() );
103 }
104 
105 void QgsFeatureListComboBox::onItemSelected( const QModelIndex &index )
106 {
107  setCurrentIndex( index.row() );
108 }
109 
110 void QgsFeatureListComboBox::onCurrentIndexChanged( int i )
111 {
112  mIsCurrentlyEdited = false;
113  QModelIndex modelIndex = mModel->index( i, 0, QModelIndex() );
115  mLineEdit->setText( mModel->data( modelIndex, QgsFeatureFilterModel::ValueRole ).toString() );
116  mLineEdit->setFont( mModel->data( modelIndex, Qt::FontRole ).value<QFont>() );
117  QPalette palette = mLineEdit->palette();
118  palette.setBrush( mLineEdit->foregroundRole(), mModel->data( modelIndex, Qt::ForegroundRole ).value<QBrush>() );
119  mLineEdit->setPalette( palette );
120 }
121 
122 void QgsFeatureListComboBox::onActivated( QModelIndex modelIndex )
123 {
125  mLineEdit->setText( mModel->data( modelIndex, QgsFeatureFilterModel::ValueRole ).toString() );
126 }
127 
128 void QgsFeatureListComboBox::storeLineEditState()
129 {
130  if ( mIsCurrentlyEdited )
131  mLineEditState.store( mLineEdit );
132 }
133 
134 void QgsFeatureListComboBox::restoreLineEditState()
135 {
136  if ( mIsCurrentlyEdited )
137  mLineEditState.restore( mLineEdit );
138 }
139 
141 {
142  int index = -1;
143 
144  if ( allowNull() )
145  {
146  index = findText( tr( "NULL" ) );
147  }
148 
149  return index;
150 }
151 
152 void QgsFeatureListComboBox::onDataChanged( const QModelIndex &topLeft, const QModelIndex &bottomRight, const QVector<int> &roles )
153 {
154  Q_UNUSED( roles )
155  if ( !mIsCurrentlyEdited )
156  {
157  const int currentIndex = mModel->extraIdentifierValueIndex();
158  if ( currentIndex >= topLeft.row() && currentIndex <= bottomRight.row() )
159  {
160  QModelIndex modelIndex = mModel->index( currentIndex, 0, QModelIndex() );
161  mLineEdit->setText( mModel->data( modelIndex, QgsFeatureFilterModel::ValueRole ).toString() );
162  }
163  }
164 }
165 
167 {
168  return mModel->identifierField();
169 }
170 
172 {
173  mModel->setIdentifierField( identifierField );
174 }
175 
177 {
178  return mModel->index( mModel->extraIdentifierValueIndex(), 0, QModelIndex() );
179 }
180 
181 void QgsFeatureListComboBox::focusOutEvent( QFocusEvent *event )
182 {
183  Q_UNUSED( event )
184  QComboBox::focusOutEvent( event );
185  mLineEdit->setText( mModel->data( currentModelIndex(), QgsFeatureFilterModel::ValueRole ).toString() );
186 }
187 
189 {
190  if ( event->key() == Qt::Key_Escape )
191  {
192  mLineEdit->setText( mModel->data( currentModelIndex(), QgsFeatureFilterModel::ValueRole ).toString() );
193  }
194  QComboBox::keyReleaseEvent( event );
195 }
196 
198 {
199  return mModel->allowNull();
200 }
201 
203 {
204  mModel->setAllowNull( allowNull );
205 }
206 
208 {
209  return mModel->extraIdentifierValue();
210 }
211 
213 {
214  mModel->setExtraIdentifierValue( identifierValue );
215 }
216 
218 {
219  if ( mModel->extraIdentifierValue().isNull() )
220  return QgsFeatureRequest().setFilterFids( QgsFeatureIds() ); // NULL: Return a request that's guaranteed to not return anything
221  else
222  return QgsFeatureRequest().setFilterExpression( QStringLiteral( "%1 = %2" ).arg( QgsExpression::quotedColumnRef( mModel->identifierField() ), QgsExpression::quotedValue( mModel->extraIdentifierValue() ) ) );
223 }
224 
226 {
227  return mModel->filterExpression();
228 }
229 
231 {
232  mModel->setFilterExpression( filterExpression );
233 }
234 
235 void QgsFeatureListComboBox::LineEditState::store( QLineEdit *lineEdit )
236 {
237  text = lineEdit->text();
238  selectionStart = lineEdit->selectionStart();
239  selectionLength = lineEdit->selectedText().length();
240  cursorPosition = lineEdit->cursorPosition();
241 
242 }
243 
244 void QgsFeatureListComboBox::LineEditState::restore( QLineEdit *lineEdit ) const
245 {
246  lineEdit->setText( text );
247  lineEdit->setCursorPosition( cursorPosition );
248  if ( selectionStart > -1 )
249  lineEdit->setSelection( selectionStart, selectionLength );
250 }
void setIdentifierValue(const QVariant &identifierValue)
The identifier value of the currently selected feature.
QString identifierField() const
Field name that will be used to uniquely identify the current feature.
Provides a list of features based on filter conditions.
This offers a combobox with autocompleter that allows selecting features from a layer.
QgsFeatureRequest currentFeatureRequest() const
Shorthand for getting a feature request to query the currently selected feature.
QModelIndex currentModelIndex() const
The index of the currently selected item.
int nullIndex() const
Returns the current index of the NULL value, or -1 if NULL values are not allowed.
void setSelectOnFocus(bool selectOnFocus)
Will select all text when this widget receives the focus.
static QString quotedColumnRef(QString name)
Returns a quoted column reference (in double quotes)
void beginUpdate()
Notification that the model is about to be changed because a job was completed.
Used to retrieve the displayExpression of a feature.
QSet< QgsFeatureId > QgsFeatureIds
Definition: qgsfeature.h:544
void identifierFieldChanged()
Field name that will be used to uniquely identify the current feature.
void setFilterExpression(const QString &filterExpression)
An additional filter expression to apply, next to the filterValue.
QString filterExpression() const
An additional expression to further restrict the available features.
void setShowSpinner(bool showSpinner)
Show a spinner icon.
void displayExpressionChanged()
The display expression will be used to display features as well as the the value to match the typed t...
void filterJobCompleted()
Indicates that a filter job has been completed and new data may be available.
void extraIdentifierValueIndexChanged(int index)
The index at which the extra identifier value is available within the model.
void setSourceLayer(QgsVectorLayer *sourceLayer)
The layer from which features should be listed.
void filterExpressionChanged()
An additional expression to further restrict the available features.
QgsVectorLayer * sourceLayer() const
The layer from which features should be listed.
QgsFeatureRequest & setFilterExpression(const QString &expression)
Set the filter expression.
void identifierFieldChanged()
The identifier field should be a unique field that can be used to identify individual features...
void setAllowNull(bool allowNull)
Determines if a NULL value should be available in the list.
QString displayExpression() const
The display expression will be used to display features as well as the the value to match the typed t...
QgsFeatureListComboBox(QWidget *parent=nullptr)
Create a new QgsFeatureListComboBox, optionally specifying a parent.
void setFilterValue(const QString &filterValue)
This value will be used to filter the features available from this model.
QModelIndex index(int row, int column, const QModelIndex &parent) const override
QString identifierField
A field of sourceLayer that is unique and should be used to identify features.
This class wraps a request for features to a vector layer (or directly its vector data provider)...
QLineEdit subclass with built in support for clearing the widget&#39;s value and handling custom null val...
QVariant extraIdentifierValue
The value that identifies the current feature.
void identifierValueChanged()
The identifier value of the currently selected feature.
void isLoadingChanged()
Indicator if the model is currently performing any feature iteration in the background.
void allowNullChanged()
Add a NULL entry to the list.
void filterExpressionChanged()
An additional filter expression to apply, next to the filterValue.
void endUpdate()
Notification that the model change is finished.
void extraIdentifierValueChanged()
Allows specifying one value that does not need to match the filter criteria but will still be availab...
void setIdentifierField(const QString &identifierField)
The identifier field should be a unique field that can be used to identify individual features...
void setSourceLayer(QgsVectorLayer *sourceLayer)
The source layer from which features will be fetched.
void setFilterExpression(const QString &filterExpression)
An additional expression to further restrict the available features.
void sourceLayerChanged()
The source layer from which features will be fetched.
QgsFeatureRequest & setFilterFids(const QgsFeatureIds &fids)
Sets feature IDs that should be fetched.
void allowNullChanged()
Determines if a NULL value should be available in the list.
void keyPressEvent(QKeyEvent *event) override
void setExtraIdentifierValue(const QVariant &extraIdentifierValue)
Allows specifying one value that does not need to match the filter criteria but will still be availab...
void sourceLayerChanged()
The layer from which features should be listed.
void focusOutEvent(QFocusEvent *event) override
QVariant data(const QModelIndex &index, int role) const override
void setAllowNull(bool allowNull)
Add a NULL entry to the list.
QVariant identifierValue() const
The identifier value of the currently selected feature.
static QString quotedValue(const QVariant &value)
Returns a string representation of a literal value, including appropriate quotations where required...
Used to retrieve the identifierValue (primary key) of a feature.
void setDisplayExpression(const QString &displayExpression)
The display expression will be used for.
Represents a vector layer which manages a vector based data sets.
void setDisplayExpression(const QString &displayExpression)
The display expression will be used to display features as well as the the value to match the typed t...
void modelUpdated()
The underlying model has been updated.
void setIdentifierField(const QString &identifierField)
Field name that will be used to uniquely identify the current feature.
bool allowNull() const
Determines if a NULL value should be available in the list.
void displayExpressionChanged()
The display expression will be used for.