QGIS API Documentation 3.37.0-Master (fdefdf9c27f)
qgsdualview.h
Go to the documentation of this file.
1/***************************************************************************
2 qgsdualview.h
3 --------------------------------------
4 Date : 10.2.2013
5 Copyright : (C) 2013 Matthias Kuhn
6 Email : matthias at opengis dot ch
7 ***************************************************************************
8 * *
9 * This program is free software; you can redistribute it and/or modify *
10 * it under the terms of the GNU General Public License as published by *
11 * the Free Software Foundation; either version 2 of the License, or *
12 * (at your option) any later version. *
13 * *
14 ***************************************************************************/
15
16#ifndef QGSDUALVIEW_H
17#define QGSDUALVIEW_H
18
19#include <QStackedWidget>
20
21#include "ui_qgsdualviewbase.h"
22
25#include "qgsattributeform.h"
26#include "qgis_gui.h"
27
28#include <QPointer>
29#include <QUuid>
30
33class QgsScrollArea;
35
44class GUI_EXPORT QgsDualView : public QStackedWidget, private Ui::QgsDualViewBase
45{
46 Q_OBJECT
47
48 public:
49
56 {
57
61 AttributeTable = 0,
62
68 AttributeEditor = 1
69 };
70 Q_ENUM( ViewMode )
71
72
73
75 {
76 NoAction = 0,
79 };
80 Q_ENUM( FeatureListBrowsingAction )
81
82
86 explicit QgsDualView( QWidget *parent SIP_TRANSFERTHIS = nullptr );
87 ~QgsDualView() override;
88
101 void init( QgsVectorLayer *layer,
102 QgsMapCanvas *mapCanvas,
103 const QgsFeatureRequest &request = QgsFeatureRequest(),
105 bool loadFeatures = true, bool showFirstFeature = true );
106
113 void setView( ViewMode view );
114
119 ViewMode view() const;
120
126 void setFilterMode( QgsAttributeTableFilterModel::FilterMode filterMode );
127
133 QgsAttributeTableFilterModel::FilterMode filterMode() { return mFilterModel->filterMode(); }
134
141 void setSelectedOnTop( bool selectedOnTop );
142
148 int featureCount();
149
156 int filteredFeatureCount();
157
165 Q_DECL_DEPRECATED void setFilteredFeatures( const QgsFeatureIds &filteredFeatures );
166
173 void filterFeatures( const QgsExpression &filterExpression, const QgsExpressionContext &context );
174
178 QgsFeatureIds filteredFeatures() { return mFilterModel->filteredFeatures(); }
179
185 QgsAttributeTableModel *masterModel() const { return mMasterModel; }
186
192 void setRequest( const QgsFeatureRequest &request );
193
199 void setFeatureSelectionManager( QgsIFeatureSelectionManager *featureSelectionManager );
200
206 QgsAttributeTableView *tableView() { return mTableView; }
207
212 void setAttributeTableConfig( const QgsAttributeTableConfig &config );
213
217 void setSortExpression( const QString &sortExpression, Qt::SortOrder sortOrder = Qt::AscendingOrder );
218
222 QString sortExpression() const;
223
228 QgsAttributeTableConfig attributeTableConfig() const;
229
235 static QgsAttributeList requiredAttributes( const QgsVectorLayer *layer );
236
237 public slots:
238
244 void setCurrentEditSelection( const QgsFeatureIds &fids );
245
252 bool saveEditChanges();
253
254 void openConditionalStyles();
255
259 void setMultiEditEnabled( bool enabled );
260
265 void toggleSearchMode( bool enabled );
266
270 void copyCellContent() const;
271
275 void cancelProgress( );
276
285 void parentFormValueChanged( const QString &attribute, const QVariant &value );
286
287 signals:
288
293 void displayExpressionChanged( const QString &expression );
294
299
305 void filterExpressionSet( const QString &expression, QgsAttributeForm::FilterType type );
306
312
319
320 protected:
321 void hideEvent( QHideEvent *event ) override;
322
323 private slots:
324
325 void featureListAboutToChangeEditSelection( bool &ok );
326
332 void featureListCurrentEditSelectionChanged( const QgsFeature &feat );
333
334 void previewExpressionBuilder();
335
336 void previewColumnChanged( QAction *previewAction, const QString &expression );
337
338 void viewWillShowContextMenu( QMenu *menu, const QModelIndex &atIndex );
339
340 void widgetWillShowContextMenu( QgsActionMenu *menu, const QModelIndex &atIndex );
341
342 void showViewHeaderMenu( QPoint point );
343
344 void organizeColumns();
345
346 void tableColumnResized( int column, int width );
347
348 void hideColumn();
349
350 void resizeColumn();
351
352 void resizeAllColumns();
353
354 void autosizeColumn();
355
356 void autosizeAllColumns();
357
358 void previewExpressionChanged( const QString &expression );
359
360 void onSortColumnChanged();
361
362 void updateSelectedFeatures();
363 void updateEditedAddedFeatures();
364
365 void extentChanged();
366
372 void featureFormAttributeChanged( const QString &attribute, const QVariant &value, bool attributeChanged );
373
380 virtual void progress( int i, bool &cancel );
381
386 virtual void finished();
387
389 void zoomToCurrentFeature();
391 void panToCurrentFeature();
392
393 void flashCurrentFeature();
394
395 void rebuildFullLayerCache();
396
397 void panZoomGroupButtonToggled( QAbstractButton *button, bool checked );
398
399 void flashButtonClicked( bool clicked );
400
401 void filterError( const QString &errorMessage );
402
403 private:
404
410 void initAttributeForm( const QgsFeature &feature );
411
415 void columnBoxInit();
416 void initLayerCache( bool cacheGeometry );
417 void initModels( QgsMapCanvas *mapCanvas, const QgsFeatureRequest &request, bool loadFeatures );
418 void restoreRecentDisplayExpressions();
419 void saveRecentDisplayExpressions() const;
420 void setDisplayExpression( const QString &expression );
421 void insertRecentlyUsedDisplayExpression( const QString &expression );
422 void updateEditSelectionProgress( int progress, int count );
423 void panOrZoomToFeature( const QgsFeatureIds &featureset );
425 void setBrowsingAutoPanScaleAllowed( bool allowed );
426
428 bool modifySort();
429
430 QgsFieldConditionalFormatWidget *mConditionalFormatWidget = nullptr;
431 QgsAttributeEditorContext mEditorContext;
432 QgsAttributeTableModel *mMasterModel = nullptr;
433 QgsAttributeTableFilterModel *mFilterModel = nullptr;
434 QgsFeatureListModel *mFeatureListModel = nullptr;
435 QgsAttributeForm *mAttributeForm = nullptr;
436 QMenu *mPreviewColumnsMenu = nullptr;
437 QMenu *mPreviewActionMenu = nullptr;
438 QAction *mLastDisplayExpressionAction = nullptr;
439 QMenu *mHorizontalHeaderMenu = nullptr;
440 QgsVectorLayerCache *mLayerCache = nullptr;
441 QPointer< QgsVectorLayer > mLayer = nullptr;
442 QProgressDialog *mProgressDlg = nullptr;
443 QgsIFeatureSelectionManager *mFeatureSelectionManager = nullptr;
444 QString mDisplayExpression;
446 QgsScrollArea *mAttributeEditorScrollArea = nullptr;
447 QgsFeatureIds mLastFeatureSet;
448 bool mBrowsingAutoPanScaleAllowed = true;
449 ViewMode mPreviousView = AttributeTable;
450
451 friend class TestQgsDualView;
452 friend class TestQgsAttributeTable;
453};
454
459class GUI_EXPORT QgsAttributeTableAction : public QAction
460{
461 Q_OBJECT
462
463 public:
464
469 QgsAttributeTableAction( const QString &name, QgsDualView *dualView, QUuid action, const QModelIndex &fieldIdx )
470 : QAction( name, dualView )
471 , mDualView( dualView )
472 , mAction( action )
473 , mFieldIdx( fieldIdx )
474 {}
475
476 public slots:
477 void execute();
478 void featureForm();
479
480 private:
481 QgsDualView *mDualView = nullptr;
482 QUuid mAction;
483 QModelIndex mFieldIdx;
484};
485
490class GUI_EXPORT QgsAttributeTableMapLayerAction : public QAction
491{
492 Q_OBJECT
493
494 public:
495 QgsAttributeTableMapLayerAction( const QString &name, QgsDualView *dualView, QgsMapLayerAction *action, const QModelIndex &fieldIdx )
496 : QAction( name, dualView )
497 , mDualView( dualView )
498 , mAction( action )
499 , mFieldIdx( fieldIdx )
500 {}
501
502 public slots:
503 void execute();
504
505 private:
506 QgsDualView *mDualView = nullptr;
507 QgsMapLayerAction *mAction = nullptr;
508 QModelIndex mFieldIdx;
509};
510
511Q_DECLARE_METATYPE( QModelIndex );
512
513#endif // QGSDUALVIEW_H
This class is a menu that is populated automatically with the actions defined for a given layer.
Definition: qgsactionmenu.h:39
This class contains context information for attribute editor widgets.
FilterType
Filter types.
QgsAttributeTableAction(const QString &name, QgsDualView *dualView, QUuid action, const QModelIndex &fieldIdx)
Create a new attribute table action.
Definition: qgsdualview.h:469
This is a container for configuration of the attribute table.
FilterMode
The filter mode defines how the rows should be filtered.
QgsAttributeTableMapLayerAction(const QString &name, QgsDualView *dualView, QgsMapLayerAction *action, const QModelIndex &fieldIdx)
Definition: qgsdualview.h:495
A model backed by a QgsVectorLayerCache which is able to provide feature/attribute information to a Q...
Provides a table view of features of a QgsVectorLayer.
This widget is used to show the attributes of a set of features of a QgsVectorLayer.
Definition: qgsdualview.h:45
void showContextMenuExternally(QgsActionMenu *menu, QgsFeatureId fid)
Emitted when selecting context menu on the feature list to create the context menu individually.
ViewMode
The view modes, in which this widget can present information.
Definition: qgsdualview.h:56
QgsAttributeTableFilterModel::FilterMode filterMode()
Gets the filter mode.
Definition: qgsdualview.h:133
QgsFeatureIds filteredFeatures()
Gets a list of currently visible feature ids.
Definition: qgsdualview.h:178
void filterChanged()
Emitted whenever the filter changes.
QgsAttributeTableView * tableView()
Returns the table view.
Definition: qgsdualview.h:206
void formModeChanged(QgsAttributeEditorContext::Mode mode)
Emitted when the form changes mode.
FeatureListBrowsingAction
Action on the map canvas when browsing the list of features.
Definition: qgsdualview.h:75
@ PanToFeature
The map is panned to the center of the feature bounding-box.
Definition: qgsdualview.h:77
@ ZoomToFeature
The map is zoomed to contained the feature bounding-box.
Definition: qgsdualview.h:78
void filterExpressionSet(const QString &expression, QgsAttributeForm::FilterType type)
Emitted when a filter expression is set using the view.
void displayExpressionChanged(const QString &expression)
Emitted whenever the display expression is successfully changed.
QgsAttributeTableModel * masterModel() const
Returns the model which has the information about all features (not only filtered)
Definition: qgsdualview.h:185
Expression contexts are used to encapsulate the parameters around which a QgsExpression should be eva...
Class for parsing and evaluation of expressions (formerly called "search strings").
This class wraps a request for features to a vector layer (or directly its vector data provider).
The feature class encapsulates a single feature including its unique ID, geometry and a list of field...
Definition: qgsfeature.h:56
A widget for customizing conditional formatting options.
Is an interface class to abstract feature selection handling.
Map canvas is a class for displaying all GIS data types on a canvas.
Definition: qgsmapcanvas.h:93
An action which can run on map layers The class can be used in two manners:
A QScrollArea subclass with improved scrolling behavior.
Definition: qgsscrollarea.h:41
This class caches features of a given QgsVectorLayer.
Represents a vector layer which manages a vector based data sets.
#define SIP_TRANSFERTHIS
Definition: qgis_sip.h:53
Q_DECLARE_METATYPE(QModelIndex)
QSet< QgsFeatureId > QgsFeatureIds
Definition: qgsfeatureid.h:37
qint64 QgsFeatureId
64 bit feature ids negative numbers are used for uncommitted/newly added features
Definition: qgsfeatureid.h:28
QList< int > QgsAttributeList
Definition: qgsfield.h:27