QGIS API Documentation  3.37.0-Master (a5b4d9743e8)
Public Member Functions | Public Attributes | List of all members
QgsVectorFileWriter::SaveVectorOptions Class Reference

Options to pass to writeAsVectorFormat() More...

#include <qgsvectorfilewriter.h>

Public Member Functions

 SaveVectorOptions ()
 Constructor. More...
 
virtual ~SaveVectorOptions ()=default
 

Public Attributes

QgsVectorFileWriter::ActionOnExistingFile actionOnExistingFile = CreateOrOverwriteFile
 Action on existing file. More...
 
QgsAttributeList attributes
 Attributes to export (empty means all unless skipAttributeCreation is set) More...
 
QStringList attributesExportNames
 Attributes export names. More...
 
QgsCoordinateTransform ct
 Transform to reproject exported geometries with, or invalid transform for no transformation. More...
 
QStringList datasourceOptions
 List of OGR data source creation options. More...
 
QString driverName
 OGR driver to use. More...
 
QgsFeedbackfeedback = nullptr
 Optional feedback object allowing cancellation of layer save. More...
 
FieldNameSource fieldNameSource = Original
 Source for exported field names. More...
 
QgsVectorFileWriter::FieldValueConverterfieldValueConverter = nullptr
 Field value converter. More...
 
QString fileEncoding
 Encoding to use. More...
 
QgsRectangle filterExtent
 If not empty, only features intersecting the extent will be saved. More...
 
bool forceMulti = false
 Sets to true to force creation of multi* geometries. More...
 
bool includeConstraints = false
 Set to true to transfer field constraints to the exported vector file. More...
 
bool includeZ = false
 Sets to true to include z dimension in output. This option is only valid if overrideGeometryType is set. More...
 
QgsLayerMetadata layerMetadata
 Layer metadata to save for the exported vector file. More...
 
QString layerName
 Layer name. If let empty, it will be derived from the filename. More...
 
QStringList layerOptions
 List of OGR layer creation options. More...
 
bool onlySelectedFeatures = false
 Write only selected features of layer. More...
 
Qgis::WkbType overrideGeometryType = Qgis::WkbType::Unknown
 Set to a valid geometry type to override the default geometry type for the layer. More...
 
bool saveMetadata = false
 Set to true to save layer metadata for the exported vector file. More...
 
bool setFieldDomains = true
 Set to true to transfer field domains to the exported vector file. More...
 
bool skipAttributeCreation = false
 Only write geometries. More...
 
const QgsAbstractDatabaseProviderConnectionsourceDatabaseProviderConnection = nullptr
 Source database provider connection, for field domains. More...
 
Qgis::FeatureSymbologyExport symbologyExport = Qgis::FeatureSymbologyExport::NoSymbology
 Symbology to export. More...
 
double symbologyScale = 1.0
 Scale of symbology. More...
 

Detailed Description

Options to pass to writeAsVectorFormat()

Definition at line 444 of file qgsvectorfilewriter.h.

Constructor & Destructor Documentation

◆ SaveVectorOptions()

QgsVectorFileWriter::SaveVectorOptions::SaveVectorOptions ( )

Constructor.

Definition at line 3387 of file qgsvectorfilewriter.cpp.

◆ ~SaveVectorOptions()

virtual QgsVectorFileWriter::SaveVectorOptions::~SaveVectorOptions ( )
virtualdefault

Member Data Documentation

◆ actionOnExistingFile

QgsVectorFileWriter::ActionOnExistingFile QgsVectorFileWriter::SaveVectorOptions::actionOnExistingFile = CreateOrOverwriteFile

Action on existing file.

Definition at line 459 of file qgsvectorfilewriter.h.

◆ attributes

QgsAttributeList QgsVectorFileWriter::SaveVectorOptions::attributes

Attributes to export (empty means all unless skipAttributeCreation is set)

Definition at line 483 of file qgsvectorfilewriter.h.

◆ attributesExportNames

QStringList QgsVectorFileWriter::SaveVectorOptions::attributesExportNames

Attributes export names.

Definition at line 486 of file qgsvectorfilewriter.h.

◆ ct

QgsCoordinateTransform QgsVectorFileWriter::SaveVectorOptions::ct

Transform to reproject exported geometries with, or invalid transform for no transformation.

Definition at line 468 of file qgsvectorfilewriter.h.

◆ datasourceOptions

QStringList QgsVectorFileWriter::SaveVectorOptions::datasourceOptions

List of OGR data source creation options.

Definition at line 474 of file qgsvectorfilewriter.h.

◆ driverName

QString QgsVectorFileWriter::SaveVectorOptions::driverName

OGR driver to use.

Definition at line 453 of file qgsvectorfilewriter.h.

◆ feedback

QgsFeedback* QgsVectorFileWriter::SaveVectorOptions::feedback = nullptr

Optional feedback object allowing cancellation of layer save.

Definition at line 518 of file qgsvectorfilewriter.h.

◆ fieldNameSource

FieldNameSource QgsVectorFileWriter::SaveVectorOptions::fieldNameSource = Original

Source for exported field names.

Since
QGIS 3.18

Definition at line 525 of file qgsvectorfilewriter.h.

◆ fieldValueConverter

QgsVectorFileWriter::FieldValueConverter* QgsVectorFileWriter::SaveVectorOptions::fieldValueConverter = nullptr

Field value converter.

Ownership is not transferred and callers must ensure that the lifetime of fieldValueConverter exceeds the lifetime of the QgsVectorFileWriter object.

Definition at line 515 of file qgsvectorfilewriter.h.

◆ fileEncoding

QString QgsVectorFileWriter::SaveVectorOptions::fileEncoding

Encoding to use.

Definition at line 462 of file qgsvectorfilewriter.h.

◆ filterExtent

QgsRectangle QgsVectorFileWriter::SaveVectorOptions::filterExtent

If not empty, only features intersecting the extent will be saved.

Definition at line 495 of file qgsvectorfilewriter.h.

◆ forceMulti

bool QgsVectorFileWriter::SaveVectorOptions::forceMulti = false

Sets to true to force creation of multi* geometries.

Definition at line 504 of file qgsvectorfilewriter.h.

◆ includeConstraints

bool QgsVectorFileWriter::SaveVectorOptions::includeConstraints = false

Set to true to transfer field constraints to the exported vector file.

Support for field constraints depends on the output file format.

Since
QGIS 3.34

Definition at line 550 of file qgsvectorfilewriter.h.

◆ includeZ

bool QgsVectorFileWriter::SaveVectorOptions::includeZ = false

Sets to true to include z dimension in output. This option is only valid if overrideGeometryType is set.

Definition at line 507 of file qgsvectorfilewriter.h.

◆ layerMetadata

QgsLayerMetadata QgsVectorFileWriter::SaveVectorOptions::layerMetadata

Layer metadata to save for the exported vector file.

This will only be used if saveMetadata is true.

See also
saveMetadata
Since
QGIS 3.20

Definition at line 541 of file qgsvectorfilewriter.h.

◆ layerName

QString QgsVectorFileWriter::SaveVectorOptions::layerName

Layer name. If let empty, it will be derived from the filename.

Definition at line 456 of file qgsvectorfilewriter.h.

◆ layerOptions

QStringList QgsVectorFileWriter::SaveVectorOptions::layerOptions

List of OGR layer creation options.

Definition at line 477 of file qgsvectorfilewriter.h.

◆ onlySelectedFeatures

bool QgsVectorFileWriter::SaveVectorOptions::onlySelectedFeatures = false

Write only selected features of layer.

Definition at line 471 of file qgsvectorfilewriter.h.

◆ overrideGeometryType

Qgis::WkbType QgsVectorFileWriter::SaveVectorOptions::overrideGeometryType = Qgis::WkbType::Unknown

Set to a valid geometry type to override the default geometry type for the layer.

This parameter allows for conversion of geometryless tables to null geometries, etc.

Definition at line 501 of file qgsvectorfilewriter.h.

◆ saveMetadata

bool QgsVectorFileWriter::SaveVectorOptions::saveMetadata = false

Set to true to save layer metadata for the exported vector file.

See also
layerMetadata
Since
QGIS 3.20

Definition at line 533 of file qgsvectorfilewriter.h.

◆ setFieldDomains

bool QgsVectorFileWriter::SaveVectorOptions::setFieldDomains = true

Set to true to transfer field domains to the exported vector file.

Support for field domains depends on the output file format.

Note
Only available in builds based on GDAL 3.5 or later
Since
QGIS 3.36

Definition at line 560 of file qgsvectorfilewriter.h.

◆ skipAttributeCreation

bool QgsVectorFileWriter::SaveVectorOptions::skipAttributeCreation = false

Only write geometries.

Definition at line 480 of file qgsvectorfilewriter.h.

◆ sourceDatabaseProviderConnection

const QgsAbstractDatabaseProviderConnection* QgsVectorFileWriter::SaveVectorOptions::sourceDatabaseProviderConnection = nullptr

Source database provider connection, for field domains.

Ownership is not transferred and callers must ensure that the lifetime of sourceDatabaseProviderConnection exceeds the lifetime of the QgsVectorFileWriter object.

Since
QGIS 3.36

Definition at line 570 of file qgsvectorfilewriter.h.

◆ symbologyExport

Qgis::FeatureSymbologyExport QgsVectorFileWriter::SaveVectorOptions::symbologyExport = Qgis::FeatureSymbologyExport::NoSymbology

Symbology to export.

Definition at line 489 of file qgsvectorfilewriter.h.

◆ symbologyScale

double QgsVectorFileWriter::SaveVectorOptions::symbologyScale = 1.0

Scale of symbology.

Definition at line 492 of file qgsvectorfilewriter.h.


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