The Editor object can be used to perform selection, draw and edit of graphics in a feature layer and graphics layer. The Editor requires the Map property to be set, and optionally a set of LayerIDs to work against, otherwise all GraphicsLayers are active for editing.

Editing is performed by executing an System.Windows.Input.ICommand on the Editor. The following commands are supported by the Editor:

Use the System.Windows.Input.ICommand.CanExecute(System.Object) method to verify if an action can be executed. Based on the current selection and other Editor settings some actions might not be executable. For instance, you cannot perform a union if only one graphic is selected. Selection on a GraphicsLayer is only supported using a point or rectangle, while all selection modes are available on FeatureLayer. If the GeometryServiceUrl is not set, commands that require this service will not be available. A read-only FeatureLayer will only support selection, no editing.

You can have any number of Editors associated with a map. If one Editor's command becomes active, it will cancel any other Editor's currently working on the map. This will prevent the user from adding and selecting features at the same time. Note: Only commands requiring user input will cancel other commands. For example, clicking save will not cancel a draw currently in progress.

Some command takes an additional CommandParameter to control the command. For example Select has an optional parameter to choose whether the user wants to Add or Remove features to the current selection. Similarly Add requires a specific template or type id for drawing on a FeatureLayer, but a ESRI.ArcGIS.Client.Symbols.Symbol for drawing on a GraphicsLayer. See the individual command reference for more detail on command parameters.

Controls can implement their own handling of ICommand. For example, a control can listen to the System.Windows.Input.ICommand.CanExecuteChanged event and change its enable or visibility state. System.Windows.Controls.Primitives.ButtonBase and Hyperlink already implement commanding and will change their IsEnabled state based on whether the command can execute. As a result, the developer does not have to update the button state explicity when the Editor or a layer changes.

            <Border>
              <Border.Resources>
                <esri:Editor x:Key="editor" Map="{Binding ElementName=MyMap}" LayerIDs="myFeatureLayer"  />
              </Border.Resources>
              <StackPanel Orientation="Horizontal" DataContext="{StaticResource editor}">
                <Button Content="Select" Command="{Binding Select}" CommandParameter="New" />
                <Button Content="Add Selection" Command="{Binding Select}" CommandParameter="Add" />
                <Button Content="Unselect" Command="{Binding Select}" CommandParameter="Remove" />
                <Button Content="Clear Selection" Command="{Binding ClearSelection}" />
                <Button Content="Add Default" Command="{Binding Add}" />
                <Button Content="Add MyFeatureType" Command="{Binding Add}" CommandParameter="MyFeatureTemplate" />
                <Button Content="Delete Selected" Command="{Binding DeleteSelected}" />
                <CheckBox IsChecked="{Binding Path=Freehand, Mode=TwoWay}" Content="Freehand Draw" VerticalAlignment="Center" />
              </StackPanel>
            </Border>
            

To see a visual change to a ESRI.ArcGIS.Client.Symbols.Symbol when its selected, it must have a Selected state defined. The simple symbols included with the ArcGIS API for Silverlight/WPF do not include a selected state. However symbols created using definitions provided by an ArcGIS Server REST feature service will include a selected state.

Whenever an action completes, the Editor.EditCompleted event is fired. Use the Editor.ActionEventArgs.Action to perform additional logic when an operation completes.

The Editor is able to work on multiple layers at the same time. Be aware of using AutoSelect on some of the commands like union and reshape when working with multiple layers. The AutoSelect feature may cause the user to edit features in layers they didn't intend to (note that union won't union features across layers, but will union features together within it). A good approach to avoid this issue, is using a System.Windows.Controls.ComboBox to select the layer the user wants to perform edits on, and set the LayerIDs property when the user selects a layer in the ComboBox.

System.Object
   System.Windows.DependencyObject
      ESRI.ArcGIS.Client.Editor

Target Platforms: Windows Vista, Windows 7

Reference