Contains details about a sub layer available from a dataset. More...

#include <qgsprovidersublayerdetails.h>

Classes
struct	LayerOptions
	Setting options for loading layers. More...

Public Member Functions
QString	description () const
	Returns the layer's description.

QString	driverName () const
	Returns the layer's driver name.

long long	featureCount () const
	Returns the layer's feature count.

Qgis::SublayerFlags	flags () const
	Returns the layer's flags, which indicate properties of the layer.

QString	geometryColumnName () const
	Returns the layer's geometry column name, or an empty string if not applicable.

int	layerNumber () const
	Returns the associated layer number, for providers which order sublayers.

QString	name () const
	Returns the layer's name.

bool	operator!= (const QgsProviderSublayerDetails &other) const

bool	operator== (const QgsProviderSublayerDetails &other) const

QStringList	path () const
	Returns the path to the sublayer.

QString	providerKey () const
	Returns the associated data provider key.

void	setDescription (const QString &description)
	Sets the layer's description.

void	setDriverName (const QString &driver)
	Sets the layer's driver name.

void	setFeatureCount (long long count)
	Sets the layer's feature count.

void	setFlags (Qgis::SublayerFlags newFlags)
	Sets the layer's flags, which indicate properties of the layer.

void	setGeometryColumnName (const QString &name)
	Sets the layer's geometry column name.

void	setLayerNumber (int number)
	Sets the associated layer number, for providers which order sublayers.

void	setName (const QString &name)
	Sets the layer's name.

void	setPath (const QStringList &path)
	Sets the path to the sublayer.

void	setProviderKey (const QString &key)
	Sets the associated data provider key.

void	setSkippedContainerScan (bool skipped)
	Set to `true` if the layer is a potential dataset container and an in-depth scan of its contents was skipped.

void	setType (Qgis::LayerType type)
	Sets the layer type.

void	setUri (const QString &uri)
	Sets the layer's uri.

void	setWkbType (Qgis::WkbType type)
	Set the layer's WKB type.

bool	skippedContainerScan () const
	Returns `true` if the layer is a potential dataset container and an in-depth scan of its contents was skipped.

QgsMapLayer *	toLayer (const LayerOptions &options) const
	Creates a new QgsMapLayer object associated with the sublayer.

QgsMimeDataUtils::Uri	toMimeUri () const
	Converts the sublayer details to a QgsMimeDataUtils::Uri representing the sublayer.

Qgis::LayerType	type () const
	Returns the layer type.

QString	uri () const
	Returns the layer's URI.

Qgis::WkbType	wkbType () const
	Returns the layer's WKB type, or QgsWkbTypes::Unknown if the WKB type is not application or unknown.

Detailed Description

Contains details about a sub layer available from a dataset.

This class encapsulates the properties of a single sublayer available from a dataset, according to a specific data provider.

Note: It is possible that multiple data providers may be able to utilize the same underlying sub layer in a single dataset, yet will interpret this layer differently. For instance, a layer in a Geospatial PDF document can be interpreted as either a vector layer by the OGR data provider or a raster layer by the GDAL provider. The providerKey() property can be used to determine the data provider associated with a QgsProviderSubLayerDetails instance.

Since: QGIS 3.22

Definition at line 45 of file qgsprovidersublayerdetails.h.

Member Function Documentation

◆ description()

QString QgsProviderSublayerDetails::description ( ) const

inline

Returns the layer's description.

See also: setDescription()

Definition at line 151 of file qgsprovidersublayerdetails.h.

◆ driverName()

QString QgsProviderSublayerDetails::driverName ( ) const

inline

Returns the layer's driver name.

This is supported only for providers which handle multiple drivers.

See also: setDriverName()

Definition at line 181 of file qgsprovidersublayerdetails.h.

◆ featureCount()

long long QgsProviderSublayerDetails::featureCount ( ) const

inline

Returns the layer's feature count.

Will return Qgis::FeatureCountState::UnknownCount or Qgis::FeatureCountState::Uncounted if no feature count is applicable or available.

See also: setFeatureCount()

Definition at line 217 of file qgsprovidersublayerdetails.h.

◆ flags()

Qgis::SublayerFlags QgsProviderSublayerDetails::flags ( ) const

inline

Returns the layer's flags, which indicate properties of the layer.

See also: setFlags()

Definition at line 165 of file qgsprovidersublayerdetails.h.

◆ geometryColumnName()

QString QgsProviderSublayerDetails::geometryColumnName ( ) const

inline

Returns the layer's geometry column name, or an empty string if not applicable.

See also: setGeometryColumnName()

Definition at line 249 of file qgsprovidersublayerdetails.h.

◆ layerNumber()

int QgsProviderSublayerDetails::layerNumber ( ) const

inline

Returns the associated layer number, for providers which order sublayers.

See also: setLayerNumber()

Definition at line 273 of file qgsprovidersublayerdetails.h.

◆ name()

QString QgsProviderSublayerDetails::name ( ) const

inline

Returns the layer's name.

See also: setName()

Definition at line 137 of file qgsprovidersublayerdetails.h.

◆ operator!=()

bool QgsProviderSublayerDetails::operator!= ( const QgsProviderSublayerDetails & other ) const

Definition at line 88 of file qgsprovidersublayerdetails.cpp.

◆ operator==()

bool QgsProviderSublayerDetails::operator== ( const QgsProviderSublayerDetails & other ) const

Definition at line 71 of file qgsprovidersublayerdetails.cpp.

◆ path()

QStringList QgsProviderSublayerDetails::path ( ) const

inline

Returns the path to the sublayer.

This is an internal path, relative to the dataset itself. It can be used to encapsulate the hierarchy of a dataset which organises layers in schemas or in an internal folder structure.

See also: setPath()

Definition at line 198 of file qgsprovidersublayerdetails.h.

◆ providerKey()

QString QgsProviderSublayerDetails::providerKey ( ) const

inline

Returns the associated data provider key.

See also: setProviderKey()

Definition at line 54 of file qgsprovidersublayerdetails.h.

◆ setDescription()

void QgsProviderSublayerDetails::setDescription ( const QString & description )

inline

Sets the layer's description.

See also: description()

Definition at line 158 of file qgsprovidersublayerdetails.h.

◆ setDriverName()

void QgsProviderSublayerDetails::setDriverName ( const QString & driver )

inline

Sets the layer's driver name.

See also: driverName()

Definition at line 188 of file qgsprovidersublayerdetails.h.

◆ setFeatureCount()

void QgsProviderSublayerDetails::setFeatureCount ( long long count )

inline

Sets the layer's feature count.

Set to Qgis::FeatureCountState::UnknownCount or Qgis::FeatureCountState::Uncounted if no feature count is applicable or available.

See also: featureCount()

Definition at line 226 of file qgsprovidersublayerdetails.h.

◆ setFlags()

void QgsProviderSublayerDetails::setFlags ( Qgis::SublayerFlags newFlags )

inline

Sets the layer's flags, which indicate properties of the layer.

See also: flags()

Definition at line 172 of file qgsprovidersublayerdetails.h.

◆ setGeometryColumnName()

void QgsProviderSublayerDetails::setGeometryColumnName ( const QString & name )

inline

Sets the layer's geometry column name.

Set to an empty string if not applicable.

See also: geometryColumnName()

Definition at line 258 of file qgsprovidersublayerdetails.h.

◆ setLayerNumber()

void QgsProviderSublayerDetails::setLayerNumber ( int number )

inline

Sets the associated layer number, for providers which order sublayers.

See also: layerNumber()

Definition at line 280 of file qgsprovidersublayerdetails.h.

◆ setName()

void QgsProviderSublayerDetails::setName ( const QString & name )

inline

Sets the layer's name.

See also: name()

Definition at line 144 of file qgsprovidersublayerdetails.h.

◆ setPath()

void QgsProviderSublayerDetails::setPath ( const QStringList & path )

inline

Sets the path to the sublayer.

This is an internal path, relative to the dataset itself. It can be used to encapsulate the hierarchy of a dataset which organises layers in schemas or in an internal folder structure.