QgsVectorFileWriter::SaveVectorOptions Class Reference

Options to pass to QgsVectorFileWriter::writeAsVectorFormat(). More...

#include <qgsvectorfilewriter.h>

Public Member Functions
	SaveVectorOptions ()
virtual	~SaveVectorOptions ()=default

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

Detailed Description

Options to pass to QgsVectorFileWriter::writeAsVectorFormat().

Definition at line 455 of file qgsvectorfilewriter.h.

Constructor & Destructor Documentation

SaveVectorOptions()

QgsVectorFileWriter::SaveVectorOptions::SaveVectorOptions

(

)

Definition at line 3440 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 470 of file qgsvectorfilewriter.h.

attributes

QgsAttributeList QgsVectorFileWriter::SaveVectorOptions::attributes

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

Definition at line 494 of file qgsvectorfilewriter.h.

attributesExportNames

QStringList QgsVectorFileWriter::SaveVectorOptions::attributesExportNames

Attributes export names.

Definition at line 497 of file qgsvectorfilewriter.h.

ct

QgsCoordinateTransform QgsVectorFileWriter::SaveVectorOptions::ct

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

Definition at line 479 of file qgsvectorfilewriter.h.

datasourceOptions

QStringList QgsVectorFileWriter::SaveVectorOptions::datasourceOptions

List of OGR data source creation options.

Definition at line 485 of file qgsvectorfilewriter.h.

driverName

QString QgsVectorFileWriter::SaveVectorOptions::driverName

OGR driver to use.

Definition at line 464 of file qgsvectorfilewriter.h.

feedback

QgsFeedback* QgsVectorFileWriter::SaveVectorOptions::feedback = nullptr

Optional feedback object allowing cancellation of layer save.

Definition at line 534 of file qgsvectorfilewriter.h.

fieldNameSource

QgsVectorFileWriter::FieldNameSource QgsVectorFileWriter::SaveVectorOptions::fieldNameSource = QgsVectorFileWriter::Original

Source for exported field names.

Since

QGIS 3.18

Definition at line 541 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 531 of file qgsvectorfilewriter.h.

fileEncoding

QString QgsVectorFileWriter::SaveVectorOptions::fileEncoding

Encoding to use.

Definition at line 473 of file qgsvectorfilewriter.h.

filterExtent

QgsRectangle QgsVectorFileWriter::SaveVectorOptions::filterExtent

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

The filter extent should be in the destination CRS (if transforming), or the layer's CRS if no valid transform is set.

Definition at line 511 of file qgsvectorfilewriter.h.

forceMulti

bool QgsVectorFileWriter::SaveVectorOptions::forceMulti = false

Sets to true to force creation of multipart geometries.

Definition at line 520 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 566 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 523 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 557 of file qgsvectorfilewriter.h.

layerName

QString QgsVectorFileWriter::SaveVectorOptions::layerName

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

Definition at line 467 of file qgsvectorfilewriter.h.

layerOptions

QStringList QgsVectorFileWriter::SaveVectorOptions::layerOptions

List of OGR layer creation options.

Definition at line 488 of file qgsvectorfilewriter.h.

onlySelectedFeatures

bool QgsVectorFileWriter::SaveVectorOptions::onlySelectedFeatures = false

Write only selected features of layer.

Definition at line 482 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 517 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 549 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 576 of file qgsvectorfilewriter.h.

skipAttributeCreation

bool QgsVectorFileWriter::SaveVectorOptions::skipAttributeCreation = false

Only write geometries.

Definition at line 491 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 586 of file qgsvectorfilewriter.h.

symbologyExport

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

Symbology to export.

Definition at line 500 of file qgsvectorfilewriter.h.

symbologyScale

double QgsVectorFileWriter::SaveVectorOptions::symbologyScale = 1.0

Scale of symbology.

Definition at line 503 of file qgsvectorfilewriter.h.

---

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

• /build/qgis-3.99.0+git20251207+21b3aa880ba+99sid/src/core/qgsvectorfilewriter.h
• /build/qgis-3.99.0+git20251207+21b3aa880ba+99sid/src/core/qgsvectorfilewriter.cpp