Class LoadSettings


  • public final class LoadSettings
    extends Object
    Contains properties which set the rendering behaviour for a map or scene as it loads.

    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();
     loadSettings.setPreferredPointFeatureRenderingMode(FeatureLayer.RenderingMode.DYNAMIC);
     loadSettings.setPreferredPolylineFeatureRenderingMode(FeatureLayer.RenderingMode.DYNAMIC);
     loadSettings.setPreferredPolygonFeatureRenderingMode(FeatureLayer.RenderingMode.DYNAMIC);
     ArcGISMap map1 = new ArcGISMap();
     ArcGISMap map2 = new ArcGISMap();
     map1.setLoadSettings(loadSettings);
     map2.setLoadSettings(loadSettings);
     
    The second is useful for modifying the default settings on one map or scene, for example:
     ArcGISScene scene = new ArcGISScene();
     scene.getLoadSettings().setPreferredPointFeatureRenderingMode(FeatureLayer.RenderingMode.DYNAMIC);
     
    Since:
    100.2.0
    • Constructor Detail

      • LoadSettings

        public LoadSettings()
        Creates a new load settings instance with default values.
        Since:
        100.2.0
    • Method Detail

      • setPreferredPointFeatureRenderingMode

        public void setPreferredPointFeatureRenderingMode​(FeatureLayer.RenderingMode renderingMode)
        Sets the preferred rendering mode for point and multi-point based feature layers. The layer will attempt to render in the specified mode if this is supported. If for example DYNAMIC is not supported by a layer's renderer then it will fall back to rendering in STATIC mode.
        Parameters:
        renderingMode - the preferred rendering mode
        Throws:
        IllegalArgumentException - if renderingMode is null
        Since:
        100.2.0
      • getPreferredPointFeatureRenderingMode

        public FeatureLayer.RenderingMode getPreferredPointFeatureRenderingMode()
        Gets the preferred rendering mode for point and multi-point based feature layers. The default value is AUTOMATIC.
        Returns:
        the preferred rendering mode for point and multi-point based feature layers
        Since:
        100.2.0
      • setPreferredPolylineFeatureRenderingMode

        public void setPreferredPolylineFeatureRenderingMode​(FeatureLayer.RenderingMode renderingMode)
        Sets the preferred rendering mode for polyline based feature layers. The layer will attempt to render in the specified mode if this is supported. If for example DYNAMIC is not supported by a layer's renderer then it will fall back to rendering in STATIC mode.
        Parameters:
        renderingMode - the preferred rendering mode
        Throws:
        IllegalArgumentException - if renderingMode is null
        Since:
        100.2.0
      • getPreferredPolylineFeatureRenderingMode

        public FeatureLayer.RenderingMode getPreferredPolylineFeatureRenderingMode()
        Gets the preferred rendering mode for polyline based feature layers. The default value is AUTOMATIC.
        Returns:
        the preferred rendering mode for polyline based feature layers
        Since:
        100.2.0
      • setPreferredPolygonFeatureRenderingMode

        public void setPreferredPolygonFeatureRenderingMode​(FeatureLayer.RenderingMode renderingMode)
        Sets the preferred rendering mode for polygon based feature layers. The layer will attempt to render in the specified mode if this is supported. If for example DYNAMIC is not supported by a layer's renderer then it will fall back to rendering in STATIC mode.
        Parameters:
        renderingMode - the preferred rendering mode
        Throws:
        IllegalArgumentException - if renderingMode is null
        Since:
        100.2.0
      • getPreferredPolygonFeatureRenderingMode

        public FeatureLayer.RenderingMode getPreferredPolygonFeatureRenderingMode()
        Gets the preferred rendering mode for polygon based feature layers. The default value is AUTOMATIC.
        Returns:
        the preferred rendering mode for polygon based feature layers
        Since:
        100.2.0
      • isUseAdvancedSymbology

        public boolean isUseAdvancedSymbology()
        Gets whether service feature tables will use advanced symbology.
        Returns:
        true if the tables will use advanced symbology, false otherwise
        Since:
        100.2.0
      • setUseAdvancedSymbology

        public void setUseAdvancedSymbology​(boolean useAdvancedSymbology)
        Sets whether service feature tables will use advanced symbology. If the tables are already loaded this setting will have no effect. The default is true.
        Parameters:
        useAdvancedSymbology - true for tables to use advanced symbology, false for simple symbology
        Since:
        100.2.0