QGIS API Documentation  2.6.0-Brighton
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
Public Member Functions | List of all members
QgsComposerTableColumn Class Reference

Stores properties of a column in a QgsComposerTable. More...

#include <qgscomposertablecolumn.h>

Public Member Functions

 QgsComposerTableColumn ()
virtual ~QgsComposerTableColumn ()
virtual bool writeXML (QDomElement &columnElem, QDomDocument &doc) const
 Writes the column's properties to xml for storage.
virtual bool readXML (const QDomElement &columnElem)
 Reads the column's properties from xml.
double width () const
 Returns the width for a column.
void setWidth (const double width)
 Sets the width for a column.
QString heading () const
 Returns the heading for a column, which is the value displayed in the columns header cell.
void setHeading (QString heading)
 Sets the heading for a column, which is the value displayed in the columns header cell.
Qt::AlignmentFlag hAlignment () const
 Returns the horizontal alignment for a column, which controls the alignment used for drawing column values within cells.
void setHAlignment (Qt::AlignmentFlag alignment)
 Sets the horizontal alignment for a column, which controls the alignment used for drawing column values within cells.
QString attribute () const
 Returns the attribute name or expression used for the column's values.
void setAttribute (QString attribute)
 Sets the attribute name or expression used for the column's values.
Qt::SortOrder sortOrder () const
 Returns the sort order for the column.
void setSortOrder (Qt::SortOrder sortOrder)
 Sets the sort order for the column.
int sortByRank () const
 Returns the sort rank for the column.
void setSortByRank (int sortByRank)
 Sets the sort rank for the column.
QgsComposerTableColumnclone ()
 Creates a duplicate column which is a deep copy of this column.

Detailed Description

Stores properties of a column in a QgsComposerTable.

Some properties of a QgsComposerTableColumn are applicable only in certain contexts. For instance, the attribute and setAttribute methods only have an effect for QgsComposerAttributeTables, and have no effect for QgsComposerTextTables.

Constructor & Destructor Documentation

QgsComposerTableColumn::QgsComposerTableColumn ( )
QgsComposerTableColumn::~QgsComposerTableColumn ( )
virtual

Member Function Documentation

QString QgsComposerTableColumn::attribute ( ) const
inline

Returns the attribute name or expression used for the column's values.

This property is only used when the column is part of a QgsComposerAttributeTable.

Returns
attribute name or expression text for column
Note
added in 2.3
only applicable when used in a QgsComposerAttributeTable
See Also
setAttribute
QgsComposerTableColumn * QgsComposerTableColumn::clone ( )

Creates a duplicate column which is a deep copy of this column.

Returns
a new QgsComposerTableColumn with same properties as this column.
Note
added in 2.3
Qt::AlignmentFlag QgsComposerTableColumn::hAlignment ( ) const
inline

Returns the horizontal alignment for a column, which controls the alignment used for drawing column values within cells.

Returns
horizontal alignment.
Note
added in 2.3
See Also
setHAlignment
QString QgsComposerTableColumn::heading ( ) const
inline

Returns the heading for a column, which is the value displayed in the columns header cell.

Returns
Heading for column.
Note
added in 2.3
See Also
setHeading
bool QgsComposerTableColumn::readXML ( const QDomElement &  columnElem)
virtual

Reads the column's properties from xml.

Parameters
columnElema QDomElement holding the column's desired properties.
Note
added in 2.3
See Also
writeXML
void QgsComposerTableColumn::setAttribute ( QString  attribute)
inline

Sets the attribute name or expression used for the column's values.

This property is only used when the column is part of a QgsComposerAttributeTable.

Parameters
attributeattribute name or expression text for column
Note
added in 2.3
only applicable when used in a QgsComposerAttributeTable
See Also
attribute
void QgsComposerTableColumn::setHAlignment ( Qt::AlignmentFlag  alignment)
inline

Sets the horizontal alignment for a column, which controls the alignment used for drawing column values within cells.

Parameters
alignmenthorizontal alignment for cell.
Note
added in 2.3
See Also
hAlignment
void QgsComposerTableColumn::setHeading ( QString  heading)
inline

Sets the heading for a column, which is the value displayed in the columns header cell.

Parameters
headingHeading for column.
Note
added in 2.3
See Also
heading
void QgsComposerTableColumn::setSortByRank ( int  sortByRank)
inline

Sets the sort rank for the column.

If the sort rank is > 0 then the column will be sorted in the table. The sort rank specifies the priority given to the column when the table is sorted by multiple columns, with lower sort ranks having higher priority. This property is only used when the column is part of a QgsComposerAttributeTable.

Parameters
sortByRanksort rank for column. If sort rank is <= 0 then the column is not being sorted.
Note
added in 2.3
only applicable when used in a QgsComposerAttributeTable
See Also
sortByRank
setSortOrder
void QgsComposerTableColumn::setSortOrder ( Qt::SortOrder  sortOrder)
inline

Sets the sort order for the column.

This property is only used when the column is part of a QgsComposerAttributeTable and when sortByRank is > 0.

Parameters
sortOrdersort order for column
Note
added in 2.3
only applicable when used in a QgsComposerAttributeTable
See Also
sortOrder
setSortByRank
void QgsComposerTableColumn::setWidth ( const double  width)
inline

Sets the width for a column.

Parameters
widthcolumn width in mm, or 0 if column width is to be automatically calculated.
Note
added in 2.5
See Also
width
int QgsComposerTableColumn::sortByRank ( ) const
inline

Returns the sort rank for the column.

If the sort rank is > 0 then the column will be sorted in the table. The sort rank specifies the priority given to the column when the table is sorted by multiple columns, with lower sort ranks having higher priority. This property is only used when the column is part of a QgsComposerAttributeTable.

Returns
sort rank for column. If sort rank is <= 0 then the column is not being sorted.
Note
added in 2.3
only applicable when used in a QgsComposerAttributeTable
See Also
setSortByRank
sortOrder
Qt::SortOrder QgsComposerTableColumn::sortOrder ( ) const
inline

Returns the sort order for the column.

This property is only used when the column is part of a QgsComposerAttributeTable and when sortByRank is > 0.

Returns
sort order for column
Note
added in 2.3
only applicable when used in a QgsComposerAttributeTable
See Also
setSortOrder
sortByRank
double QgsComposerTableColumn::width ( ) const
inline

Returns the width for a column.

Returns
column width in mm, or 0 if column width is automatically calculated.
Note
added in 2.5
See Also
setWidth
bool QgsComposerTableColumn::writeXML ( QDomElement &  columnElem,
QDomDocument &  doc 
) const
virtual

Writes the column's properties to xml for storage.

Parameters
columnEleman existing QDomElement in which to store the column's properties.
docQDomDocument for the destination xml.
Note
added in 2.3
See Also
readXML

The documentation for this class was generated from the following files: