public:

QgsComposerAttributeTableCompare();

// bool operator()( const QgsAttributeMap& m1, const QgsAttributeMap& m2 );

/**Sets column number to sort by

* @param col column number for sorting

*/

* @see readXML

*/

bool writeXML( QDomElement& elem, QDomDocument & doc ) const;

/**Reads the properties specific to an attribute table from xml.

* @param itemElem a QDomElement holding the attribute table's desired properties.

* @param doc QDomDocument for the source xml.

* @see vectorLayer

*/

void setVectorLayer( QgsVectorLayer* layer );

/**Returns the vector layer the attribute table is currently using

* @returns attribute table's current vector layer

* @see setVectorLayer

*/

QgsVectorLayer* vectorLayer() const;

/**Resets the attribute table's columns to match the vector layer's fields

* @note added in 2.3

* @see setVectorLayer

* @see setDisplayOnlyVisibleFeatures

*/

void setComposerMap( const QgsComposerMap* map /TransferThis/ );

/**Returns the composer map whose extents are controlling the features shown in the

* table. The extents of the map are only used if displayOnlyVisibleFeatures() is true.

* @returns composer map controlling the attribute table

* @see setComposerMap

* @see displayOnlyVisibleFeatures

const QgsComposerMap* composerMap() const;

/**Sets the maximum number of features shown by the table. Changing this setting may result

* @see maximumNumberOfFeatures

*/

void setMaximumNumberOfFeatures( int features );

/**Returns the maximum number of features to be shown by the table.

* @returns maximum number of features

* @see setMaximumNumberOfFeatures

int maximumNumberOfFeatures() const;

/**Sets attribute table to only show features which are visible in a composer map item. Changing

* @see setComposerMap

*/

void setDisplayOnlyVisibleFeatures( bool b );

/**Returns true if the table is set to show only features visible on a corresponding

* composer map item.

* @returns true if table only shows visible features

* @see composerMap

* @see setDisplayOnlyVisibleFeatures

bool displayOnlyVisibleFeatures() const;

/**Returns true if a feature filter is active on the attribute table

* @returns bool state of the feature filter

* @note added in 2.3

* @see setFilterFeatures

* @see featureFilter

*/

bool filterFeatures() const;

/**Sets whether the feature filter is active for the attribute table. Changing

* this setting forces the table to refetch features from its vector layer, and may result in

* the table changing size to accommodate the new displayed feature attributes.

* @see filterFeatures

*/

QString featureFilter() const;

/**Sets the expression used for filtering features in the table. The filter is only

* active if filterFeatures() is set to true. Changing this setting forces the table

* to refetch features from its vector layer, and may result in

* @deprecated use QgsComposerTable::columns() instead

*/

QSet<int> displayAttributes() const /Deprecated/;

/**Sets the attributes to display in the table.

* @param attr QSet of integer values refering to the attributes from the vector layer to show.

* Set to an empty QSet to show all feature attributes.

* @param refresh set to true to force the table to refetch features from its vector layer

* and immediately update the display of the table. This may result in the table changing size

* to accommodate the new displayed feature attributes.

* @see displayAttributes

void setDisplayAttributes( const QSet<int>& attr );

/**Returns the attribute field aliases, which control how fields are named in the table's

* @deprecated use QgsComposerTable::columns() instead

*/

QMap<int, QString> fieldAliasMap() const /Deprecated/;

/**Sets the attribute field aliases, which control how fields are named in the table's

* header row.

* @param map QMap of integers to strings, where the string is the alias to use for the

* corresponding field, and the integer is the field index from the vector layer

* @see fieldAliasMap

* @deprecated use QgsComposerTable::columns() instead

void setFieldAliasMap( const QMap<int, QString>& map ) /Deprecated/;

/**Adapts mMaximumNumberOfFeatures depending on the rectangle height. Calling this forces

*/

void setSceneRect( const QRectF& rectangle );

// QList<QPair<int, bool> > sortAttributes() const;

signals:

/**This signal is emitted if the maximum number of feature changes (interactively)*/

void maximumNumberOfFeaturesChanged( int n );

#include <qgscomposerattributetablemodel.h>

%End

/*! Controls whether a row/column is shifted up or down

*/

/**Constructor for QgsComposerAttributeTableColumnModel.

* @param composerTable QgsComposerAttributeTable the model is attached to

*/

QgsComposerAttributeTableColumnModel( QgsComposerAttributeTable *composerTable, QObject *parent = 0 );

virtual ~QgsComposerAttributeTableColumnModel();

bool removeRows( int row, int count, const QModelIndex &parent = QModelIndex() );

bool insertRows( int row, int count, const QModelIndex &parent = QModelIndex() );

QModelIndex index( int row, int column, const QModelIndex &parent ) const;

/**Moves the specified row up or down in the model. Used for rearranging the attribute tables

* columns.

* @see setColumnAsSorted

*/

bool moveColumnInSortRank( QgsComposerTableColumn * column, ShiftDirection direction );

};

/**Allows for filtering QgsComposerAttributeTable columns by columns which are sorted or unsorted*/

%End

public:

*/

enum ColumnFilterType

{

/**Constructor for QgsComposerTableSortColumnsProxyModel.

* @param composerTable QgsComposerAttributeTable the model is attached to

* @param filterType filter for columns, controls whether sorted or unsorted columns are shown

*/

QgsComposerTableSortColumnsProxyModel( QgsComposerAttributeTable *composerTable, ColumnFilterType filterType, QObject *parent = 0 );

/**Returns the QgsComposerTableColumn corresponding to an index from the source

* QgsComposerAttributeTableColumnModel model.

* @returns QgsComposerTableColumn for specified index from QgsComposerAttributeTableColumnModel

* @note added in 2.3

* @see columnFromRow

* @see columnFromIndex

*/

QgsComposerTableColumn* columnFromSourceIndex( const QModelIndex& sourceIndex ) const;

protected:

bool filterAcceptsRow( int source_row, const QModelIndex & source_parent ) const;

};