mirror of
https://github.com/qgis/QGIS.git
synced 2025-02-26 00:02:08 -05:00
- update methods of existing classes - add comment to methods missing in the sip bindings - split up collective sip files into single files and use same directory structure in python/ as in src/ - add a lot of missing classes (some might not make sense because of missing python methods in those classes) - remove some non-existing methods from the header files - add scripts/sipdiff - replace some usages of std::vector and std::set with QVector/QSet
107 lines
4.1 KiB
Plaintext
107 lines
4.1 KiB
Plaintext
|
|
/**
|
|
There are two possibilities how to use this class:
|
|
1. static call to QgsVectorFileWriter::writeAsShapefile(...) which saves the whole vector layer
|
|
2. create an instance of the class and issue calls to addFeature(...)
|
|
|
|
Currently supports only writing to shapefiles, but shouldn't be a problem to add capability
|
|
to support other OGR-writable formats.
|
|
*/
|
|
class QgsVectorFileWriter
|
|
{
|
|
%TypeHeaderCode
|
|
#include <qgsvectorfilewriter.h>
|
|
#include <qgsfield.h>
|
|
%End
|
|
|
|
public:
|
|
enum WriterError
|
|
{
|
|
NoError = 0,
|
|
ErrDriverNotFound,
|
|
ErrCreateDataSource,
|
|
ErrCreateLayer,
|
|
ErrAttributeTypeUnsupported,
|
|
ErrAttributeCreationFailed,
|
|
ErrProjection, // added in 1.5
|
|
ErrFeatureWriteFailed, // added in 1.6
|
|
ErrInvalidLayer, // added in 2.0
|
|
};
|
|
|
|
/** Write contents of vector layer to a shapefile
|
|
@deprecated Use writeAsVectorFormat instead*/
|
|
static WriterError writeAsShapefile( QgsVectorLayer* layer,
|
|
const QString& shapefileName,
|
|
const QString& fileEncoding,
|
|
const QgsCoordinateReferenceSystem *,
|
|
bool onlySelected = false,
|
|
QString *errorMessage = 0,
|
|
const QStringList &datasourceOptions = QStringList(),
|
|
const QStringList &layerOptions = QStringList() ) /Deprecated/;
|
|
|
|
/** Write contents of vector layer to an (OGR supported) vector formt
|
|
@note: this method was added in version 1.5*/
|
|
static WriterError writeAsVectorFormat( QgsVectorLayer* layer,
|
|
const QString& fileName,
|
|
const QString& fileEncoding,
|
|
const QgsCoordinateReferenceSystem *destCRS,
|
|
const QString& driverName = "ESRI Shapefile",
|
|
bool onlySelected = false,
|
|
QString *errorMessage = 0,
|
|
const QStringList &datasourceOptions = QStringList(),
|
|
const QStringList &layerOptions = QStringList(),
|
|
bool skipAttributeCreation = false, // added in 1.7
|
|
QString *newFilename = 0
|
|
);
|
|
|
|
/** create shapefile and initialize it */
|
|
QgsVectorFileWriter( const QString& vectorFileName,
|
|
const QString& fileEncoding,
|
|
const QMap<int, QgsField>& fields,
|
|
QGis::WkbType geometryType,
|
|
const QgsCoordinateReferenceSystem* srs,
|
|
const QString& driverName = "ESRI Shapefile",
|
|
const QStringList &datasourceOptions = QStringList(),
|
|
const QStringList &layerOptions = QStringList(),
|
|
QString *newFilename = 0 );
|
|
|
|
/**Returns map with format filter string as key and OGR format key as value*/
|
|
static QMap< QString, QString> supportedFiltersAndFormats();
|
|
|
|
/**Returns driver list that can be used for dialogs*/
|
|
static QMap< QString, QString> ogrDriverList();
|
|
|
|
/**Returns filter string that can be used for dialogs*/
|
|
static QString fileFilterString();
|
|
|
|
/**Creates a filter for an OGR driver key*/
|
|
static QString filterForDriver( const QString& driverName );
|
|
|
|
/** checks whether there were any errors in constructor */
|
|
WriterError hasError();
|
|
|
|
/** retrieves error message
|
|
* @note added in 1.5
|
|
*/
|
|
QString errorMessage();
|
|
|
|
/** add feature to the currently opened shapefile */
|
|
bool addFeature( QgsFeature& feature );
|
|
|
|
// QMap<int, int> attrIdxToOgrIdx();
|
|
|
|
/** close opened shapefile for writing */
|
|
~QgsVectorFileWriter();
|
|
|
|
/** Delete a shapefile (and its accompanying shx / dbf / prf)
|
|
* @param theFileName /path/to/file.shp
|
|
* @return bool true if the file was deleted successfully
|
|
*/
|
|
static bool deleteShapeFile( QString theFileName );
|
|
|
|
protected:
|
|
|
|
// OGRGeometryH createEmptyGeometry( QGis::WkbType wkbType );
|
|
};
|
|
|