Exclude map layers from SetClipGeometry

Question

There is an example of clipping map layers to a polygon in the ProSnippets for Map Authoring using the SetClipGeometry method. Is there also an API to exclude map layers from the clipping? The ArcGIS Pro map Clip Layers tab provides this capability.

NarelleChedzey · Accepted Answer

Hi Lesley, Unfortunately there is no SetClipGeometry method that allows you to exclude map layers from a clip geometry. However there is a property on the CIMMap object that allows you to specify the layers. The property is called LayersExcludedFromClipping.

Here's a small sample of how you would use it.

      // find the first layer in the map
      var layer = MapView.Active.Map.GetLayersAsFlattenedList().FirstOrDefault();
      if (layer == null)
        return;

      // create a list of strings
      List layerUris = new List();
      // add the layer URI to the list
      layerUris.Add(layer.URI);

      QueuedTask.Run(() =>
      {
        // create a polygon from the current extent
        var poly = PolygonBuilder.CreatePolygon(MapView.Active.Extent);

        // set the clip geometry
        MapView.Active.Map.SetClipGeometry(poly, null);

        // get the map definition
        var mapDef = MapView.Active.Map.GetDefinition();
        // assign the layers to be excluded 
        mapDef.LayersExcludedFromClipping = layerUris.ToArray();
        // set the map definition
        MapView.Active.Map.SetDefinition(mapDef);
      });

 

Let me know if you have any questions.

We'll update the SetClipGeometry method to include the option to exclude layers in a future release. 

 

Thanks

Narelle