Contains properties which set the rendering behavior for the contents of a map or scene as they are loaded. More...
Header: | #include <LoadSettings.h> |
Since: | Esri::ArcGISRuntime 100.2 |
Inherits: | Esri::ArcGISRuntime::Object |
Public Functions
LoadSettings(QObject *parent = nullptr) | |
virtual | ~LoadSettings() override |
Esri::ArcGISRuntime::FeatureRequestMode | featureRequestMode() const |
Esri::ArcGISRuntime::FeatureServiceSessionType | featureServiceSessionType() const |
Esri::ArcGISRuntime::FeatureTilingMode | featureTilingMode() const |
bool | isUseAdvancedSymbology() const |
Esri::ArcGISRuntime::FeatureRenderingMode | preferredPointFeatureRenderingMode() const |
Esri::ArcGISRuntime::FeatureRenderingMode | preferredPolygonFeatureRenderingMode() const |
Esri::ArcGISRuntime::FeatureRenderingMode | preferredPolylineFeatureRenderingMode() const |
void | setFeatureRequestMode(Esri::ArcGISRuntime::FeatureRequestMode featureRequestMode) |
void | setFeatureServiceSessionType(Esri::ArcGISRuntime::FeatureServiceSessionType featureServiceSessionType) |
void | setFeatureTilingMode(Esri::ArcGISRuntime::FeatureTilingMode featureTilingMode) |
void | setPreferredPointFeatureRenderingMode(Esri::ArcGISRuntime::FeatureRenderingMode renderingMode) |
void | setPreferredPolygonFeatureRenderingMode(Esri::ArcGISRuntime::FeatureRenderingMode renderingMode) |
void | setPreferredPolylineFeatureRenderingMode(Esri::ArcGISRuntime::FeatureRenderingMode renderingMode) |
void | setUseAdvancedSymbology(bool useAdvancedSymbology) |
Detailed Description
There are two alternative work flows for using LoadSettings. The first is useful for setting the same settings on more that one map or scene, for example:
LoadSettings* loadSettings = new LoadSettings(this); loadSettings->setPreferredPointFeatureRenderingMode(FeatureRenderingMode::Dynamic); loadSettings->setPreferredPolylineFeatureRenderingMode(FeatureRenderingMode::Dynamic); loadSettings->setPreferredPolygonFeatureRenderingMode(FeatureRenderingMode::Dynamic); Map* map1 = new Map(this); Map* map2 = new Map(this); map1->setLoadSettings(loadSettings); map2->setLoadSettings(loadSettings);
The second is useful for modifying the default settings on a map or scene, for example:
Scene* scene = new Scene(this); scene->loadSettings()->setPreferredPointFeatureRenderingMode(FeatureRenderingMode::Dynamic);
Relevant samples:
- Feature layer rendering mode (map): Render features statically or dynamically by setting the feature layer rendering mode.
- Feature layer rendering mode (scene): Render features in a scene statically or dynamically by setting the feature layer rendering mode.
Member Function Documentation
[explicit]
LoadSettings::LoadSettings (QObject *parent = nullptr)
Constructs a new load settings instance with default values.
- parent Parent object.
[override virtual]
LoadSettings::~LoadSettings ()
Destructor.
[since Esri::ArcGISRuntime 100.9]
Esri::ArcGISRuntime::FeatureRequestMode LoadSettings::featureRequestMode () const
Returns the request mode to use for requesting features. Default is FeatureRequestMode::onInteractionCache
.
This function was introduced in Esri::ArcGISRuntime 100.9.
See also setFeatureRequestMode().
[since Esri::ArcGISRuntime 100.10]
Esri::ArcGISRuntime::FeatureServiceSessionType LoadSettings::featureServiceSessionType () const
Returns the session type to use for branch-versioned ServiceGeodatabase objects.
Default is FeatureServiceSessionType::Transient.
This function was introduced in Esri::ArcGISRuntime 100.10.
See also setFeatureServiceSessionType().
[since Esri::ArcGISRuntime 100.10]
Esri::ArcGISRuntime::FeatureTilingMode LoadSettings::featureTilingMode () const
Returns the feature tiling mode in use. Sets the feature tiling mode of each feature layer that is loaded. Default is FeatureTilingMode::EnabledWhenSupported. Changes how feature tiling is handled by each feature layer. Individual feature layers can override these settings.
This function was introduced in Esri::ArcGISRuntime 100.10.
See also setFeatureTilingMode().
bool LoadSettings::isUseAdvancedSymbology () const
Gets whether a web map should use advanced symbology.
This must be set prior to loading a web map and will use the simple or advanced symbol REST endpoint for the feature service.
The default return value is true
.
Esri::ArcGISRuntime::FeatureRenderingMode LoadSettings::preferredPointFeatureRenderingMode () const
Gets the preferred rendering mode for point and multi-point based feature layers.
The default value is FeatureRenderingMode::Automatic.
See also setPreferredPointFeatureRenderingMode().
Esri::ArcGISRuntime::FeatureRenderingMode LoadSettings::preferredPolygonFeatureRenderingMode () const
Gets the preferred rendering mode for polygon based feature layers.
The default value is FeatureRenderingMode::Automatic.
See also setPreferredPolygonFeatureRenderingMode().
Esri::ArcGISRuntime::FeatureRenderingMode LoadSettings::preferredPolylineFeatureRenderingMode () const
Gets the preferred rendering mode for polyline based feature layers.
The default value is FeatureRenderingMode::Automatic.
See also setPreferredPolylineFeatureRenderingMode().
[since Esri::ArcGISRuntime 100.9]
void LoadSettings::setFeatureRequestMode (Esri::ArcGISRuntime::FeatureRequestMode featureRequestMode )
Sets the featureRequestMode to featureRequestMode.
This function was introduced in Esri::ArcGISRuntime 100.9.
See also featureRequestMode.
[since Esri::ArcGISRuntime 100.10]
void LoadSettings::setFeatureServiceSessionType (Esri::ArcGISRuntime::FeatureServiceSessionType featureServiceSessionType )
Sets the featureServiceSessionType to featureServiceSessionType.
This function was introduced in Esri::ArcGISRuntime 100.10.
See also featureServiceSessionType.
[since Esri::ArcGISRuntime 100.10]
void LoadSettings::setFeatureTilingMode (Esri::ArcGISRuntime::FeatureTilingMode featureTilingMode )
Sets the featureTilingMode to featureTilingMode.
This function was introduced in Esri::ArcGISRuntime 100.10.
See also featureTilingMode.
void LoadSettings::setPreferredPointFeatureRenderingMode (Esri::ArcGISRuntime::FeatureRenderingMode renderingMode )
Sets the preferred rendering mode for point and multi-point based feature layers to renderingMode.
The layer will attempt to render in the specified mode if it is supported. If for example FeatureRenderingMode::Dynamic is not supported by a layer's Renderer, then it will fall back to rendering in FeatureRenderingMode::Static mode.
See also preferredPointFeatureRenderingMode().
void LoadSettings::setPreferredPolygonFeatureRenderingMode (Esri::ArcGISRuntime::FeatureRenderingMode renderingMode )
Sets the preferred rendering mode for polygon based feature layers to renderingMode.
The layer will attempt to render in the specified mode if it is supported. If for example FeatureRenderingMode::Dynamic is not supported by a layer's Renderer, then it will fall back to rendering in FeatureRenderingMode::Static mode.
See also preferredPolygonFeatureRenderingMode().
void LoadSettings::setPreferredPolylineFeatureRenderingMode (Esri::ArcGISRuntime::FeatureRenderingMode renderingMode )
Sets the preferred rendering mode for polyline based feature layers to renderingMode.
The layer will attempt to render in the specified mode if it is supported. If for example FeatureRenderingMode::Dynamic is not supported by a layer's Renderer, then it will fall back to rendering in FeatureRenderingMode::Static mode.
See also preferredPolylineFeatureRenderingMode().
void LoadSettings::setUseAdvancedSymbology (bool useAdvancedSymbology )
Sets whether a web map should use advanced symbology to useAdvancedSymbology.
This must be set prior to loading a web map and will use the simple or advanced symbol REST endpoint for the feature service.
See also isUseAdvancedSymbology().