QGIS API Documentation
3.16.0-Hannover (43b64b13f3)
|
Go to the documentation of this file.
69 return tr(
"<Attribute table frame>" );
74 if ( layer == mVectorLayer.
get() )
112 QgsRelation relation =
mLayout->project()->relationManager()->relation( mRelationId );
134 void QgsLayoutItemAttributeTable::atlasLayerChanged(
QgsVectorLayer *layer )
143 if ( mCurrentAtlasLayer )
149 const bool mustRebuildColumns =
static_cast< bool >( mCurrentAtlasLayer ) ||
mColumns.empty();
150 mCurrentAtlasLayer = layer;
152 if ( mustRebuildColumns )
179 for (
const auto &
field : sourceFields )
181 QString currentAlias =
source->attributeDisplayName( idx );
190 void QgsLayoutItemAttributeTable::disconnectCurrentMap()
199 disconnect( mMap, &QObject::destroyed,
this, &QgsLayoutItemAttributeTable::disconnectCurrentMap );
205 return mUseConditionalStyling;
227 disconnectCurrentMap();
235 connect( mMap, &QObject::destroyed,
this, &QgsLayoutItemAttributeTable::disconnectCurrentMap );
243 if ( features == mMaximumNumberOfFeatures )
248 mMaximumNumberOfFeatures = features;
255 if ( uniqueOnly == mShowUniqueRowsOnly )
260 mShowUniqueRowsOnly = uniqueOnly;
267 if ( visibleOnly == mShowOnlyVisibleFeatures )
272 mShowOnlyVisibleFeatures = visibleOnly;
279 if ( filterToAtlas == mFilterToAtlasIntersection )
284 mFilterToAtlasIntersection = filterToAtlas;
291 if ( filter == mFilterFeatures )
296 mFilterFeatures = filter;
303 if ( expression == mFeatureFilter )
308 mFeatureFilter = expression;
326 if ( !fields.isEmpty() )
328 for (
const QString &
field : fields )
334 QString currentAlias =
source->attributeDisplayName( attrIdx );
347 QString currentAlias =
source->attributeDisplayName( idx );
362 void QgsLayoutItemAttributeTable::restoreFieldAliasMap(
const QMap<int, QString> &map )
370 for (
int i = 0; i <
mColumns.count(); i++ )
372 int attrIdx =
source->fields().lookupField(
mColumns[i].attribute() );
373 if (
map.contains( attrIdx ) )
379 mColumns[i].setHeading(
source->attributeDisplayName( attrIdx ) );
404 std::unique_ptr<QgsExpression> filterExpression;
405 bool activeFilter =
false;
406 if ( mFilterFeatures && !mFeatureFilter.isEmpty() )
408 filterExpression = qgis::make_unique< QgsExpression >( mFeatureFilter );
409 if ( !filterExpression->hasParserError() )
418 std::unique_ptr< QgsGeometryEngine > visibleMapEngine;
419 if ( mMap && mShowOnlyVisibleFeatures )
436 visibleMapEngine->prepareGeometry();
440 std::unique_ptr< QgsGeometryEngine > atlasGeometryEngine;
441 if ( mFilterToAtlasIntersection )
443 atlasGeometry =
mLayout->reportContext().currentGeometry( layer->
crs() );
444 if ( !atlasGeometry.
isNull() )
446 if ( selectionRect.
isNull() )
456 atlasGeometryEngine->prepareGeometry();
462 QgsRelation relation =
mLayout->project()->relationManager()->relation( mRelationId );
467 if ( !selectionRect.
isEmpty() )
481 req.
addOrderBy( column.attribute(), column.sortOrder() == Qt::AscendingOrder );
488 mConditionalStyles.clear();
491 QVector< QVector< Cell > > tempContents;
494 while ( fit.
nextFeature( f ) && counter < mMaximumNumberOfFeatures )
498 if ( activeFilter && filterExpression )
500 QVariant result = filterExpression->evaluate( &context );
502 if ( !result.toBool() )
509 if ( visibleMapEngine )
519 if ( mFilterToAtlasIntersection )
532 if ( mUseConditionalStyling )
543 QVector< Cell > currentRow;
544 currentRow.reserve(
mColumns.count() );
546 rowContents.reserve(
mColumns.count() );
556 const QVariant val = f.
attributes().at( idx );
558 if ( mUseConditionalStyling )
562 styles.insert( 0, rowStyle );
566 QVariant v = replaceWrapChar( val );
567 currentRow << Cell( v, style, f );
573 std::unique_ptr< QgsExpression > expression = qgis::make_unique< QgsExpression >( column.attribute() );
575 expression->prepare( &context );
576 QVariant value = expression->evaluate( &context );
578 currentRow << Cell( value, rowStyle, f );
579 rowContents << value;
583 if ( mShowUniqueRowsOnly )
589 tempContents << currentRow;
590 existingContents << rowContents;
595 contents.reserve( tempContents.size() );
596 mConditionalStyles.reserve( tempContents.size() );
597 mFeatures.reserve( tempContents.size() );
598 for (
auto it = tempContents.constBegin(); it != tempContents.constEnd(); ++it )
601 QList< QgsConditionalStyle > rowStyles;
602 row.reserve( it->size() );
603 rowStyles.reserve( it->size() );
605 for (
auto cellIt = it->constBegin(); cellIt != it->constEnd(); ++cellIt )
607 row << cellIt->content;
608 rowStyles << cellIt->style;
609 if ( cellIt == it->constBegin() )
610 mFeatures << cellIt->feature;
613 mConditionalStyles << rowStyles;
622 if ( row >= mConditionalStyles.size() )
625 return mConditionalStyles.at( row ).at( column );
631 scope->setFeature( mFeatures.value( row ) );
632 scope->setFields( scope->feature().fields() );
633 return scope.release();
651 if ( !mMap && !mMapUuid.isEmpty() &&
mLayout )
653 mMap = qobject_cast< QgsLayoutItemMap *>(
mLayout->itemByUuid( mMapUuid,
true ) );
670 mDataDefinedVectorLayer =
nullptr;
672 QString currentLayerIdentifier;
674 currentLayerIdentifier = currentLayer->id();
679 mDataDefinedVectorLayer = ddLayer;
685 QVariant QgsLayoutItemAttributeTable::replaceWrapChar(
const QVariant &variant )
const
688 if ( mWrapString.isEmpty() || !variant.toString().contains( mWrapString ) )
691 QString replaced = variant.toString();
692 replaced.replace( mWrapString, QLatin1String(
"\n" ) );
701 return mLayout->reportContext().layer();
704 if ( mDataDefinedVectorLayer )
705 return mDataDefinedVectorLayer;
707 return mVectorLayer.
get();
711 QgsRelation relation =
mLayout->project()->relationManager()->relation( mRelationId );
718 void QgsLayoutItemAttributeTable::removeLayer(
const QString &layerId )
722 if ( layerId == mVectorLayer->
id() )
748 tableElem.setAttribute( QStringLiteral(
"source" ), QString::number(
static_cast< int >( mSource ) ) );
749 tableElem.setAttribute( QStringLiteral(
"relationId" ), mRelationId );
750 tableElem.setAttribute( QStringLiteral(
"showUniqueRowsOnly" ), mShowUniqueRowsOnly );
751 tableElem.setAttribute( QStringLiteral(
"showOnlyVisibleFeatures" ), mShowOnlyVisibleFeatures );
752 tableElem.setAttribute( QStringLiteral(
"filterToAtlasIntersection" ), mFilterToAtlasIntersection );
753 tableElem.setAttribute( QStringLiteral(
"maxFeatures" ), mMaximumNumberOfFeatures );
754 tableElem.setAttribute( QStringLiteral(
"filterFeatures" ), mFilterFeatures ? QStringLiteral(
"true" ) : QStringLiteral(
"false" ) );
755 tableElem.setAttribute( QStringLiteral(
"featureFilter" ), mFeatureFilter );
756 tableElem.setAttribute( QStringLiteral(
"wrapString" ), mWrapString );
757 tableElem.setAttribute( QStringLiteral(
"useConditionalStyling" ), mUseConditionalStyling );
761 tableElem.setAttribute( QStringLiteral(
"mapUuid" ), mMap->
uuid() );
766 tableElem.setAttribute( QStringLiteral(
"vectorLayer" ), mVectorLayer.
layerId );
767 tableElem.setAttribute( QStringLiteral(
"vectorLayerName" ), mVectorLayer.
name );
768 tableElem.setAttribute( QStringLiteral(
"vectorLayerSource" ), mVectorLayer.
source );
769 tableElem.setAttribute( QStringLiteral(
"vectorLayerProvider" ), mVectorLayer.
provider );
786 mRelationId = itemElem.attribute( QStringLiteral(
"relationId" ), QString() );
790 mCurrentAtlasLayer =
mLayout->reportContext().layer();
793 mShowUniqueRowsOnly = itemElem.attribute( QStringLiteral(
"showUniqueRowsOnly" ), QStringLiteral(
"0" ) ).toInt();
794 mShowOnlyVisibleFeatures = itemElem.attribute( QStringLiteral(
"showOnlyVisibleFeatures" ), QStringLiteral(
"1" ) ).toInt();
795 mFilterToAtlasIntersection = itemElem.attribute( QStringLiteral(
"filterToAtlasIntersection" ), QStringLiteral(
"0" ) ).toInt();
796 mFilterFeatures = itemElem.attribute( QStringLiteral(
"filterFeatures" ), QStringLiteral(
"false" ) ) == QLatin1String(
"true" );
797 mFeatureFilter = itemElem.attribute( QStringLiteral(
"featureFilter" ), QString() );
798 mMaximumNumberOfFeatures = itemElem.attribute( QStringLiteral(
"maxFeatures" ), QStringLiteral(
"5" ) ).toInt();
799 mWrapString = itemElem.attribute( QStringLiteral(
"wrapString" ) );
800 mUseConditionalStyling = itemElem.attribute( QStringLiteral(
"useConditionalStyling" ), QStringLiteral(
"0" ) ).toInt();
803 mMapUuid = itemElem.attribute( QStringLiteral(
"mapUuid" ) );
813 QString layerId = itemElem.attribute( QStringLiteral(
"vectorLayer" ) );
814 QString layerName = itemElem.attribute( QStringLiteral(
"vectorLayerName" ) );
815 QString layerSource = itemElem.attribute( QStringLiteral(
"vectorLayerSource" ) );
816 QString layerProvider = itemElem.attribute( QStringLiteral(
"vectorLayerProvider" ) );
817 mVectorLayer =
QgsVectorLayerRef( layerId, layerName, layerSource, layerProvider );
841 if ( newLayer != prevLayer )
853 mCurrentAtlasLayer = newLayer;
QgsFeatureIterator getFeatures(const QgsFeatureRequest &request=QgsFeatureRequest()) const FINAL
Queries the layer for features specified in request.
void layerWillBeRemoved(const QString &layerId)
Emitted when a layer is about to be removed from the registry.
Expression contexts are used to encapsulate the parameters around which a QgsExpression should be eva...
QgsCoordinateReferenceSystem crs
const QgsLayout * layout() const
Returns the layout the object is attached to.
QgsExpressionContext createExpressionContext() const override
This method needs to be reimplemented in all classes which implement this interface and return an exp...
void setDisplayedFields(const QStringList &fields, bool refresh=true)
Sets the attributes to display in 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.
void setFilterToAtlasFeature(bool filterToAtlas)
Sets attribute table to only show features which intersect the current atlas feature.
static QIcon getThemeIcon(const QString &name)
Helper to get a theme icon.
QgsFeatureRequest & addOrderBy(const QString &expression, bool ascending=true)
Adds a new OrderByClause, appending it as the least important one.
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...
QVector< QgsLayoutTableRow > QgsLayoutTableContents
List of QgsLayoutTableRows, representing rows and column cell contents for a QgsLayoutTable.
TYPE * resolveWeakly(const QgsProject *project, MatchType matchType=MatchType::All)
Resolves the map layer by attempting to find a matching layer in a project using a weak match.
QgsVectorLayer * sourceLayer() const
Returns the source layer for the table, considering the table source mode.
The class is used as a container of context for various read/write operations on other objects.
@ ExactIntersect
Use exact geometry intersection (slower) instead of bounding boxes.
void addVariable(const QgsExpressionContextScope::StaticVariable &variable)
Adds a variable into the context scope.
void layerModified()
Emitted when modifications has been done on layer.
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...
void extentChanged()
Emitted when the map's extent changes.
QgsExpressionContextScope * lastScope()
Returns the last scope added to the context.
Container of fields for a vector layer.
static QgsExpressionContextScope * layerScope(const QgsMapLayer *layer)
Creates a new scope which contains variables and functions relating to a QgsMapLayer.
virtual void finalizeRestoreFromXml()
Called after all pending items have been restored from XML.
QIcon icon() const override
Returns the item's icon.
QString relationId() const
Returns the relation id which the table displays child features from.
QgsPropertyCollection mDataDefinedProperties
void setFilterFeatures(bool filter)
Sets whether the feature filter is active for the attribute table.
void setFields(const QgsFields &fields)
Convenience function for setting a fields for the context.
bool writePropertiesToElement(QDomElement &elem, QDomDocument &doc, const QgsReadWriteContext &context) const override
Stores multiframe state within an XML DOM element.
@ AttributeTableSourceLayer
Attribute table source layer.
The QgsConditionalLayerStyles class holds conditional style information for a layer.
QgsRectangle intersect(const QgsRectangle &rect) const
Returns the intersection with the given rectangle.
void changed()
Emitted when the object's properties change.
void setFeatureFilter(const QString &expression)
Sets the expression used for filtering features in the table.
Conditional styling for a rule.
A rectangle specified with double values.
void setUniqueRowsOnly(bool uniqueOnly)
Sets attribute table to only show unique rows.
void setUseConditionalStyling(bool enabled)
Sets whether the attribute table will be rendered using the conditional styling properties of the lin...
Encapsulates a QGIS project, including sets of map layers and their styles, layouts,...
static QgsConditionalStyle compressStyles(const QList< QgsConditionalStyle > &styles)
Compress a list of styles into a single style.
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.
QgsLayoutItemAttributeTable(QgsLayout *layout)
Constructor for QgsLayoutItemAttributeTable, attached to the specified layout.
QgsVectorLayer * referencingLayer
QgsFeatureRequest & setFilterExpression(const QString &expression)
Set the filter expression.
QgsFeatureRequest & setFilterRect(const QgsRectangle &rectangle)
Sets the rectangle from which features will be taken.
QgsLayoutTableSortColumns mSortColumns
Columns to sort the table.
QString layerId
Original layer ID.
QgsFields fields() const FINAL
Returns the list of fields of this layer.
bool readPropertiesFromElement(const QDomElement &itemElem, const QDomDocument &doc, const QgsReadWriteContext &context) override
Sets multiframe state from a DOM element.
This class wraps a request for features to a vector layer (or directly its vector data provider).
@ AllProperties
All properties for item.
bool useConditionalStyling() const
Returns true if the attribute table will be rendered using the conditional styling properties of the ...
Custom exception class for Coordinate Reference System related exceptions.
QString displayName() const override
Returns the multiframe display name.
QgsLayoutTableContents & contents()
Returns the current contents of the table.
void setLayer(TYPE *l)
Sets the reference to point to a specified layer.
QString provider
Weak reference to layer provider.
virtual QgsExpressionContextScope * scopeForCell(int row, int column) const
Creates a new QgsExpressionContextScope for the cell at row, column.
@ RelationChildren
Table shows attributes from related child features.
@ LayerAttributes
Table shows attributes from features in a vector layer.
QString name
Weak reference to layer name.
int type() const override
Returns unique multiframe type id.
QString id() const
Returns the layer's unique ID, which is used to access this layer from QgsProject.
void finalizeRestoreFromXml() override
Called after all pending items have been restored from XML.
ContentSource
Specifies the content source for the attribute table.
A layout table subclass that displays attributes from a vector layer.
void setAttribute(const QString &attribute)
Sets the attribute name or expression used for the column's values.
A class to display a table in the print layout, and allow the table to span over multiple frames.
QString wrapString() const
Returns the string used to wrap the contents of the table cells by.
virtual void refreshAttributes()
Refreshes the contents shown in the table by querying for new data.
static QList< QgsConditionalStyle > matchingConditionalStyles(const QList< QgsConditionalStyle > &styles, const QVariant &value, QgsExpressionContext &context)
Find and return the matching styles for the value and feature.
const QgsAbstractGeometry * constGet() const SIP_HOLDGIL
Returns a non-modifiable (const) reference to the underlying abstract geometry primitive.
QgsCoordinateReferenceSystem crs() const
Returns coordinate reference system used for rendering the map.
Single scope for storing variables and functions for use within a QgsExpressionContext.
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.
QgsConditionalStyle conditionalCellStyle(int row, int column) const override
Returns the conditional style to use for the cell at row, column.
void recalculateTableSize()
Recalculates and updates the size of the table and all table frames.
void appendScope(QgsExpressionContextScope *scope)
Appends a scope to the end of the context.
void setHeading(const QString &heading)
Sets the heading for a column, which is the value displayed in the column's header cell.
Layout graphical items for displaying a map.
static QgsMapLayer * mapLayerFromString(const QString &string, QgsProject *project)
Resolves a string into a map layer from a given project.
QgsConditionalStyles rowStyles() const
Returns a list of row styles associated with the layer.
static QgsLayoutItemAttributeTable * create(QgsLayout *layout)
Returns a new QgsLayoutItemAttributeTable for the specified parent layout.
void setMaximumNumberOfFeatures(int features)
Sets the maximum number of features shown by the table.
static QgsGeometryEngine * createGeometryEngine(const QgsAbstractGeometry *geometry)
Creates and returns a new geometry engine.
virtual QString uuid() const
Returns the item identification string.
QgsFeatureRequest getRelatedFeaturesRequest(const QgsFeature &feature) const
Creates a request to return all the features on the referencing (child) layer which have a foreign ke...
void setMap(QgsLayoutItemMap *map)
Sets a layout map to use to limit the extent of features shown in the attribute table.
void setWrapString(const QString &wrapString)
Sets a string to wrap the contents of the table cells by.
QPointer< QgsLayout > mLayout
bool nextFeature(QgsFeature &f)
A geometry is the spatial representation of a feature.
Base class for layouts, which can contain items such as maps, labels, scalebars, etc.
QString source
Weak reference to layer public source.
Represents a vector layer which manages a vector based data sets.
bool hasGeometry() const
Returns true if the feature has an associated geometry.
void mapRotationChanged(double newRotation)
Emitted when the map's rotation changes.
bool getTableContents(QgsLayoutTableContents &contents) override
Queries the attribute table's vector layer for attributes to show in the table.
@ AtlasFeature
Table shows attributes from the current atlas feature.
QgsConditionalLayerStyles * conditionalStyles() const
Returns the conditional styles that are set for this layer.
bool contentsContainsRow(const QgsLayoutTableContents &contents, const QgsLayoutTableRow &row) const
Checks whether a table contents contains a given row.
void setRelationId(const QString &id)
Sets the relation id from which to display child features.
_LayerRef< QgsVectorLayer > QgsVectorLayerRef
void setVectorLayer(QgsVectorLayer *layer)
Sets the vector layer from which to display feature attributes.
QgsRectangle boundingBox() const
Returns the bounding box of the geometry.
QList< QgsConditionalStyle > fieldStyles(const QString &fieldName) const
Returns the conditional styles set for the field with matching fieldName.
static QgsGeometry fromQPolygonF(const QPolygonF &polygon)
Construct geometry from a QPolygonF.
The feature class encapsulates a single feature including its id, geometry and a list of field/values...
QgsExpressionContext createExpressionContext() const override
This method needs to be reimplemented in all classes which implement this interface and return an exp...
QVector< QVariant > QgsLayoutTableRow
List of QVariants, representing a the contents of a single row in a QgsLayoutTable.
QgsLayoutTableColumns mColumns
Columns to show in table.
Stores properties of a column for a QgsLayoutTable.
void layerChanged(QgsVectorLayer *layer)
Emitted when the context's layer is changed.
int lookupField(const QString &fieldName) const
Looks up field's index from the field name.
Single variable definition for use within a QgsExpressionContextScope.
bool readPropertiesFromElement(const QDomElement &itemElem, const QDomDocument &doc, const QgsReadWriteContext &context) override
Sets multiframe state from a DOM element.
QgsField at(int i) const
Gets field at particular index (must be in range 0..N-1)
void setDisplayOnlyVisibleFeatures(bool visibleOnly)
Sets the attribute table to only show features which are visible in a map item.
Wrapper for iterator of features from vector data provider or vector layer.
@ LayoutAttributeTable
Attribute table.
bool isEmpty() const
Returns true if the rectangle is empty.
QgsFeatureRequest & setFlags(QgsFeatureRequest::Flags flags)
Sets flags that affect how features will be fetched.
bool writePropertiesToElement(QDomElement &elem, QDomDocument &doc, const QgsReadWriteContext &context) const override
Stores multiframe state within an XML DOM element.
bool isNull() const
Test if the rectangle is null (all coordinates zero or after call to setMinimal()).
void resetColumns()
Resets the attribute table's columns to match the vector layer's fields.
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.
QgsExpressionContextScope * scopeForCell(int row, int column) const override
Creates a new QgsExpressionContextScope for the cell at row, column.
void setSource(ContentSource source)
Sets the source for attributes to show in table body.
DataDefinedProperty
Data defined properties for different item types.
QPolygonF visibleExtentPolygon() const
Returns a polygon representing the current visible map extent, considering map extents and rotation.
TYPE * get() const
Returns a pointer to the layer, or nullptr if the reference has not yet been matched to a layer.
void setFeature(const QgsFeature &feature)
Convenience function for setting a feature for the context.
Encapsulate a field in an attribute table or data source.