41 class CORE_EXPORT QgsLayoutAttributeTableCompare
48 QgsLayoutAttributeTableCompare() =
default;
51 return ( mAscending ?
qgsVariantLessThan( m1[mCurrentSortColumn], m2[mCurrentSortColumn] )
58 void setSortColumn(
int column ) { mCurrentSortColumn = column; }
64 void setAscending(
bool ascending ) { mAscending = ascending; }
67 int mCurrentSortColumn = 0;
68 bool mAscending =
true;
107 return tr(
"<Attribute table frame>" );
112 if ( layer == mVectorLayer.
get() )
142 if ( relationId == mRelationId )
150 QgsRelation relation =
mLayout->project()->relationManager()->relation( mRelationId );
172 void QgsLayoutItemAttributeTable::atlasLayerChanged(
QgsVectorLayer *layer )
181 if ( mCurrentAtlasLayer )
187 const bool mustRebuildColumns =
static_cast< bool >( mCurrentAtlasLayer ) ||
mColumns.empty();
188 mCurrentAtlasLayer = layer;
190 if ( mustRebuildColumns )
217 for (
const auto &field : sourceFields )
220 std::unique_ptr< QgsLayoutTableColumn > col = qgis::make_unique< QgsLayoutTableColumn >();
221 col->setAttribute( field.name() );
222 col->setHeading( currentAlias );
228 void QgsLayoutItemAttributeTable::disconnectCurrentMap()
237 disconnect( mMap, &QObject::destroyed,
this, &QgsLayoutItemAttributeTable::disconnectCurrentMap );
248 disconnectCurrentMap();
256 connect( mMap, &QObject::destroyed,
this, &QgsLayoutItemAttributeTable::disconnectCurrentMap );
264 if ( features == mMaximumNumberOfFeatures )
269 mMaximumNumberOfFeatures = features;
276 if ( uniqueOnly == mShowUniqueRowsOnly )
281 mShowUniqueRowsOnly = uniqueOnly;
288 if ( visibleOnly == mShowOnlyVisibleFeatures )
293 mShowOnlyVisibleFeatures = visibleOnly;
300 if ( filterToAtlas == mFilterToAtlasIntersection )
305 mFilterToAtlasIntersection = filterToAtlas;
312 if ( filter == mFilterFeatures )
317 mFilterFeatures = filter;
324 if ( expression == mFeatureFilter )
329 mFeatureFilter = expression;
348 if ( !fields.isEmpty() )
350 for (
const QString &field : fields )
357 std::unique_ptr< QgsLayoutTableColumn > col = qgis::make_unique< QgsLayoutTableColumn >();
358 col->setAttribute( layerFields.
at( attrIdx ).
name() );
359 col->setHeading( currentAlias );
367 for (
const QgsField &field : layerFields )
370 std::unique_ptr< QgsLayoutTableColumn > col = qgis::make_unique< QgsLayoutTableColumn >();
371 col->setAttribute( field.name() );
372 col->setHeading( currentAlias );
384 void QgsLayoutItemAttributeTable::restoreFieldAliasMap(
const QMap<int, QString> &
map )
395 if ( map.contains( attrIdx ) )
397 column->setHeading( map.value( attrIdx ) );
423 std::unique_ptr<QgsExpression> filterExpression;
424 bool activeFilter =
false;
425 if ( mFilterFeatures && !mFeatureFilter.isEmpty() )
427 filterExpression = qgis::make_unique< QgsExpression >( mFeatureFilter );
428 if ( !filterExpression->hasParserError() )
438 std::unique_ptr< QgsGeometryEngine > visibleMapEngine;
439 if ( mMap && mShowOnlyVisibleFeatures )
459 visibleMapEngine->prepareGeometry();
463 std::unique_ptr< QgsGeometryEngine > atlasGeometryEngine;
464 if ( mFilterToAtlasIntersection )
466 atlasGeometry =
mLayout->reportContext().currentGeometry( layer->
crs() );
467 if ( !atlasGeometry.
isNull() )
469 if ( selectionRect.
isNull() )
479 atlasGeometryEngine->prepareGeometry();
485 QgsRelation relation =
mLayout->project()->relationManager()->relation( mRelationId );
490 if ( !selectionRect.
isEmpty() )
506 while ( fit.
nextFeature( f ) && counter < mMaximumNumberOfFeatures )
510 if ( activeFilter && filterExpression )
512 QVariant result = filterExpression->evaluate( &context );
514 if ( !result.toBool() )
521 if ( visibleMapEngine )
531 if ( mFilterToAtlasIntersection )
543 currentRow.reserve(
mColumns.count() );
550 currentRow << replaceWrapChar( f.
attributes().at( idx ) );
555 std::unique_ptr< QgsExpression > expression = qgis::make_unique< QgsExpression >( column->attribute() );
557 expression->prepare( &context );
558 QVariant value = expression->evaluate( &context );
565 contents << currentRow;
571 QgsLayoutAttributeTableCompare
c;
573 for (
int i = sortColumns.size() - 1; i >= 0; --i )
575 c.setSortColumn( sortColumns.at( i ).first );
576 c.setAscending( sortColumns.at( i ).second );
577 std::stable_sort( contents.begin(), contents.end(),
c );
599 if ( !mMap && !mMapUuid.isEmpty() &&
mLayout )
618 mDataDefinedVectorLayer =
nullptr;
620 QString currentLayerIdentifier;
622 currentLayerIdentifier = currentLayer->id();
627 mDataDefinedVectorLayer = ddLayer;
633 QVariant QgsLayoutItemAttributeTable::replaceWrapChar(
const QVariant &variant )
const 636 if ( mWrapString.isEmpty() || !variant.toString().contains( mWrapString ) )
639 QString replaced = variant.toString();
640 replaced.replace( mWrapString, QLatin1String(
"\n" ) );
649 return mLayout->reportContext().layer();
652 if ( mDataDefinedVectorLayer )
653 return mDataDefinedVectorLayer;
655 return mVectorLayer.
get();
659 QgsRelation relation =
mLayout->project()->relationManager()->relation( mRelationId );
666 void QgsLayoutItemAttributeTable::removeLayer(
const QString &layerId )
670 if ( layerId == mVectorLayer->
id() )
680 static bool columnsBySortRank( QPair<int, QgsLayoutTableColumn * > a, QPair<int, QgsLayoutTableColumn * > b )
682 return a.second->sortByRank() < b.second->sortByRank();
688 QVector< QPair<int, QgsLayoutTableColumn * > > sortedColumns;
692 if ( column->sortByRank() > 0 )
694 sortedColumns.append( qMakePair( idx, column ) );
700 std::sort( sortedColumns.begin(), sortedColumns.end(), columnsBySortRank );
703 QVector<QPair<int, bool> > attributesBySortRank;
704 attributesBySortRank.reserve( sortedColumns.size() );
705 for (
auto &column : qgis::as_const( sortedColumns ) )
707 attributesBySortRank.append( qMakePair( column.first,
708 column.second->sortOrder() == Qt::AscendingOrder ) );
710 return attributesBySortRank;
715 if ( wrapString == mWrapString )
730 tableElem.setAttribute( QStringLiteral(
"source" ), QString::number( static_cast< int >( mSource ) ) );
731 tableElem.setAttribute( QStringLiteral(
"relationId" ), mRelationId );
732 tableElem.setAttribute( QStringLiteral(
"showUniqueRowsOnly" ), mShowUniqueRowsOnly );
733 tableElem.setAttribute( QStringLiteral(
"showOnlyVisibleFeatures" ), mShowOnlyVisibleFeatures );
734 tableElem.setAttribute( QStringLiteral(
"filterToAtlasIntersection" ), mFilterToAtlasIntersection );
735 tableElem.setAttribute( QStringLiteral(
"maxFeatures" ), mMaximumNumberOfFeatures );
736 tableElem.setAttribute( QStringLiteral(
"filterFeatures" ), mFilterFeatures ? QStringLiteral(
"true" ) : QStringLiteral(
"false" ) );
737 tableElem.setAttribute( QStringLiteral(
"featureFilter" ), mFeatureFilter );
738 tableElem.setAttribute( QStringLiteral(
"wrapString" ), mWrapString );
742 tableElem.setAttribute( QStringLiteral(
"mapUuid" ), mMap->
uuid() );
747 tableElem.setAttribute( QStringLiteral(
"vectorLayer" ), mVectorLayer.
layerId );
748 tableElem.setAttribute( QStringLiteral(
"vectorLayerName" ), mVectorLayer.
name );
749 tableElem.setAttribute( QStringLiteral(
"vectorLayerSource" ), mVectorLayer.
source );
750 tableElem.setAttribute( QStringLiteral(
"vectorLayerProvider" ), mVectorLayer.
provider );
768 mRelationId = itemElem.attribute( QStringLiteral(
"relationId" ), QString() );
772 mCurrentAtlasLayer =
mLayout->reportContext().layer();
775 mShowUniqueRowsOnly = itemElem.attribute( QStringLiteral(
"showUniqueRowsOnly" ), QStringLiteral(
"0" ) ).toInt();
776 mShowOnlyVisibleFeatures = itemElem.attribute( QStringLiteral(
"showOnlyVisibleFeatures" ), QStringLiteral(
"1" ) ).toInt();
777 mFilterToAtlasIntersection = itemElem.attribute( QStringLiteral(
"filterToAtlasIntersection" ), QStringLiteral(
"0" ) ).toInt();
778 mFilterFeatures = itemElem.attribute( QStringLiteral(
"filterFeatures" ), QStringLiteral(
"false" ) ) == QLatin1String(
"true" );
779 mFeatureFilter = itemElem.attribute( QStringLiteral(
"featureFilter" ), QString() );
780 mMaximumNumberOfFeatures = itemElem.attribute( QStringLiteral(
"maxFeatures" ), QStringLiteral(
"5" ) ).toInt();
781 mWrapString = itemElem.attribute( QStringLiteral(
"wrapString" ) );
784 mMapUuid = itemElem.attribute( QStringLiteral(
"mapUuid" ) );
794 QString layerId = itemElem.attribute( QStringLiteral(
"vectorLayer" ) );
795 QString layerName = itemElem.attribute( QStringLiteral(
"vectorLayerName" ) );
796 QString layerSource = itemElem.attribute( QStringLiteral(
"vectorLayerSource" ) );
797 QString layerProvider = itemElem.attribute( QStringLiteral(
"vectorLayerProvider" ) );
798 mVectorLayer =
QgsVectorLayerRef( layerId, layerName, layerSource, layerProvider );
812 if ( source == mSource )
821 if ( newLayer != prevLayer )
833 mCurrentAtlasLayer = newLayer;
int lookupField(const QString &fieldName) const
Looks up field's index from the field name.
QString displayName() const override
Returns the multiframe display name.
The class is used as a container of context for various read/write operations on other objects...
Wrapper for iterator of features from vector data provider or vector layer.
Single variable definition for use within a QgsExpressionContextScope.
A rectangle specified with double values.
QString relationId() const
Returns the relation id which the table displays child features from.
void setMaximumNumberOfFeatures(int features)
Sets the maximum number of features shown by the table.
OperationResult transform(const QgsCoordinateTransform &ct, QgsCoordinateTransform::TransformDirection direction=QgsCoordinateTransform::ForwardTransform, bool transformZ=false) SIP_THROW(QgsCsException)
Transforms this geometry as described by the coordinate transform ct.
Use exact geometry intersection (slower) instead of bounding boxes.
int type() const override
Returns unique multiframe type id.
A class to display a table in the print layout, and allow the table to span over multiple frames...
void setFeature(const QgsFeature &feature)
Convenience function for setting a feature for the context.
void extentChanged()
Emitted when the map's extent changes.
QgsVectorLayer referencingLayer
bool writePropertiesToElement(QDomElement &elem, QDomDocument &doc, const QgsReadWriteContext &context) const override
Stores multiframe state within an XML DOM element.
TYPE * resolveWeakly(const QgsProject *project)
Resolves the map layer by attempting to find a matching layer in a project using a weak match...
virtual void refreshAttributes()
Refreshes the contents shown in the table by querying for new data.
Container of fields for a vector layer.
A geometry is the spatial representation of a feature.
static QIcon getThemeIcon(const QString &name)
Helper to get a theme icon.
bool readPropertiesFromElement(const QDomElement &itemElem, const QDomDocument &doc, const QgsReadWriteContext &context) override
Sets multiframe state from a DOM element.
Table shows attributes from related child features.
QString wrapString() const
Returns the string used to wrap the contents of the table cells by.
The feature class encapsulates a single feature including its id, geometry and a list of field/values...
bool qgsVariantGreaterThan(const QVariant &lhs, const QVariant &rhs)
Compares two QVariant values and returns whether the first is greater than the second.
bool hasGeometry() const
Returns true if the feature has an associated geometry.
void addVariable(const QgsExpressionContextScope::StaticVariable &variable)
Adds a variable into the context scope.
Table shows attributes from features in a vector layer.
bool qgsVariantLessThan(const QVariant &lhs, const QVariant &rhs)
Compares two QVariant values and returns whether the first is less than the second.
Stores properties of a column for a QgsLayoutTable.
QgsField at(int i) const
Gets field at particular index (must be in range 0..N-1)
void setFilterToAtlasFeature(bool filterToAtlas)
Sets attribute table to only show features which intersect the current atlas feature.
void resetColumns()
Resets the attribute table's columns to match the vector layer's fields.
As part of the API refactoring and improvements which landed in the Processing API was substantially reworked from the x version This was done in order to allow much of the underlying Processing framework to be ported into c
Attribute table source layer.
QgsFeatureRequest & setExpressionContext(const QgsExpressionContext &context)
Sets the expression context used to evaluate filter expressions.
QgsFeatureRequest & setFilterFid(QgsFeatureId fid)
Sets feature ID that should be fetched.
QgsExpressionContextScope * lastScope()
Returns the last scope added to the context.
QgsFeatureRequest & setFilterExpression(const QString &expression)
Set the filter expression.
Layout graphical items for displaying a map.
QString provider
Weak reference to layer provider.
QString layerId
Original layer ID.
QgsPropertyCollection mDataDefinedProperties
QString id() const
Returns the layer's unique ID, which is used to access this layer from QgsProject.
const QgsLayout * layout() const
Returns the layout the object is attached to.
QgsFields fields() const FINAL
Returns the list of fields of this layer.
bool isEmpty() const
Returns true if the rectangle is empty.
Expression contexts are used to encapsulate the parameters around which a QgsExpression should be eva...
QgsRectangle intersect(const QgsRectangle &rect) const
Returns the intersection with the given rectangle.
QString name
Weak reference to layer name.
void setFeatureFilter(const QString &expression)
Sets the expression used for filtering features in the table.
QPointer< QgsLayout > mLayout
QgsVectorLayer * sourceLayer() const
Returns the source layer for the table, considering the table source mode.
This class wraps a request for features to a vector layer (or directly its vector data provider)...
void setFilterFeatures(bool filter)
Sets whether the feature filter is active for the attribute table.
void setDisplayOnlyVisibleFeatures(bool visibleOnly)
Sets the attribute table to only show features which are visible in a map item.
QgsFeatureRequest & setFilterRect(const QgsRectangle &rectangle)
Sets the rectangle from which features will be taken.
Encapsulates a QGIS project, including sets of map layers and their styles, layouts, annotations, canvases, etc.
A layout table subclass that displays attributes from a vector layer.
Table shows attributes from the current atlas feature.
void layerChanged(QgsVectorLayer *layer)
Emitted when the context's layer is changed.
Encapsulate a field in an attribute table or data source.
QgsFeatureRequest getRelatedFeaturesRequest(const QgsFeature &feature) const
Creates a request to return all the features on the referencing (child) layer which have a foreign ke...
virtual void finalizeRestoreFromXml()
Called after all pending items have been restored from XML.
void setLayer(TYPE *l)
Sets the reference to point to a specified layer.
QString source
Weak reference to layer public source.
Base class for layouts, which can contain items such as maps, labels, scalebars, etc.
static QgsMapLayer * mapLayerFromString(const QString &string, QgsProject *project)
Resolves a string into a map layer from a given project.
static QgsLayoutItemAttributeTable * create(QgsLayout *layout)
Returns a new QgsLayoutItemAttributeTable for the specified parent layout.
void setFields(const QgsFields &fields)
Convenience function for setting a fields for the context.
QVector< QPair< int, bool > > sortAttributes() const
Returns the attributes used to sort the table's features.
void setVectorLayer(QgsVectorLayer *layer)
Sets the vector layer from which to display feature attributes.
QPolygonF visibleExtentPolygon() const
Returns a polygon representing the current visible map extent, considering map extents and rotation...
void mapRotationChanged(double newRotation)
Emitted when the map's rotation changes.
QgsExpressionContext createExpressionContext() const override
This method needs to be reimplemented in all classes which implement this interface and return an exp...
void setSource(ContentSource source)
Sets the source for attributes to show in table body.
static QgsGeometryEngine * createGeometryEngine(const QgsAbstractGeometry *geometry)
Creates and returns a new geometry engine.
const QgsAbstractGeometry * constGet() const
Returns a non-modifiable (const) reference to the underlying abstract geometry primitive.
void setDisplayedFields(const QStringList &fields, bool refresh=true)
Sets the attributes to display in the table.
void layerWillBeRemoved(const QString &layerId)
Emitted when a layer is about to be removed from the registry.
QString valueAsString(int key, const QgsExpressionContext &context, const QString &defaultString=QString(), bool *ok=nullptr) const
Calculates the current value of the property with the specified key and interprets it as a string...
QgsLayoutTableColumns mColumns
Columns to show in table.
void setUniqueRowsOnly(bool uniqueOnly)
Sets attribute table to only show unique rows.
void finalizeRestoreFromXml() override
Called after all pending items have been restored from XML.
QgsLayoutTableContents & contents()
Returns the current contents of the table.
bool writePropertiesToElement(QDomElement &elem, QDomDocument &doc, const QgsReadWriteContext &context) const override
Stores multiframe state within an XML DOM element.
QgsCoordinateReferenceSystem crs() const
Returns coordinate reference system used for rendering the map.
QgsLayoutItemAttributeTable(QgsLayout *layout)
Constructor for QgsLayoutItemAttributeTable, attached to the specified layout.
void setWrapString(const QString &wrapString)
Sets a string to wrap the contents of the table cells by.
void appendScope(QgsExpressionContextScope *scope)
Appends a scope to the end of the context.
virtual QString uuid() const
Returns the item identification string.
_LayerRef< QgsVectorLayer > QgsVectorLayerRef
QgsRectangle boundingBox() const
Returns the bounding box of the geometry.
bool isNull() const
Test if the rectangle is null (all coordinates zero or after call to setMinimal()).
static QgsGeometry fromQPolygonF(const QPolygonF &polygon)
Construct geometry from a QPolygonF.
void setRelationId(const QString &id)
Sets the relation id from which to display child features.
void refreshDataDefinedProperty(QgsLayoutObject::DataDefinedProperty property=QgsLayoutObject::AllProperties) override
Refreshes a data defined property for the multi frame by reevaluating the property's value and redraw...
QgsFeatureIterator getFeatures(const QgsFeatureRequest &request=QgsFeatureRequest()) const FINAL
Queries the layer for features specified in request.
void setMap(QgsLayoutItemMap *map)
Sets a layout map to use to limit the extent of features shown in the attribute table.
Custom exception class for Coordinate Reference System related exceptions.
ContentSource
Specifies the content source for the attribute table.
ContentSource source() const
Returns the source for attributes shown in the table body.
QgsLayoutItemMap * map() const
Returns the layout map whose extents are controlling the features shown in the table.
static QgsExpressionContextScope * layerScope(const QgsMapLayer *layer)
Creates a new scope which contains variables and functions relating to a QgsMapLayer.
bool nextFeature(QgsFeature &f)
void changed()
Emitted when the object's properties change.
Represents a vector layer which manages a vector based data sets.
TYPE * get() const
Returns a pointer to the layer, or nullptr if the reference has not yet been matched to a layer...
DataDefinedProperty
Data defined properties for different item types.
bool getTableContents(QgsLayoutTableContents &contents) override
Queries the attribute table's vector layer for attributes to show in the table.
QIcon icon() const override
Returns the item's icon.
void layerModified()
Emitted when modifications has been done on layer.
QString attributeDisplayName(int index) const
Convenience function that returns the attribute alias if defined or the field name else...
bool contentsContainsRow(const QgsLayoutTableContents &contents, const QgsLayoutTableRow &row) const
Checks whether a table contents contains a given row.
QVector< QgsLayoutTableRow > QgsLayoutTableContents
List of QgsLayoutTableRows, representing rows and column cell contents for a QgsLayoutTable.
QgsCoordinateReferenceSystem crs
QgsExpressionContext createExpressionContext() const override
This method needs to be reimplemented in all classes which implement this interface and return an exp...
QgsFeatureRequest & setFlags(QgsFeatureRequest::Flags flags)
Sets flags that affect how features will be fetched.
bool readPropertiesFromElement(const QDomElement &itemElem, const QDomDocument &doc, const QgsReadWriteContext &context) override
Sets multiframe state from a DOM element.
QVector< QVariant > QgsLayoutTableRow
List of QVariants, representing a the contents of a single row in a QgsComposerTable.
void recalculateTableSize()
Recalculates and updates the size of the table and all table frames.
virtual void refreshDataDefinedProperty(QgsLayoutObject::DataDefinedProperty property=QgsLayoutObject::AllProperties)
Refreshes a data defined property for the multi frame by reevaluating the property's value and redraw...