QGIS API Documentation 3.41.0-Master (3440c17df1d)
Loading...
Searching...
No Matches
qgslayoutitemmanualtable.h
Go to the documentation of this file.
1/***************************************************************************
2 qgslayoutitemmanualtable.h
3 ---------------------------
4 begin : January 2020
5 copyright : (C) 2020 by Nyall Dawson
6 email : nyall dot dawson at gmail dot com
7 ***************************************************************************/
8
9/***************************************************************************
10 * *
11 * This program is free software; you can redistribute it and/or modify *
12 * it under the terms of the GNU General Public License as published by *
13 * the Free Software Foundation; either version 2 of the License, or *
14 * (at your option) any later version. *
15 * *
16 ***************************************************************************/
17
18#ifndef QGSLAYOUTITEMMANUALTABLE_H
19#define QGSLAYOUTITEMMANUALTABLE_H
20
21#include "qgis_core.h"
22#include "qgis_sip.h"
23#include "qgslayouttable.h"
24#include "qgstablecell.h"
25
32{
33 Q_OBJECT
34
35 public:
36
43
45
46 int type() const override;
47 QIcon icon() const override;
48 QString displayName() const override;
49
53 static QgsLayoutItemManualTable *create( QgsLayout *layout ) SIP_FACTORY;
54 bool getTableContents( QgsLayoutTableContents &contents ) override SIP_SKIP;
55 QgsConditionalStyle conditionalCellStyle( int row, int column ) const override;
56
62 void setTableContents( const QgsTableContents &contents );
63
69 QgsTableContents tableContents() const;
70
79 QList< double > rowHeights() const { return mRowHeights; }
80
89 void setRowHeights( const QList< double > &heights );
90
99 QList< double > columnWidths() const { return mColumnWidths; }
100
109 void setColumnWidths( const QList< double > &widths );
110
116 bool includeTableHeader() const;
117
123 void setIncludeTableHeader( bool included );
124
129 QgsLayoutTableColumns &headers();
130
135 void setHeaders( const QgsLayoutTableColumns &headers );
136
137 protected:
138
139 bool writePropertiesToElement( QDomElement &elem, QDomDocument &doc, const QgsReadWriteContext &context ) const override;
140 bool readPropertiesFromElement( const QDomElement &itemElem, const QDomDocument &doc, const QgsReadWriteContext &context ) override;
141 bool calculateMaxRowHeights() override;
142 QgsTextFormat textFormatForHeader( int column ) const override;
143 QgsTextFormat textFormatForCell( int row, int column ) const override;
144 Qt::Alignment horizontalAlignmentForCell( int row, int column ) const override;
145 Qt::Alignment verticalAlignmentForCell( int row, int column ) const override;
146 int rowSpan( int row, int column ) const override;
147 int columnSpan( int row, int column ) const override;
148
149 private:
150
151 QgsTableContents mContents;
152 QgsLayoutTableColumns mHeaders;
153
154 QList< double > mRowHeights;
155 QList< double > mColumnWidths;
156 bool mIncludeHeader = false;
157
158 void refreshColumns();
159
160};
161
162#endif // QGSLAYOUTITEMMANUALTABLE_H
Conditional styling for a rule.
A layout table subclass that displays manually entered (and formatted) content.
QList< double > rowHeights() const
Returns the list of row heights (in millimeters) to use when rendering the table.
QList< double > columnWidths() const
Returns the list of column widths (in millimeters) to use when rendering the table.
virtual int type() const =0
Returns unique multiframe type id.
virtual QIcon icon() const
Returns the item's icon.
virtual QString displayName() const
Returns the multiframe display name.
A class to display a table in the print layout, and allow the table to span over multiple frames.
virtual Qt::Alignment horizontalAlignmentForCell(int row, int column) const
Returns the horizontal alignment to use for the cell at the specified row and column.
virtual QgsConditionalStyle conditionalCellStyle(int row, int column) const
Returns the conditional style to use for the cell at row, column.
virtual int rowSpan(int row, int column) const
Returns the row span for the cell a row, column.
virtual QgsTextFormat textFormatForHeader(int column) const
Returns the text format to use for the header cell at the specified column.
virtual bool getTableContents(QgsLayoutTableContents &contents)=0
Fetches the contents used for the cells in the table.
virtual Qt::Alignment verticalAlignmentForCell(int row, int column) const
Returns the vertical alignment to use for the cell at the specified row and column.
bool writePropertiesToElement(QDomElement &elem, QDomDocument &doc, const QgsReadWriteContext &context) const override
Stores multiframe state within an XML DOM element.
virtual int columnSpan(int row, int column) const
Returns the column span for the cell a row, column.
virtual QgsTextFormat textFormatForCell(int row, int column) const
Returns the text format to use for the cell at the specified row and column.
bool readPropertiesFromElement(const QDomElement &itemElem, const QDomDocument &doc, const QgsReadWriteContext &context) override
Sets multiframe state from a DOM element.
virtual bool calculateMaxRowHeights()
Calculates the maximum height of text shown in rows.
Base class for layouts, which can contain items such as maps, labels, scalebars, etc.
Definition qgslayout.h:49
The class is used as a container of context for various read/write operations on other objects.
Container for all settings relating to text rendering.
QVector< QgsLayoutTableColumn > QgsLayoutTableColumns
List of column definitions for a QgsLayoutTable.
QVector< QgsLayoutTableRow > QgsLayoutTableContents
List of QgsLayoutTableRows, representing rows and column cell contents for a QgsLayoutTable.
#define SIP_TRANSFERTHIS
Definition qgis_sip.h:53
#define SIP_SKIP
Definition qgis_sip.h:126
#define SIP_FACTORY
Definition qgis_sip.h:76
QVector< QgsTableRow > QgsTableContents
A set of table rows.