ArcGIS Pro 3.7 API Reference Guide
ArcGIS.Desktop.Mapping Namespace / SelectionCombinationMethod Enumeration
Example Example

In This Topic
    SelectionCombinationMethod Enumeration
    In This Topic
    Define combination methods for selection operations. They determine how the selection performed will combine with an existing selection.
    Syntax
    Members
    MemberDescription
    Add Adds to the current selection.
    And Selects from the current selection.
    New Creates a new selection.
    Subtract Subtracts from the current selection.
    XOR Performs an 'exclusive or' with the current selection.
    Example
    Get/Set Selection Options
    {
        var options = ApplicationOptions.SelectionOptions;
        //Note: Run within a QueuedTask
        var defaultColor = options.DefaultSelectionColor;
        //Set the selection color to red
        var color = options.SelectionColor as CIMRGBColor;
        options.SetSelectionColor(ColorFactory.Instance.CreateRGBColor(255, 0, 0));
    
        //Set the selection fill color and fill hatch
        var defaultFill = options.DefaultSelectionFillColor;
        var fill = options.SelectionFillColor;
        var isHatched = options.IsSelectionFillHatched;
        options.SetSelectionFillColor(ColorFactory.Instance.CreateRGBColor(100, 100, 0));
        if (!isHatched)
            options.SetSelectionFillIsHatched(true);
        //Toggle the selection Chip and Graphic
        var showSelectionChip = options.ShowSelectionChip;
        options.SetShowSelectionChip(!showSelectionChip);
    
        var showSelectionGraphic = options.ShowSelectionGraphic;
        options.SetShowSelectionGraphic(!showSelectionGraphic);
    
        //Get the value indicating whether to save the layer and standalone table selection with the map.
        var saveSelection = options.SaveSelection;
        options.SetSaveSelection(!saveSelection);
        //Get/Set the selection tolerance
        var defaultTol = options.DefaultSelectionTolerance;
        var tol = options.SelectionTolerance;
        options.SetSelectionTolerance(2 * defaultTol);
    
        // extension methods available for selection methods and combination methods
        var selMethod = options.SelectionMethod;
        options.SetSelectionMethod(SelectionMethod.Contains);
    
        var combMethod = options.CombinationMethod;
        options.SetCombinationMethod(SelectionCombinationMethod.Add);
    
        // note that the following SelectionCombinationMethod is not supported
        //options.SetCombinationMethod(SelectionCombinationMethod.XOR);
    }
    Spatial selection of elements in all Graphics Layers
    //Map Tool is used to perform Spatial selection.
    //Graphic selection uses the selection geometry 
    //to intersect the geometries of those elements (graphic or group) 
    //that will be selected and then highlights them. 
    {
      var selPoly = geometry as Polygon;
      // Note: must be called on the QueuedTask
      {
        //note: the selected elements may belong to more than one layer...
        var elems = MapView.Active.SelectElements(selPoly, SelectionCombinationMethod.New);
      }
    }
    Spatial selection of elements in one graphics layer
    {
      // Note: must be called on the QueuedTask
      {
        //Create an extent to use for the spatial selection
        var extent = MapView.Active.Extent;
        var selectionExtent = extent.Expand(0.5, 0.5, true);
        //Select elements in specified graphics layer using the selection extent.
        var selectedElements = MapView.Active.SelectElements(graphicsLayer, selectionExtent, SelectionCombinationMethod.Add);
      }
    }
    Select Text Graphic Elements
    {
      var all_text = graphicsLayer.GetElementsAsFlattenedList()
                    .Where(e => e.GetGraphic() is CIMTextGraphic);
    }
    Inheritance Hierarchy

    System.Object
       System.ValueType
          System.Enum
             ArcGIS.Desktop.Mapping.SelectionCombinationMethod

    Requirements

    Target Platforms: Windows 11 Home, Pro, Enterprise (64 bit)

    ArcGIS Pro version: 3.0 or higher.
    See Also