ArcGIS Developers

SubtypeFeatureLayer QML Type

A layer that can visualize feature data with different visibility, rendering, popup properties, and so on for some or all of the FeatureSubtype in an ArcGISFeatureTable. More...

Import Statement: import Esri.ArcGISRuntime 100.10
Since: Esri::ArcGISRuntime 100.7





Detailed Description

The ArcGISFeatureTable must have a ArcGISFeatureLayerInfo::subtypeField defined, and at least one FeatureSubtype defined; otherwise the layer will fail to load.

Subtypes provide a way to organize your data within an ArcGIS feature table. For example, the streets in a city-streets feature table could be categorized into three subtypes: local streets, collector streets, and arterial streets. The benefit of the subtype feature layer is that it lets you configure different layer properties per subtype. This is particularly useful for data, such as utility networks, in which many different network elements are grouped into a single subtype feature layer.

Functional characteristics

The subtype feature layer acts like a group layer that automatically creates one feature layer, or subtype sublayer, for each subtype in the table. Each subtype sublayer can be configured independently of one another. They can have different renderers, label definitions, max and min scales, visibility, layer order in the map, and so on. When a subtype group layer is read from a web map or mobile map, it is represented as a SubtypeFeatureLayer. Saving a map that contains a SubtypeFeatureLayer will save the layer as a subtype group layer. Subtype feature layers are supported in offline maps and will work in offline editing workflows.

Performance characteristics

Queries are optimized across all sublayers. For example, a pan of the map sends a single request to the feature table to cover all the sublayers. If you had manually created a feature layer for each subtype, this would have resulted in one query per feature layer.

See sample: Display subtype feature layer

SubtypeFeatureLayer {
    id: subtypeFeatureLayer
    ServiceFeatureTable {
        url: ""

See also FeatureLayer.

Property Documentation

subtypeSublayers : SubtypeSublayerListModel

Returns the list model of SubtypeSublayer in the SubtypeFeatureLayer.

The objects in this collection are the same objects in LayerContent::subLayerContents. The difference between the two collections is this collection is modifiable so the layer order is configurable.

Signal Documentation


Emitted when the subtypeSublayers property changes.

Note: The corresponding handler is onSubtypeSublayersChanged.

Method Documentation

SubtypeSublayer sublayerWithSubtypeCode(var code)

Finds a SubtypeSublayer for a feature subtype based on the code.

When working with a particular ArcGISFeature, the FeatureSubtype.code is the value of the ArcGISFeatureLayerInfo::subtypeField field. The corresponding SubtypeSublayer can be found using the value of that field.

SubtypeSublayer sublayerWithSubtypeName(string name)

Finds a SubtypeSublayer for a feature subtype based on the subtype name.

Feedback on this topic?