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 );
255 if ( features == mMaximumNumberOfFeatures )
260 mMaximumNumberOfFeatures = features;
267 if ( uniqueOnly == mShowUniqueRowsOnly )
272 mShowUniqueRowsOnly = uniqueOnly;
279 if ( visibleOnly == mShowOnlyVisibleFeatures )
284 mShowOnlyVisibleFeatures = visibleOnly;
291 if ( filterToAtlas == mFilterToAtlasIntersection )
296 mFilterToAtlasIntersection = filterToAtlas;
303 if ( filter == mFilterFeatures )
308 mFilterFeatures = filter;
315 if ( expression == mFeatureFilter )
320 mFeatureFilter = expression;
339 if ( !fields.isEmpty() )
341 for (
const QString &field : fields )
348 std::unique_ptr< QgsLayoutTableColumn > col = qgis::make_unique< QgsLayoutTableColumn >();
349 col->setAttribute( layerFields.
at( attrIdx ).
name() );
350 col->setHeading( currentAlias );
358 for (
const QgsField &field : layerFields )
361 std::unique_ptr< QgsLayoutTableColumn > col = qgis::make_unique< QgsLayoutTableColumn >();
362 col->setAttribute( field.name() );
363 col->setHeading( currentAlias );
375 void QgsLayoutItemAttributeTable::restoreFieldAliasMap(
const QMap<int, QString> &
map )
386 if ( map.contains( attrIdx ) )
388 column->setHeading( map.value( attrIdx ) );
414 std::unique_ptr<QgsExpression> filterExpression;
415 bool activeFilter =
false;
416 if ( mFilterFeatures && !mFeatureFilter.isEmpty() )
418 filterExpression = qgis::make_unique< QgsExpression >( mFeatureFilter );
419 if ( !filterExpression->hasParserError() )
429 std::unique_ptr< QgsGeometryEngine > visibleMapEngine;
430 if ( mMap && mShowOnlyVisibleFeatures )
450 visibleMapEngine->prepareGeometry();
454 std::unique_ptr< QgsGeometryEngine > atlasGeometryEngine;
455 if ( mFilterToAtlasIntersection )
457 atlasGeometry =
mLayout->reportContext().currentGeometry( layer->
crs() );
458 if ( !atlasGeometry.
isNull() )
460 if ( selectionRect.
isNull() )
470 atlasGeometryEngine->prepareGeometry();
476 QgsRelation relation =
mLayout->project()->relationManager()->relation( mRelationId );
481 if ( !selectionRect.
isEmpty() )
497 while ( fit.
nextFeature( f ) && counter < mMaximumNumberOfFeatures )
501 if ( activeFilter && filterExpression )
503 QVariant result = filterExpression->evaluate( &context );
505 if ( !result.toBool() )
512 if ( visibleMapEngine )
522 if ( mFilterToAtlasIntersection )
534 currentRow.reserve(
mColumns.count() );
541 currentRow << replaceWrapChar( f.
attributes().at( idx ) );
546 std::unique_ptr< QgsExpression > expression = qgis::make_unique< QgsExpression >( column->attribute() );
548 expression->prepare( &context );
549 QVariant value = expression->evaluate( &context );
556 contents << currentRow;
562 QgsLayoutAttributeTableCompare
c;
564 for (
int i = sortColumns.size() - 1; i >= 0; --i )
566 c.setSortColumn( sortColumns.at( i ).first );
567 c.setAscending( sortColumns.at( i ).second );
568 std::stable_sort( contents.begin(), contents.end(),
c );
590 if ( !mMap && !mMapUuid.isEmpty() &&
mLayout )
609 mDataDefinedVectorLayer =
nullptr;
611 QString currentLayerIdentifier;
613 currentLayerIdentifier = currentLayer->id();
618 mDataDefinedVectorLayer = ddLayer;
624 QVariant QgsLayoutItemAttributeTable::replaceWrapChar(
const QVariant &variant )
const 627 if ( mWrapString.isEmpty() || !variant.toString().contains( mWrapString ) )
630 QString replaced = variant.toString();
631 replaced.replace( mWrapString, QLatin1String(
"\n" ) );
640 return mLayout->reportContext().layer();
643 if ( mDataDefinedVectorLayer )
644 return mDataDefinedVectorLayer;
646 return mVectorLayer.
get();
650 QgsRelation relation =
mLayout->project()->relationManager()->relation( mRelationId );
657 void QgsLayoutItemAttributeTable::removeLayer(
const QString &layerId )
661 if ( layerId == mVectorLayer->
id() )
671 static bool columnsBySortRank( QPair<int, QgsLayoutTableColumn * > a, QPair<int, QgsLayoutTableColumn * > b )
673 return a.second->sortByRank() < b.second->sortByRank();
679 QVector< QPair<int, QgsLayoutTableColumn * > > sortedColumns;
683 if ( column->sortByRank() > 0 )
685 sortedColumns.append( qMakePair( idx, column ) );
691 std::sort( sortedColumns.begin(), sortedColumns.end(), columnsBySortRank );
694 QVector<QPair<int, bool> > attributesBySortRank;
695 attributesBySortRank.reserve( sortedColumns.size() );
696 for (
auto &column : qgis::as_const( sortedColumns ) )
698 attributesBySortRank.append( qMakePair( column.first,
699 column.second->sortOrder() == Qt::AscendingOrder ) );
701 return attributesBySortRank;
706 if ( wrapString == mWrapString )
721 tableElem.setAttribute( QStringLiteral(
"source" ), QString::number( static_cast< int >( mSource ) ) );
722 tableElem.setAttribute( QStringLiteral(
"relationId" ), mRelationId );
723 tableElem.setAttribute( QStringLiteral(
"showUniqueRowsOnly" ), mShowUniqueRowsOnly );
724 tableElem.setAttribute( QStringLiteral(
"showOnlyVisibleFeatures" ), mShowOnlyVisibleFeatures );
725 tableElem.setAttribute( QStringLiteral(
"filterToAtlasIntersection" ), mFilterToAtlasIntersection );
726 tableElem.setAttribute( QStringLiteral(
"maxFeatures" ), mMaximumNumberOfFeatures );
727 tableElem.setAttribute( QStringLiteral(
"filterFeatures" ), mFilterFeatures ? QStringLiteral(
"true" ) : QStringLiteral(
"false" ) );
728 tableElem.setAttribute( QStringLiteral(
"featureFilter" ), mFeatureFilter );
729 tableElem.setAttribute( QStringLiteral(
"wrapString" ), mWrapString );
733 tableElem.setAttribute( QStringLiteral(
"mapUuid" ), mMap->
uuid() );
738 tableElem.setAttribute( QStringLiteral(
"vectorLayer" ), mVectorLayer.
layerId );
739 tableElem.setAttribute( QStringLiteral(
"vectorLayerName" ), mVectorLayer.
name );
740 tableElem.setAttribute( QStringLiteral(
"vectorLayerSource" ), mVectorLayer.
source );
741 tableElem.setAttribute( QStringLiteral(
"vectorLayerProvider" ), mVectorLayer.
provider );
759 mRelationId = itemElem.attribute( QStringLiteral(
"relationId" ), QString() );
763 mCurrentAtlasLayer =
mLayout->reportContext().layer();
766 mShowUniqueRowsOnly = itemElem.attribute( QStringLiteral(
"showUniqueRowsOnly" ), QStringLiteral(
"0" ) ).toInt();
767 mShowOnlyVisibleFeatures = itemElem.attribute( QStringLiteral(
"showOnlyVisibleFeatures" ), QStringLiteral(
"1" ) ).toInt();
768 mFilterToAtlasIntersection = itemElem.attribute( QStringLiteral(
"filterToAtlasIntersection" ), QStringLiteral(
"0" ) ).toInt();
769 mFilterFeatures = itemElem.attribute( QStringLiteral(
"filterFeatures" ), QStringLiteral(
"false" ) ) == QLatin1String(
"true" );
770 mFeatureFilter = itemElem.attribute( QStringLiteral(
"featureFilter" ), QString() );
771 mMaximumNumberOfFeatures = itemElem.attribute( QStringLiteral(
"maxFeatures" ), QStringLiteral(
"5" ) ).toInt();
772 mWrapString = itemElem.attribute( QStringLiteral(
"wrapString" ) );
775 mMapUuid = itemElem.attribute( QStringLiteral(
"mapUuid" ) );
785 QString layerId = itemElem.attribute( QStringLiteral(
"vectorLayer" ) );
786 QString layerName = itemElem.attribute( QStringLiteral(
"vectorLayerName" ) );
787 QString layerSource = itemElem.attribute( QStringLiteral(
"vectorLayerSource" ) );
788 QString layerProvider = itemElem.attribute( QStringLiteral(
"vectorLayerProvider" ) );
789 mVectorLayer =
QgsVectorLayerRef( layerId, layerName, layerSource, layerProvider );
803 if ( source == mSource )
812 if ( newLayer != prevLayer )
824 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.
QgsExpressionContext createExpressionContext() const override
Creates an expression context relating to the objects' current state.
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.
Reads and writes project states.
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
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...