Class: QgsProviderSublayerDetails¶
- class qgis.core.QgsProviderSublayerDetails¶
Bases:
sip.wrapper
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 GeoPDF 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 aQgsProviderSubLayerDetails
instance.New in version 3.22:
Methods
Returns the layer's description.
Returns the layer's driver name.
Returns the layer's feature count.
Returns the layer's flags, which indicate properties of the layer.
Returns the layer's geometry column name, or an empty string if not applicable.
Returns the associated layer number, for providers which order sublayers.
Returns the layer's name.
Returns the path to the sublayer.
Returns the associated data provider key.
Sets the layer's
description
.Sets the layer's
driver
name.Sets the layer's feature
count
.Sets the layer's
flags
, which indicate properties of the layer.Sets the layer's geometry column
name
.Sets the associated layer
number
, for providers which order sublayers.Sets the layer's
name
.Sets the
path
to the sublayer.Sets the associated data provider key.
Set to
True
if the layer is a potential dataset container and an in-depth scan of its contents was skipped.Sets the layer
type
.Sets the layer's
uri
.Set the layer's WKB
type
.Returns
True
if the layer is a potential dataset container and an in-depth scan of its contents was skipped.Creates a new
QgsMapLayer
object associated with the sublayer.Returns the layer type.
Returns the layer's URI.
Returns the layer's WKB type, or
QgsWkbTypes
.Unknown if the WKB type is not application or unknown.- class LayerOptions(transformContext: QgsCoordinateTransformContext)¶
Bases:
sip.wrapper
Constructor for LayerOptions with
transformContext
.QgsProviderSublayerDetails.LayerOptions(QgsProviderSublayerDetails.LayerOptions)
- loadDefaultStyle¶
- transformContext¶
- description(self) str ¶
Returns the layer’s description.
See also
- Return type
str
- driverName(self) str ¶
Returns the layer’s driver name.
This is supported only for providers which handle multiple drivers.
See also
- Return type
str
- featureCount(self) int ¶
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
- Return type
int
- flags(self) Qgis.SublayerFlags ¶
Returns the layer’s flags, which indicate properties of the layer.
See also
- Return type
- geometryColumnName(self) str ¶
Returns the layer’s geometry column name, or an empty string if not applicable.
See also
- Return type
str
- layerNumber(self) int ¶
Returns the associated layer number, for providers which order sublayers.
See also
- Return type
int
- path(self) List[str] ¶
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
- Return type
List[str]
- providerKey(self) str ¶
Returns the associated data provider key.
See also
- Return type
str
- setDescription(self, description: str)¶
Sets the layer’s
description
.See also
- Parameters
description (str) –
- setDriverName(self, driver: str)¶
Sets the layer’s
driver
name.See also
- Parameters
driver (str) –
- setFeatureCount(self, count: int)¶
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
- Parameters
count (int) –
- setFlags(self, newFlags: Union[Qgis.SublayerFlags, Qgis.SublayerFlag])¶
Sets the layer’s
flags
, which indicate properties of the layer.See also
- Parameters
newFlags (Union[Qgis.SublayerFlags) –
- setGeometryColumnName(self, name: str)¶
Sets the layer’s geometry column
name
.Set to an empty string if not applicable.
See also
- Parameters
name (str) –
- setLayerNumber(self, number: int)¶
Sets the associated layer
number
, for providers which order sublayers.See also
- Parameters
number (int) –
- setPath(self, path: Iterable[str])¶
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.
See also
- Parameters
path (Iterable[str]) –
- setProviderKey(self, key: str)¶
Sets the associated data provider key.
See also
- Parameters
key (str) –
- setSkippedContainerScan(self, skipped: bool)¶
Set to
True
if the layer is a potential dataset container and an in-depth scan of its contents was skipped.See also
- Parameters
skipped (bool) –
- setType(self, type: QgsMapLayerType)¶
Sets the layer
type
.See also
- Parameters
type (QgsMapLayerType) –
- setWkbType(self, type: QgsWkbTypes.Type)¶
Set the layer’s WKB
type
.Set to
QgsWkbTypes
.Unknown if the WKB type is not application or unknown.See also
- Parameters
type (QgsWkbTypes.Type) –
- skippedContainerScan(self) bool ¶
Returns
True
if the layer is a potential dataset container and an in-depth scan of its contents was skipped.See also
- Return type
bool
- toLayer(self, options: QgsProviderSublayerDetails.LayerOptions) QgsMapLayer ¶
Creates a new
QgsMapLayer
object associated with the sublayer.Caller takes ownership of the returned layer.
- Parameters
options (QgsProviderSublayerDetails.LayerOptions) –
- Return type
- type(self) QgsMapLayerType ¶
Returns the layer type.
See also
- Return type
- wkbType(self) QgsWkbTypes.Type ¶
Returns the layer’s WKB type, or
QgsWkbTypes
.Unknown if the WKB type is not application or unknown.See also
- Return type