Beginning Editing and Editing UI Patterns. Thomas Emge Narelle Chedzey

Transcription

1 Beginning Editing and Editing UI Patterns Thomas Emge Narelle Chedzey

2 ArcGIS.Desktop.Editing API Create custom construction tools and sketch tools - Construction tools create new features - Sketch tools modify the geometry or attributes of existing features Contains Inspector class for streamlined attribute editing Provides access to edit templates Annotation support Edit Operations and Edit events

3 Edit Operations All data manipulation should be executed as part of an edit operation. - Adds to the undo / redo stack. An edit operation can encapsulate multiple edits. Methods to Create, Modify, Delete, Cut, Clip, Explode, Reshape, Rotate // Create an edit operation var createoperation = new EditOperation(); createoperation.name = "My first edit"; var template = ArcGIS.Desktop.Editing.Templates.EditingTemplate.Current; // Queue feature creation createoperation.create(template, geometry); createoperation.create(template, anothergeometry); // Execute the operation return createoperation.executeasync();

4 Edit Operations Can provide return values Can create chained operations that link to previous edit operations. - Chained group of edits are dependent on the results of a previous operation being committed - Both operations become part of the same undo / redo item. // Variable to store the Object ID of the newly created feature long new_oid = -1; var editop = new EditOperation(); editop.name = "Create new facility record"; // this is what shows up as the undo/redo editop.create(currenttemplate, geometry, oid => new_oid = oid); //capture oid if (editop.execute()) { //create succeeded so chain a new operation to add the attachment var chained_op = editop.createchainedoperation(); chained_op.addattachment(facilities, chained_op.execute();

5 Construction Tool internal class SimpleConstructionTool : MapTool { public SimpleConstructionTool () Bullet points here { IsSketchTool = true; UseSnapping = true; SketchType = SketchGeometryType.Point; /// Called when the sketch finishes. This is where we will create the sketch operation and then execute it. protected override Task<bool> OnSketchCompleteAsync(Geometry geometry) { if (CurrentTemplate == null geometry == null) return Task.FromResult(false); // Create an edit operation var createoperation = new EditOperation(); createoperation.name = string.format("create {0", CurrentTemplate.Layer.Name); createoperation.selectnewfeatures = true; createoperation.create(currenttemplate, geometry); return createoperation.executeasync();

6 Construction Tool (continued) <controls> <tool id="simpleconstructiontool" categoryrefid="esri_editing_construction_point" caption="simpleconstructiontool" classname="simpleconstructiontool" loadonclick="true" smallimage="images\genericbuttonred16.png" largeimage="images\genericbuttonred32.png"> <tooltip heading="arcgis Pro SDK">Default construction tool.<disabledtext /></tooltip> </tool> <controls> Change construction tool type by modifying the DAML categoryrefid (geometry type of destination feature class). Supported categories are - esri_editing_construction_point - esri_editing_construction_polyline - esri_editing_construction_polygon - esri_editing_construction_multipoint - esri_editing_construction_annotation

7 Construction Tool with Options Add an EmbeddableControl. Update daml - embeddable control is registered with "esri_editing_tool_options - Add tooloptionsid attribute to content tag for tool <controls> <tool id="constructiontoolwithoptions_bufferedlinetool" categoryrefid="esri_editing_construction_polygon" caption="buffered Line" classname="bufferedlinetool" loadonclick="true" smallimage="images\genericbuttonred16.png" largeimage="images\genericbuttonred32.png" > <tooltip heading="buffered Line">Create a polygon with a fixed buffer.<disabledtext /></tooltip> <content tooloptionsid="constructiontoolwithoptions_bufferedlinetooloptions" /> </tool> </controls> <categories> <updatecategory refid="esri_editing_tool_options"> <insertcomponent id="constructiontoolwithoptions_bufferedlinetooloptions" classname="bufferedlinetooloptionsviewmodel"> <content classname="bufferedlinetooloptionsview" /> </insertcomponent> </updatecategory> </categories>

8 Construction Tool with Options ViewModel file - Implement IEditingCreateToolControl - InitializeForActiveTemplate, InitializeForTemplateProperties methods provide a ToolOptions variable dictionary of option values private ToolOptions ToolOptions { get; set; /// <summary> /// Called just before ArcGIS.Desktop.Framework.Controls.EmbeddableControl.OpenAsync /// when this IEditingCreateToolControl is being used within the ActiveTemplate pane. /// </summary> /// <returns>true if the control is to be displayed in the ActiveTemplate pane.. False otherwise</returns> bool IEditingCreateToolControl.InitializeForActiveTemplate(ToolOptions options) { // assign the current options ToolOptions = options; // initialize the view InitializeOptions(); return true; // true <==> do show me in ActiveTemplate; false <==> don't show me

9 Construction Tool with Options ViewModel file - View elements bind to properties in the ViewModel which add or update values to ToolOptions // binds in xaml private double _buffer; public double Buffer { get { return _buffer; set { if (SetProperty(ref _buffer, value)) { _isdirty = true; // add/update the buffer value to the tool options if (!ToolOptions.ContainsKey(BufferOptionName)) ToolOptions.Add(BufferOptionName, value); else ToolOptions[BufferOptionName] = value; // ensure options are notified NotifyPropertyChanged(BufferOptionName);

10 Construction Tool with Options Tool file - Get options from the CurrentTemplate and use within the OnSketchCompleteAsync private ReadOnlyToolOptions ToolOptions => CurrentTemplate?.GetToolOptions(ID); private double defaultbuffer = 20; private double BufferDistance => (ToolOptions == null)? defaultbuffer : ToolOptions.GetProperty("BufferDistance", defaultbuffer); protected override Task<bool> OnSketchCompleteAsync(Geometry geometry) { // Create an edit operation... // create the buffered geometry Geometry bufferedgeometry = GeometryEngine.Instance.Buffer(geometry, BufferDistance); // Queue feature creation createoperation.create(currenttemplate, bufferedgeometry); // Execute the operation return createoperation.executeasync();

11 Demo Demo 1 Construction Tools with options

12 Sketch Tool <controls> <tool id="inspectortool_useinspectortool" caption="select Inspector Tool" loadonclick="true" classname= UseInspectorTool" largeimage="images\genericbuttonred32.png"> <tooltip heading="inspector Tool">Select point features and explore/modify the attributes.<disabledtext /></tooltip> </tool> </controls> internal class UseInspectorTool : MapTool { public UseInspectorTool () { IsSketchTool = true; SketchType = SketchGeometryType.Rectangle; SketchOutputMode = SketchOutputMode.Map; // Called when the sketch finishes. protected override Task<bool> OnSketchCompleteAsync(Geometry geometry) { //Run on MCT return QueuedTask.Run(() => { // TODO - perform the sketch operation

13 SketchTool (continued) To add the sketch tool to the Modify Features pane - Set CategoryRefID attribute to esri_editing_commandlist - Set group attribute in content element <controls> <tool id="inspectortool_useinspectortool" caption="select Inspector Tool" loadonclick="true" classname= UseInspectorTool" smallimage="images\genericbuttonred16.png" largeimage="images\genericbuttonred32.png" categoryrefid="esri_editing_commandlist"> <tooltip heading="inspector Tool">Select point features and explore/ modify the attributes.<disabledtext /></tooltip> <content L_group="Pro SDK Samples" /> </tool> </controls>

14 SketchTool (continued) To add the sketch tool to the Edit Tools gallery - Set values for gallery2d and gallery3d attributes in content element <controls> <tool id="inspectortool_useinspectortool" caption="select Inspector Tool" loadonclick="true" classname= UseInspectorTool" smallimage="images\genericbuttonred16.png" largeimage="images\genericbuttonred32.png" categoryrefid="esri_editing_commandlist"> <tooltip heading="inspector Tool">Select point features and explore/ modify the attributes.<disabledtext /></tooltip> <content L_group="Pro SDK Samples" gallery2d="true" gallery3d="false"/> </tool> </controls>

15 SketchTool (Embedding UI into Modify Features pane) MapTool class has properties for specifying WPF User controls - ControlID sets the DAML-ID for an Embedded control - EmbeddableControl retrieves the ViewModel

16 SketchTool (Embedding UI into Modify Features pane) Add an ArcGIS Pro Embeddable Control template in your add-in. - Updates the esri_embeddablecontrols category in Config.daml - DAML follows Pro MVVM pattern <categories> <updatecategory refid="esri_embeddablecontrols"> <insertcomponent id="inspectortool_attributecontrol" classname="attributecontrolviewmodel"> <content classname="attributecontrolview" /> </insertcomponent> </updatecategory> </categories> Set the ControlID property to the id. public UseInspectorTool() : base() { IsSketchTool = true; SketchType = SketchGeometryType.Rectangle; SketchOutputMode = SketchOutputMode.Map; ControlID = "InspectorTool_AttributeControl";

17 SketchTool (Embedding UI into Modify Features pane) Access the ViewModel and set or retrieve properties. private void UpdateEmbeddableControl(string sometext) { if (_vm == null) { _vm = this.embeddablecontrol as SketchToolControlViewModel; vm.thetext = sometext;

18 Inspector Access and update attributes. Get schema information about a layer. Use as Embeddable control - Corresponds to control on Attributes window.

19 Inspector Update Attributes QueuedTask.Run(() => { //Get the geometry of the selected feature. var selectedfeatures = MapView.Active.Map.GetSelection(); var theinspector = new Inspector(); theinspector.load(selectedfeatures.keys.first(), selectedfeatures.values.first()); var selgeom = theinspector.shape; //var extpolyline = do some geometry operation. //Set the new geometry back on the feature theinspector.shape = extpolyline; //Update an attribute value theinspector["routenumber"] = 42; //Create and execute the edit operation var op = new EditOperation(); op.name = "Extend"; op.modify(theinspector); op.execute(); );

20 Inspector Update Attributes (continued) QueuedTask.Run(() => { //Get the geometry of the selected feature. var selectedfeatures = MapView.Active.Map.GetSelection(); var theinspector = new Inspector(); theinspector.load(selectedfeatures.keys.first(), selectedfeatures. Values.First()); //Update an attribute value theinspector["routenumber"] = 42; //Apply the changes through the inspector (internally uses an EditOperation) theinspector.apply(); );

21 Inspector Schema Information // Retrieve the first feature layer from the selected layers in the TOC FeatureLayer featurelayer = MapView.Active.GetSelectedLayers().OfType<FeatureLayer>().FirstOrDefault(); // Create the inspector object and load the layer schema information var theinspector = new Inspector(); theinspector.loadschema(featurelayer); IEnumerable<ArcGIS.Desktop.Editing.Attributes.Attribute> attributes = theinspector; foreach (var att in attributes) { // ignore blob, raster, geometry fields if ((att.fieldtype!= ArcGIS.Core.Data.FieldType.Blob) && (att.fieldtype!= ArcGIS.Core.Data.FieldType.Raster) && (att.fieldtype!= ArcGIS.Core.Data.FieldType.Geometry)) { // att.fieldname // att.fieldalias

22 Inspector - EmbeddableControl if (_theinspector == null) { _theinspector = new Inspector(); var tuple = _theinspector.createembeddablecontrol(); _vm.inspectorview = tuple.item2; _vm.inspectorviewmodel = tuple.item1; <Grid MaxHeight="400" MaxWidth="300"> <Border BorderBrush="DarkGray" BorderThickness="2"> <DockPanel LastChildFill="true" Margin="2"> <ContentPresenter Content="{Binding InspectorView /> </DockPanel> </Border> </Grid>

23 Demo Demo 2 Sketch Tool

24 Edit Templates // get the current template var mytemplate = ArcGIS.Desktop.Editing.Templates.EditingTemplate.Current; // get templates by name ArcGIS.Desktop.Framework.Threading.Tasks.QueuedTask.Run(() => { var map = MapView.Active.Map; var maintemplate = map.findlayers("main").first().gettemplate("distribution"); var mhtemplate = map.findlayers("manhole").first().gettemplate("active"); // activate the default tool and make template current mhtemplate.activatedefaulttoolasync(); );

25 Edit Templates To create or modify templates, must use the Template Definition from the CIM Can only change persisted templates (AutoGenerateFeatureTemplates = false) //get CIM layer definition var layerdef = polygonlayer.getdefinition() as CIMFeatureLayer; // can't make anything stick if this is still true if (layerdef.autogeneratefeaturetemplates) layerdef.autogeneratefeaturetemplates = false; var mytemplatedef = new CIMFeatureTemplate(); mytemplatedef.name = "My template"; mytemplatedef.writetags(new[] { "Polygon" ); //get all templates on this layer var layertemplates = layerdef.featuretemplates.tolist(); //add the new template to the layer template list layertemplates.add(mytemplatedef); //set the layer definition templates from the list layerdef.featuretemplates = layertemplates.toarray(); //and commit polygonlayer.setdefinition(layerdef);

26 Setting a Construction Tool as the Default Tool on a Template Add a GUID for the tool in the Config.daml <controls> <tool id="simpleconstructiontool" categoryrefid="esri_editing_construction_point" caption="simpleconstructiontool" classname="simpleconstructiontool" loadonclick="true" smallimage="images\genericbuttonred16.png" largeimage="images\genericbuttonred32.png"> <tooltip heading="arcgis Pro SDK">Default construction tool.<disabledtext /></tooltip> <content guid="de7d77d b-b718-3fc0c43f6090" /> </tool> <controls> var templatedef = template.getdefinition(); templatedef.toolprogid ="DE7D77D B-B718-3FC0C43F6090 ; template.setdefinition(templatedef);

27 Edit Templates Use CIMFeatureTemplate.ToXml() of an existing template to determine structure //<CIMFeatureTemplate xsi:type="typens:cimfeaturetemplate"> // <Description>Template for Polygon 1</Description> // <Name>Polygon 1</Name> // <Tags>Polygon</Tags> // <ToolProgID>8f79967b-66a0-4a1c-b884-f44bc7e26921</ToolProgID> // <DefaultValues xsi:type="typens:propertyset"> // <PropertyArray xsi:type="typens:arrayofpropertysetproperty"> // <PropertySetProperty xsi:type="typens:propertysetproperty"> // <Key>notetype</Key> // <Value xsi:type="xs:short">1</value> // </PropertySetProperty> // </PropertyArray> // </DefaultValues> //</CIMFeatureTemplate> Extension methods available to create or modify templates will be available in 2018.

28 Demo Demo 3 Edit Templates

29 Annotation Annotation feature classes store polygon geometry the bounding box of the text of the feature. It is automatically updated by the application each time the annotation attributes are modified. Schema the only fields guaranteed to exist in an annotation schema are AnnotationClassID, SymbolID, Element, FeatureID, Zorder and Status (along with ObjectID and Shape). All other fields which store text formatting attributes (VerticalAlignment, HorizontalAlignment, TextString, FontName) are optional and NOT guaranteed to exist. Users can delete these optional fields. Annotation attributes are represented as a CIMTextGraphic. This contains the text string, text formatting attributes (alignment, font, color etc), other information (callouts, leader lines) and a shape. This shape is the baseline geometry that the annotation text sits on. Baseline geometry can be point, polyline, multipoint or geometrybag. Access the CIMTextGraphic using the AnnotationFeature class and the GetGraphic and SetGraphic methods.

30 Modifying Annotation As per other features, any edits need to be wrapped in an EditOperation. Use EditOperation.Callback method in conjuction with a non-recycling cursor via Table.Search and the GetGraphic and SetGraphic methods on the AnnotationFeature class to obtain and modify the CIMTextGraphic. Do NOT use the Inspector. Inspector support is coming later in 2018

31 Modifying Annotation // must be executed on the MCT wrap in QueuedTask.Run var editop = new EditOperation(); editop.name = "Update annotation symbol"; editop.callback((context) => { var qf = new QueryFilter() { WhereClause = "OBJECTID = 33" ; using (var table = annolayer.gettable()) { using (var rc = table.search(qf, false)) { // <- false = non recycling cursor while (rc.movenext()) { AnnotationFeature annofeature = rc.current as AnnotationFeature; var textgraphic = annofeature.getgraphic() as CIMTextGraphic; textgraphic.text = "Hello world"; // get the symbol reference and symbol var cimsymbolreference = textgraphic.symbol; var cimsymbol = cimsymbolreference.symbol; cimsymbol.setcolor(colorfactory.instance.redrgb); // change the color annofeature.setgraphic(textgraphic); // update the CIMTextGraphic on the feature annofeature.store(); // store context.invalidate(annofeature); // refresh the cache, annolayer.gettable()); // execute the operation editop.execute();

32 Annotation Documentation : Guides Sample -

33 Demo Demo 4 Annotation

34 Advanced Editing and Edit Operations Wednesday 4.00pm 5.00pm Santa Rosa room Edit Operations - Chaining - Callback Best practices for consistency in the editing experience undo / redo, save or discard Edit Events

35 ArcGIS Pro SDK for.net Tech Sessions Date Time Technical Session Location 1:00 pm - 2:00 pm An Overview of the Geodatabase API Mojave Learning Center Tue, Mar 06 2:30 pm - 3:30 pm Beginning Pro Customization and Extensibility Primrose A 5:30 pm - 6:30 pm Beginning Editing and Editing UI Patterns Mojave Learning Center 10:30 am - 11:30 am Mapping and Layout Pasadena/Sierra/Ventura Wed, Mar 07 1:00 pm - 2:00 pm Advanced Pro Customization and Extensibility Santa Rosa 2:30 pm - 3:30 pm Pro Application Architecture Overview & API Patterns Mesquite G-H 4:00 pm - 5:00 pm Advanced Editing and Edit Operations Santa Rosa Thu, Mar 08 9:00 am - 3:30 pm Getting Started Hands-On Training Workshop Mojave Learning Center 5:30 pm - 6:30 pm Working with Rasters and Imagery Santa Rosa 8:30 am - 9:30 am An Overview of the Utility Network Management API Mesquite G-H Fri, Mar 09 10:00 am - 11:00 am Beginning Pro Customization and Extensibility Primrose A 1:00 pm - 2:00 pm Advanced Pro Customization and Extensibility Mesquite G-H

36 ArcGIS Pro SDK for.net Demo Theater Sessions Date Time Demo Theater Session Location Tue, Mar 06 Wed, Mar 07 1:00 pm - 1:30 pm Getting Started Demo Theater 1 - Oasis 1 4:00 pm - 4:30 pm Custom States and Conditions Demo Theater 2 - Oasis 1 5:30 pm - 6:00 pm New UI Controls for the SDK Demo Theater 2 - Oasis 1 6:00 pm - 6:30 pm Raster API and Manipulating Pixel Blocks Demo Theater 2 - Oasis 1 ArcGIS Pro Road Ahead Sessions Date Time Technical Session Location Tue, Mar 06 4:00 pm 5:00 pm ArcGIS Pro: The Road Ahead Oasis 4 Thu, Mar 08 4:00 pm 5:00 pm ArcGIS Pro: The Road Ahead Primrose B

37