net/systemeD/potlatch2/TagViewer.mxml

   1 <?xml version="1.0" encoding="utf-8"?>
   2 <mx:VBox
   3         xmlns:mx="http://www.adobe.com/2006/mxml"
   4         xmlns:flexlib="flexlib.containers.*"
   5         xmlns:controls="net.systemeD.controls.*"
   6         xmlns:potlatch2="net.systemeD.potlatch2.*"
   7     xmlns:sidepanel="net.systemeD.potlatch2.panels.*"
   8         horizontalScrollPolicy="off"
   9     backgroundColor="white"
  10     initialize="loadFeatures()">
  11
  12 <mx:ViewStack id="sidebar" width="100%" height="100%" creationPolicy="all">
  13
  14   <!-- Drag & drop icon panel -->
  15
  16   <mx:VBox id="dndPanel" width="100%" height="100%" horizontalScrollPolicy="off" styleName="dndPanelVbox">
  17     <mx:Text id="dndPanelText" text="{dndPrompt}" width="100%" styleName="helpInfo" />
  18         <mx:Repeater id="dndRep" dataProvider="{MapFeatures.getInstance().getCategoriesForType('point')}" styleName="dndRepeater">
  19                 <mx:HBox width="100%" styleName="dndPanelCategory">
  20                         <mx:Label text="{dndRep.currentItem.name}:" styleName="dndPanelCategoryLabel"/>
  21                 </mx:HBox>
  22
  23                 <mx:TileList dataProvider="{dndRep.currentItem.getFeaturesForType('point', true)}" width="100%" height="1"
  24                                      rowHeight="32" columnWidth="32" updateComplete="resizePOIGrid(event)" styleName="dndPanelTileList">
  25                         <mx:itemRenderer>
  26                                 <mx:Component>
  27                                         <mx:VBox toolTip="{data.name}">
  28                                                 <mx:Script><![CDATA[
  29                                                         import mx.events.DragEvent;
  30                                                         import mx.managers.DragManager;
  31                                                         import mx.core.DragSource;
  32
  33                                                         private function dragPOI(event:MouseEvent, tags:Array):void {
  34                                                                 // Get the drag initiator component from the event object.
  35                                                                 var dragInitiator:Image = event.currentTarget as Image;
  36                                                                 var dragSource:DragSource = new DragSource();
  37                                                                 dragSource.addData(tags, 'tags');
  38                                                                 dragSource.addData(event.target.parent.parent.parent.parent, 'container');
  39
  40                                                                 var dragProxy:Image = new Image();
  41                                                                 dragProxy.source = dragInitiator.source;
  42                                                                 dragProxy.width = dragInitiator.width;   // must set width and height explicitly
  43                                                                 dragProxy.height = dragInitiator.height; // for non-embedded images
  44                                                                 DragManager.doDrag(dragInitiator, dragSource, event, dragProxy);
  45                                                         }
  46                                                 ]]></mx:Script>
  47                                                 <mx:Image id="foo" source="{data.dndimage}" height="24" width="24" mouseMove="dragPOI(event, data.tags)" toolTip="{data.name}" />
  48                                         </mx:VBox>
  49                                 </mx:Component>
  50                         </mx:itemRenderer>
  51                 </mx:TileList>
  52         </mx:Repeater>
  53   </mx:VBox>
  54
  55   <!-- Standard tagging panel -->
  56
  57   <mx:VBox id="tagsPanel" width="100%" height="100%" creationPolicy="auto">
  58     <mx:ViewStack id="stack" width="100%" height="100%">
  59       <mx:VBox width="100%" height="100%" label="Simple" id="editorContainer" creationComplete="initEditorStackUIs()" styleName="dndPanelVbox">
  60         <mx:VBox width="100%" verticalGap="1" styleName="dndTagHeader">
  61           <mx:HBox width="100%" id="iconContainer" styleName="featureSelector">
  62             <mx:Image id="iconImage"/>
  63             <mx:Text condenseWhite="true" width="100%" id="iconText" styleName="dndIconText"/>
  64           </mx:HBox>
  65           <mx:HBox width="100%">
  66             <mx:PopUpButton id="popupChange" openAlways="true" width="100%" styleName="dndTagPopUpMenu" closeDuration="0" />
  67             <mx:LinkButton icon="@Embed('../../../embedded/information.svg')" click="openDescription()" id="helpLabel" styleName="helpInfo"/>
  68           </mx:HBox>
  69         </mx:VBox>
  70       </mx:VBox>
  71       <mx:VBox width="100%" height="100%" label="Advanced" id="advancedContainer" initialize="checkAdvanced()" verticalGap="1">
  72         <mx:Label id="advancedID" click="openEntityPage()">
  73           <mx:htmlText><![CDATA[<i>No Selection</i>]]></mx:htmlText>
  74         </mx:Label>
  75
  76                 <potlatch2:TagGrid id="advancedTagGrid" width="100%" height="75%" />
  77
  78         <mx:HBox horizontalAlign="right" width="100%">
  79           <mx:LinkButton label="Delete" click="advancedTagGrid.removeTag()" id="advancedDeleteButton" enabled="{advancedTagGrid.selectedItem != null? true : false}"/>
  80           <mx:LinkButton label="Add" click="advancedTagGrid.addNewTag()" id="advancedAddButton"/>
  81         </mx:HBox>
  82
  83         <mx:DataGrid editable="true" width="100%" height="25%" id="relationsGrid"
  84             doubleClickEnabled="true"
  85             itemDoubleClick="editRelation(relationsGrid.selectedItem.id)"
  86             doubleClick="if (event.target.parent==relationsGrid) { addToRelation(); }">
  87             <mx:columns>
  88                 <mx:DataGridColumn editable="false" dataField="description" headerText="Relation"/>
  89                 <mx:DataGridColumn editable="false" dataField="id_idx" headerText="ID"/>
  90                 <mx:DataGridColumn editable="true" dataField="role" headerText="Role">
  91                     <mx:itemEditor><mx:Component><mx:TextInput restrict="&#x0020;-&#x10FFFF;" /></mx:Component></mx:itemEditor>
  92                 </mx:DataGridColumn>
  93                                 <mx:DataGridColumn width="20" editable="false">
  94                                         <mx:itemRenderer>
  95                                                 <mx:Component>
  96                                     <mx:HBox horizontalAlign="center" verticalAlign="middle">
  97                                                                 <mx:PopUpButton arrowButtonWidth="12" paddingLeft="0" paddingRight="0" width="12" height="12"
  98                                                                                 open="{outerDocument.updateRelationMenu(event);}"
  99                                                                                 creationComplete="{outerDocument.createRelationMenu(PopUpButton(event.target));}"/>
 100                                                         </mx:HBox>
 101                                                 </mx:Component>
 102                                         </mx:itemRenderer>
 103                                 </mx:DataGridColumn>
 104             </mx:columns>
 105         </mx:DataGrid>
 106
 107         <mx:HBox horizontalAlign="right" width="100%">
 108           <mx:LinkButton label="Remove from" click="removeFromRelation(relationsGrid.selectedItem.id, relationsGrid.selectedItem.index)"
 109                           enabled="{relationsGrid.selectedItem != null? true : false}"/>
 110           <mx:LinkButton label="Add to" click="addToRelation()"/>
 111         </mx:HBox>
 112
 113       </mx:VBox>
 114
 115       <mx:VBox width="100%" height="100%" label="Members" id="membersVBox" initialize="checkMembers()" verticalGap="1">
 116         <mx:Label id="membersText" text="Relation Members"/>
 117         <mx:DataGrid editable="true" width="100%" height="100%" id="membersGrid"
 118                       dragEnabled="true" dragMoveEnabled="true" dropEnabled="true">
 119           <mx:columns>
 120             <mx:DataGridColumn editable="false" dataField="type" headerText="Type"/>
 121             <mx:DataGridColumn editable="false" dataField="id" headerText="ID"/>
 122             <mx:DataGridColumn editable="true" dataField="role" headerText="Role">
 123                                 <mx:itemEditor><mx:Component><mx:TextInput restrict="&#x0020;-&#x10FFFF;" /></mx:Component></mx:itemEditor>
 124                         </mx:DataGridColumn>
 125           </mx:columns>
 126         </mx:DataGrid>
 127       </mx:VBox>
 128
 129       </mx:ViewStack>
 130
 131           <mx:HBox width="100%">
 132                 <mx:LinkBar dataProvider="{stack}"/>
 133                 <mx:Spacer width="100%"/>
 134                 <mx:LinkButton
 135                         icon="@Embed('../../../embedded/view_tabbed.png')"
 136                         disabledIcon="@Embed('../../../embedded/view_tabbed_disabled.png')"
 137                         click="setEditorStackUI(true)" id="tabNavigatorLabel" paddingTop="6"
 138                         toolTip="Show in tabs"
 139                         enabled="{editorStack is Accordion &amp;&amp; stack.selectedIndex==0}" />
 140                 <mx:LinkButton
 141                         icon="@Embed('../../../embedded/view_accordion.png')"
 142                         disabledIcon="@Embed('../../../embedded/view_accordion_disabled.png')"
 143                         click="setEditorStackUI(false)" id="accordionLabel" paddingTop="6"
 144                         toolTip="Show in sliding windows"
 145                         enabled="{editorStack is SuperTabNavigator &amp;&amp; stack.selectedIndex==0}" />
 146           </mx:HBox>
 147   </mx:VBox>
 148
 149   <!-- Multiple selection -->
 150
 151   <mx:VBox id="multiplePanel" width="100%" height="100%" horizontalScrollPolicy="off" styleName="dndPanelVbox">
 152     <potlatch2:TagGrid id="multiAdvancedTagGrid" width="100%" height="75%" />
 153         <mx:HBox horizontalAlign="right" width="100%">
 154           <mx:LinkButton label="Delete" click="multiAdvancedTagGrid.removeTag()" enabled="{multiAdvancedTagGrid.selectedItem != null? true : false}"/>
 155           <mx:LinkButton label="Add" click="multiAdvancedTagGrid.addNewTag()" />
 156         </mx:HBox>
 157
 158     <mx:DataGrid editable="true" width="100%" height="25%" id="multiRelationsGrid"
 159         doubleClickEnabled="true"
 160         itemDoubleClick="editRelation(multiRelationsGrid.selectedItem.id)"
 161         doubleClick="if (event.target.parent==multiRelationsGrid) { addToRelation(); }">
 162         <mx:columns>
 163             <mx:DataGridColumn editable="false" dataField="description" headerText="Relation"/>
 164             <mx:DataGridColumn editable="false" dataField="id_idx" headerText="ID"/>
 165             <mx:DataGridColumn editable="true" dataField="role" headerText="Role">
 166                 <mx:itemEditor><mx:Component><mx:TextInput restrict="&#x0020;-&#x10FFFF;" /></mx:Component></mx:itemEditor>
 167             </mx:DataGridColumn>
 168                         <mx:DataGridColumn width="20" editable="false">
 169                                 <mx:itemRenderer>
 170                                         <mx:Component>
 171                             <mx:HBox horizontalAlign="center" verticalAlign="middle">
 172                                                         <mx:PopUpButton arrowButtonWidth="12" paddingLeft="0" paddingRight="0" width="12" height="12"
 173                                                                         open="{outerDocument.updateRelationMenu(event);}"
 174                                                                         creationComplete="{outerDocument.createRelationMenu(PopUpButton(event.target));}"/>
 175                                                 </mx:HBox>
 176                                         </mx:Component>
 177                                 </mx:itemRenderer>
 178                         </mx:DataGridColumn>
 179         </mx:columns>
 180     </mx:DataGrid>
 181     <mx:HBox horizontalAlign="right" width="100%">
 182       <mx:LinkButton label="Remove from" click="removeFromRelation(multiRelationsGrid.selectedItem.id)"
 183                       enabled="{multiRelationsGrid.selectedItem != null? true : false}"/>
 184       <mx:LinkButton label="Add to" click="addToRelation()"/>
 185     </mx:HBox>
 186
 187   </mx:VBox>
 188
 189   <!-- Multiple selection but items cannot be edited -->
 190
 191   <mx:VBox id="multipleInvalidPanel" width="100%" height="100%" horizontalScrollPolicy="off" styleName="dndPanelVbox">
 192         <mx:Text id="multipleInvalidPanelText" text="You have selected multiple items." width="100%" styleName="helpInfo" />
 193   </mx:VBox>
 194
 195   <!-- Generic marker panel -->
 196
 197   <mx:VBox id="markerPanel" width="100%" height="100%" horizontalScrollPolicy="off" styleName="dndPanelVbox">
 198     <sidepanel:MarkerPanel id="markerPanelContents" width="100%"/>
 199   </mx:VBox>
 200
 201   <!-- Bug editing panel -->
 202
 203   <mx:VBox id="bugPanel" width="100%" height="100%" horizontalScrollPolicy="off" styleName="dndPanelVbox">
 204     <sidepanel:BugPanel id="bugPanelContents" width="100%"/>
 205   </mx:VBox>
 206
 207 </mx:ViewStack>
 208
 209   <mx:Script><![CDATA[
 210       import net.systemeD.halcyon.connection.*;
 211       import net.systemeD.halcyon.VectorLayer;
 212       import net.systemeD.potlatch2.mapfeatures.*;
 213
 214       import mx.collections.*;
 215       import mx.containers.*;
 216       import mx.events.*;
 217       import mx.core.*;
 218       import mx.managers.PopUpManager;
 219       import mx.controls.Menu;
 220       import flash.geom.Point;
 221       import flash.net.*;
 222       import mx.events.DragEvent;
 223       import mx.managers.DragManager;
 224       import mx.core.DragSource;
 225       import flexlib.containers.SuperTabNavigator;
 226
 227       private static const dndPrompt:String="Add new points by dragging them onto the map";
 228
 229       private var editorStackTabNavigator:SuperTabNavigator;
 230       private var editorStackAccordion:Accordion;
 231       [Bindable] private var editorStack:Container;
 232
 233       public var mapFeatures:MapFeatures;
 234       private var selectedEntity:Entity;
 235       private var currentCategorySelector:CategorySelector;
 236       private var categorySelectors:Object = {};        // hash of categorySelectors for each limitType
 237       private var feature:Feature = null;
 238
 239       private var rowData:Object;               // relation membership reference, needed so it's accessible from relation actions menu
 240
 241           public function setEntity(entities:Array, layer:VectorLayer=null):void {
 242                 UIComponent.suspendBackgroundProcessing();
 243
 244                 var firstSelected:Entity=null;
 245                 if (entities.length==1) { firstSelected=entities[0]; }
 246
 247                 if (selectedEntity!=firstSelected && selectedEntity!=null) {
 248                         selectedEntity.removeEventListener(Connection.TAG_CHANGED, tagChanged);
 249                         selectedEntity.removeEventListener(Connection.ADDED_TO_RELATION, addedToRelation);
 250                         selectedEntity.removeEventListener(Connection.REMOVED_FROM_RELATION, removedFromRelation);
 251                 }
 252
 253                 if (entities.length==0) {
 254                         // Nothing selected, so show drag-and-drop panel
 255                         sidebar.selectedChild = dndPanel;
 256
 257                 } else if (entities.length==1) {
 258                         // Single entity selected, so show tag panel
 259                         selectedEntity=firstSelected;
 260                         if (selectedEntity!=null) { selectedEntity.addEventListener(Connection.TAG_CHANGED, tagChanged); }
 261                         if (advancedID!=null) { setupAdvanced(firstSelected); }
 262                         if (firstSelected is Relation) { stack.addChild(membersVBox); }
 263             if (selectedEntity is Marker && layer is BugLayer) {
 264               bugPanelContents.init(selectedEntity, layer);
 265               sidebar.selectedChild = bugPanel;
 266             } else if (selectedEntity is Marker) {
 267               markerPanelContents.init(selectedEntity, layer);
 268               sidebar.selectedChild = markerPanel;
 269             } else {
 270               refreshFeatureIcon();
 271               initialiseEditors();
 272               sidebar.selectedChild = tagsPanel;
 273             }
 274
 275                 } else if(isMultipleEditable(entities)) {
 276                         selectedEntity = new EntityCollection(entities);
 277                         selectedEntity.addEventListener(Connection.TAG_CHANGED, tagChanged);
 278             sidebar.selectedChild = multiplePanel;
 279                         setupMultiAdvanced(selectedEntity);
 280
 281                 } else {
 282                         //The selection contains elements which can't be edited all together.
 283                         sidebar.selectedChild = multipleInvalidPanel;
 284                 }
 285                 UIComponent.resumeBackgroundProcessing();
 286       }
 287
 288       private function refreshFeatureIcon():void {
 289           var oldFeature:Feature = feature;
 290           feature = selectedEntity == null ? null : mapFeatures.findMatchingFeature(selectedEntity);
 291           if ( feature != oldFeature ) {
 292               if ( oldFeature != null )
 293                   oldFeature.removeEventListener("imageChanged", featureImageChanged);
 294               if ( feature != null )
 295                   feature.addEventListener("imageChanged", featureImageChanged);
 296           }
 297           setCategorySelector(selectedEntity, feature);
 298       }
 299
 300       private function featureImageChanged(event:Event):void {
 301           setCategorySelector(selectedEntity, feature);
 302       }
 303
 304       /** Set the icon, categorySelector and help text for the current entity. */
 305       private function setCategorySelector(entity:Entity, feature:Feature):void {
 306                         // Remove the "user has selected something" event listener from previous categorySelector,
 307                         // and make it invisible because Flex is crap at updating click areas otherwise
 308                         if (currentCategorySelector) {
 309                                 currentCategorySelector.removeEventListener("selectedType", changeFeatureType);
 310                                 currentCategorySelector.visible=false;
 311                         }
 312
 313                         // Have we cached the categorySelector for this limitType? If not, create one
 314                         var lt:String=limitType(entity);
 315                         if (!categorySelectors[lt]) {
 316                                 categorySelectors[lt]=new CategorySelector();
 317                                 categorySelectors[lt].setLimitTypes(lt);
 318                         }
 319                         currentCategorySelector=categorySelectors[lt];
 320                         currentCategorySelector.addEventListener("selectedType", changeFeatureType, false, 0, true);
 321
 322                         // Update surrounding icon/text display
 323                         if (feature) {
 324                                 iconImage.source = feature.image;
 325                                 iconText.htmlText = feature.htmlDetails(entity);
 326                                 popupChange.label = feature.name;
 327                                 helpLabel.visible = feature.hasHelpURL();
 328                                 currentCategorySelector.setSelectedFeature(feature);
 329                         } else {
 330                                 iconImage.source = null;
 331                                 popupChange.label = "unknown";
 332                                 helpLabel.visible = false;
 333                                 if (entity==null) {
 334                                         iconText.htmlText = "<i>Nothing selected</i>";
 335                                 } else if (entity.hasTags()) {
 336                                         iconText.htmlText = "<b>Not recognised</b><br/><font size='10pt'>Try looking at the tags under the advanced properties</font>";
 337                                 } else {
 338                                         iconText.htmlText = "<b>No tags set</b><br/><font size='10pt'>Please use the menu below to define what this "+entity.getType()+" is</font>";
 339                                 }
 340                                 currentCategorySelector.setSelectedFeature(null);
 341                         }
 342
 343                         // Set it as the popup, and make sure it's visible
 344                         popupChange.popUp=currentCategorySelector;
 345                         currentCategorySelector.visible=true;
 346       }
 347
 348           private function isMultipleEditable(entities:Array):Boolean {
 349                 for each(var entity:Entity in entities) {
 350                         if(!(entity is Node || entity is Way))
 351                                 return false;
 352                 }
 353                 return true;
 354           }
 355
 356       private function limitType(entity:Entity):String {
 357           if      (entity is Node    ) return "point";
 358           else if (entity is Way     ) return Way(entity).isArea() ? "area" : "line";
 359           else if (entity is Relation) return "relation";
 360           return null;
 361       }
 362
 363       private var tabComponents:Object = {};
 364
 365       private function initialiseEditors():void {
 366           editorStack.removeAllChildren();
 367           if ( selectedEntity == null || feature == null )
 368               return;
 369
 370           var editorBox:VBox = createEditorBox();
 371           editorBox.label = "Basic";
 372           editorStack.addChild(editorBox);
 373
 374           var tabs:Object = {};
 375           tabComponents = {};
 376
 377           for each (var factory:EditorFactory in feature.editors) {
 378               if ( factory.presence.isEditorPresent(factory, selectedEntity, null) ) {
 379                   var editor:DisplayObject = factory.createEditorInstance(selectedEntity);
 380                   if ( editor != null )
 381                       editorBox.addChild(editor);
 382               }
 383               var category:String = factory.category;
 384               if (category!='') {
 385                       var tab:VBox = tabs[category];
 386                       if ( tab == null) {
 387                           tab = createEditorBox();
 388                           tab.label = category;
 389                           editorStack.addChild(tab);
 390                           tabs[category] = tab;
 391                           tabComponents[tab] = [];
 392                       }
 393                       var catEditor:DisplayObject = factory.createEditorInstance(selectedEntity);
 394                       if ( catEditor != null )
 395                           tabComponents[tab].push(catEditor);
 396                       //    tab.addChild(catEditor);
 397               }
 398           }
 399       }
 400
 401       private function createEditorBox():VBox {
 402           var box:VBox = new VBox();
 403           box.percentWidth = 100;
 404           box.percentHeight = 100;
 405           box.styleName = "dndEditorContainer";
 406           return box;
 407       }
 408
 409       private function ensureEditorsPopulated(tab:VBox):void {
 410           var components:Array = tabComponents[tab];
 411           if ( components == null || tab == null || tab.numChildren >= components.length )
 412               return;
 413           for each (var component:DisplayObject in components ) {
 414               tab.addChild(component);
 415           }
 416       }
 417
 418         private function initEditorStackUIs():void {
 419                 editorStackTabNavigator = new SuperTabNavigator();
 420                 editorStackTabNavigator.allowTabSqueezing=false;
 421                 editorStackTabNavigator.minTabWidth=10;
 422                 editorStackTabNavigator.closePolicy="close_never";
 423                 editorStackTabNavigator.scrollSpeed=20;
 424                 editorStackTabNavigator.creationPolicy="auto";
 425                 editorStackTabNavigator.percentWidth=100;
 426                 editorStackTabNavigator.percentHeight=100;
 427                 editorStackTabNavigator.styleName="dndStackTab";
 428                 editorStackTabNavigator.popUpButtonPolicy="off"
 429
 430
 431                 editorStackAccordion = new Accordion();
 432                 editorStackAccordion.percentWidth=100;
 433                 editorStackAccordion.percentHeight=100;
 434                 editorStackAccordion.creationPolicy="auto";
 435                 editorStackAccordion.styleName="dndStackAccordion";
 436
 437                 setEditorStackUI(true);
 438         }
 439
 440         private function setEditorStackUI(isTabbed:Boolean):void {
 441                 var children:Array=[]; var i:uint;
 442
 443                 if (editorStack) {
 444                         // blank existing component
 445                         editorStack.removeEventListener("change",editorStackUIChange);
 446                         editorStack.removeEventListener("updateComplete",editorStackUIUpdate);
 447                         editorStack.removeAllChildren();
 448                         editorContainer.removeChildAt(1);
 449                 }
 450
 451                 // replace with new component
 452                 editorStack = (isTabbed ? editorStackTabNavigator : editorStackAccordion) as Container;
 453                 editorContainer.addChild(editorStack);
 454
 455                 // re-add children and listeners
 456                 initialiseEditors();
 457                 editorStack.addEventListener("change",editorStackUIChange);
 458                 editorStack.addEventListener("updateComplete",editorStackUIUpdate);
 459         }
 460
 461         private function editorStackUIChange(event:Event):void {
 462                 ensureEditorsPopulated(IndexChangedEvent(event).relatedObject as VBox);
 463         }
 464
 465         private function editorStackUIUpdate(event:Event):void {
 466                 if (editorStack is SuperTabNavigator) {
 467                         var e:SuperTabNavigator = editorStack as SuperTabNavigator;
 468                         if (e.selectedIndex<0) { return; }
 469                         for (var i:uint=0; i<e.numChildren; i++) {
 470                                 e.getTabAt(i).selected=(i==e.selectedIndex);
 471                         }
 472                 }
 473         }
 474
 475
 476         public function togglePanel():void {
 477                 if (stack.selectedChild==editorContainer && selectedEntity!=null) {
 478                         stack.selectedChild=advancedContainer;
 479                 } else if (stack.selectedChild!=editorContainer) {
 480                         stack.selectedChild=editorContainer;
 481                 }
 482         }
 483
 484         public function selectAdvancedPanel():void {
 485                 checkAdvanced();
 486                 stack.selectedChild=advancedContainer;
 487         }
 488
 489       private function checkAdvanced():void {
 490           if ( selectedEntity != null )
 491              setupAdvanced(selectedEntity);
 492       }
 493
 494       private var listeningToRelations:Array = [];
 495
 496       private function setupAdvanced(entity:Entity):void {
 497                 if (!advancedTagGrid) advancedContainer.createComponentsFromDescriptors();      // if Flex hasn't created it, force it
 498                 advancedTagGrid.init(entity);
 499
 500                 if ( entity == null ) {
 501                         advancedID.htmlText = "";
 502                 } else {
 503                         var entityText:String = "xx";
 504                         if      ( entity is Node     ) entityText = "Node";
 505                         else if ( entity is Way      ) entityText = "Way";
 506                         else if ( entity is Relation ) entityText = "Relation";
 507                         advancedID.htmlText = entityText+": <b>"+entity.id+"</b>";
 508                 }
 509
 510                 removeRelationListeners();
 511
 512                 if ( entity == null ) {
 513                         relationsGrid.dataProvider = null;
 514                 } else {
 515                         resetRelationsGrid(entity);
 516                         entity.addEventListener(Connection.ADDED_TO_RELATION, addedToRelation);
 517                         entity.addEventListener(Connection.REMOVED_FROM_RELATION, removedFromRelation);
 518                 }
 519       }
 520
 521           private function setupMultiAdvanced(entity:Entity):void {
 522                 multiAdvancedTagGrid.init(entity);
 523                 resetRelationsGrid(entity);
 524                 entity.addEventListener(Connection.ADDED_TO_RELATION, addedToRelation, false, 0, true);
 525                 entity.addEventListener(Connection.REMOVED_FROM_RELATION, removedFromRelation, false, 0, true);
 526       }
 527
 528           public function addNewTag():void {
 529                 if (stack.selectedChild!=advancedContainer) { return; }
 530                 advancedTagGrid.addNewTag();
 531           }
 532
 533       private function addedToRelation(event:RelationMemberEvent):void {
 534          resetRelationsGrid(selectedEntity);
 535       }
 536
 537       private function removedFromRelation(event:RelationMemberEvent):void {
 538          resetRelationsGrid(selectedEntity);
 539       }
 540
 541       private function removeRelationListeners():void {
 542           for each( var rel:Relation in listeningToRelations ) {
 543               rel.removeEventListener(Connection.TAG_CHANGED, relationTagChanged);
 544               rel.removeEventListener(Connection.RELATION_MEMBER_ADDED, entityRelationMemberChanged);
 545               rel.removeEventListener(Connection.RELATION_MEMBER_REMOVED, entityRelationMemberChanged);
 546           }
 547           listeningToRelations = [];
 548           if (relationsGrid) relationsGrid.removeEventListener(DataGridEvent.ITEM_EDIT_END, relationRoleChanged);
 549           if (multiRelationsGrid) multiRelationsGrid.removeEventListener(DataGridEvent.ITEM_EDIT_END, relationRoleChanged);
 550       }
 551
 552       private function resetRelationsGrid(entity:Entity):void {
 553           removeRelationListeners();
 554
 555           var instance:DataGrid=relationsGrid;
 556           if (entity is EntityCollection) instance=multiRelationsGrid;
 557           var memberships:Array = entity.getRelationMemberships();
 558           for each (var m:Object in memberships) {
 559               m.relation.addEventListener(Connection.TAG_CHANGED, relationTagChanged);
 560               m.relation.addEventListener(Connection.RELATION_MEMBER_ADDED, entityRelationMemberChanged);
 561               m.relation.addEventListener(Connection.RELATION_MEMBER_REMOVED, entityRelationMemberChanged);
 562               listeningToRelations.push(m.relation);
 563           }
 564           instance.dataProvider = memberships;
 565           instance.addEventListener(DataGridEvent.ITEM_EDIT_END, relationRoleChanged, false, -100);
 566       }
 567
 568       private function relationRoleChanged(event:DataGridEvent):void {
 569                 if (event.dataField != 'role') { return; }      // shouldn't really happen
 570
 571                 var relations:Array=event.currentTarget.dataProvider.toArray();
 572                 var props:Object=relations[event.rowIndex];
 573
 574                 var relation:Relation=props['relation'];
 575                 var newRole:String=event.itemRenderer.data['role'];
 576
 577                 if (selectedEntity is EntityCollection) {
 578                         for each (var entity:Entity in EntityCollection(selectedEntity).entities) {
 579                                 var indexes:Array=relation.findEntityMemberIndexes(entity);
 580                                 for each (var index:int in indexes) {
 581                                         relation.setMember(index, new RelationMember(entity,newRole), MainUndoStack.getGlobalStack().addAction);
 582                                 }
 583                         }
 584                 } else {
 585                         relation.setMember(props['index'], new RelationMember(selectedEntity,newRole), MainUndoStack.getGlobalStack().addAction);
 586                 }
 587       }
 588
 589       private function relationTagChanged(event:TagEvent):void {
 590           resetRelationsGrid(selectedEntity);
 591       }
 592
 593       private function entityRelationMemberChanged(event:RelationMemberEvent):void {
 594           resetRelationsGrid(selectedEntity);
 595       }
 596
 597       private function checkMembers():void {
 598           if (selectedEntity is Relation) {
 599             setupMembers(selectedEntity as Relation);
 600           }
 601       }
 602
 603       private function setupMembers(rel:Relation):void {
 604           var members:Array = [];
 605           for (var i:int=0 ; i<rel.length; i++) {
 606             var props:Object = {};
 607             var member:RelationMember = rel.getMember(i);
 608             props["id"] = member.entity.id;
 609             props["type"] = member.entity.getType();
 610             props["role"] = member.role;
 611
 612             members.push(props);
 613           }
 614           membersGrid.dataProvider = members;
 615           membersGrid.dataProvider.addEventListener('collectionChange', membersChange);
 616       }
 617
 618       private function membersChange(event:Event):void {
 619           // Dropping all the members and re-adding them isn't exactly optimal
 620           // but is at least robust for any kind of change.
 621           // Figuring out a better way is someone else's FIXME
 622
 623           var conn:Connection = Connection.getConnectionInstance();
 624           var rel:Relation = selectedEntity as Relation
 625           var action:CompositeUndoableAction = new CompositeUndoableAction("Rearrange relation members for "+rel);
 626
 627           // drop members
 628           for (var i:int=rel.length-1 ; i>=0; i--) {
 629             rel.removeMemberByIndex(i, action.push);
 630           }
 631
 632           // add members in new order
 633           for each(var memberObject:Object in membersGrid.dataProvider) {
 634             var e:Entity;
 635             var id:Number = memberObject.id;
 636             if(memberObject.type == 'node') {
 637               e = conn.getNode(id);
 638             } else if (memberObject.type == 'way') {
 639               e = conn.getWay(id);
 640             } else if (memberObject.type == 'relation') {
 641               e = conn.getRelation(id);
 642             }
 643             rel.appendMember(new RelationMember(e, memberObject.role), action.push);
 644           }
 645           MainUndoStack.getGlobalStack().addAction(action);
 646       }
 647
 648       private function editRelation(id:Number):void {
 649           var panel:RelationEditorPanel = RelationEditorPanel(
 650               PopUpManager.createPopUp(Application(Application.application), RelationEditorPanel, true));
 651           panel.setRelation(Connection.getConnectionInstance().getRelation(id));
 652           PopUpManager.centerPopUp(panel);
 653       }
 654
 655         /** Create relation actions menu */
 656
 657         public function createRelationMenu(button:PopUpButton):void {
 658                 var menu:Menu = new Menu();
 659                 var dp:Object = [ {label: "Select all members"},
 660                                                   {label: "Deselect all members"},
 661                                                   {label: "Add selection to this relation", enabled: false} ];
 662                 menu.dataProvider = dp;
 663                 menu.addEventListener("itemClick", selectRelationMenu);
 664                 button.popUp = menu;
 665         }
 666
 667         /** Enable 'add selection to...' entry only if some of the selection isn't in the relation.
 668             Called each time the menu is clicked. */
 669
 670         public function updateRelationMenu(event:Event):void {
 671                 rowData=event.target.parent.data;       // this makes it accessible from selectRelationMenu
 672                 var menu:Menu = Menu(event.target.popUp);
 673                 var enable:Boolean = false;
 674                 if (selectedEntity != null && selectedEntity is EntityCollection) {
 675                         // Enable only if some entities aren't a member of the relation
 676                         enable=!rowData.universal;
 677                 }
 678                 if (enable==menu.dataProvider[2].enabled) return;
 679                 menu.dataProvider[2].enabled=enable;
 680                 menu.invalidateList();
 681         }
 682
 683         /** Do the action selected in the relation actions menu */
 684
 685         public function selectRelationMenu(event:MenuEvent):void {
 686                 var rel:Relation=rowData.relation;
 687                 var entities:Array;
 688                 var controller:EditController=Application.application.theController;
 689                 switch (event.index) {
 690                         case 0: // Select all members
 691                                 entities=selectedEntity.entities.concat(rel.memberEntities);
 692                                 entities=entities.filter(function(e:*, i:int, arr:Array):Boolean { return arr.indexOf(e) == i } );      // remove duplicates
 693                                 // ** FIXME: This is a really horrible way of changing the controller state
 694                                 controller.setState(controller.findStateForSelection(entities));
 695                                 break;
 696
 697                         case 1: // Deselect all members
 698                                 entities=selectedEntity.entities;
 699                                 entities=entities.filter(function(e:*, i:int, arr:Array):Boolean { return !e.hasParent(rel) } );
 700                                 controller.setState(controller.findStateForSelection(entities));
 701                                 break;
 702
 703                         case 2: // Add selection to this relation
 704                                 var undo:CompositeUndoableAction=new CompositeUndoableAction("Remove selection from relations");
 705                                 for each (var entity:Entity in selectedEntity.entities) {
 706                                         if (!entity.hasParent(rel)) {
 707                                                 rel.appendMember(new RelationMember(entity,''), undo.push);
 708                                         }
 709                                 }
 710                                 MainUndoStack.getGlobalStack().addAction(undo);
 711                                 break;
 712                 }
 713         }
 714
 715       private function tagChanged(event:TagEvent):void {
 716               if(selectedEntity != null && selectedEntity is EntityCollection) {
 717                         setupMultiAdvanced(selectedEntity);
 718                     return;
 719                   }
 720
 721           refreshFeatureIcon();
 722           // ** FIXME - changing tags on Advanced tab should update simple view
 723           // (but putting initialiseEditors here breaks other stuff, because it causes
 724           // the Basic pane to be selected)
 725
 726           // if the advancedTagGrid has already been set up, it needs to be refreshed.
 727           // FIXME make this better, maybe advancedTagGrid should be event listening.
 728           if(advancedContainer.initialized) {
 729             checkAdvanced();
 730           }
 731       }
 732
 733       public function loadFeatures():void {
 734           mapFeatures = MapFeatures.getInstance();
 735           stack.removeChild(membersVBox); // remove by default, will be added if relation
 736       }
 737
 738       /** Open up a new browser page, showing the help page as defined in Map Features XML file .*/
 739       public function openDescription():void {
 740           if ( feature != null && feature.hasHelpURL() )
 741               navigateToURL(new URLRequest(feature.helpURL), "potlatch_help");
 742       }
 743
 744       /** Open up a new browser page showing OSM's view of the current entity. */
 745       public function openEntityPage():void {
 746           if (selectedEntity != null && selectedEntity.id >= 0) {
 747               // This is slightly hard-coded, but not drastically. The ../s could be changed for string manipulation of the apiBase
 748               var urlBase:String = Connection.getConnectionInstance().apiBase + '../../browse/'
 749               navigateToURL(new URLRequest(urlBase+selectedEntity.getType()+'/'+selectedEntity.id), "potlatch_browse");
 750           }
 751       }
 752
 753       public function addToRelation():void {
 754           new RelationSelectPanel().init(selectedEntity,new Object());
 755       }
 756
 757       private function removeFromRelation(id:Number, index:int=-1):void {
 758                 var rel:Relation=Connection.getConnectionInstance().getRelation(id);
 759                 if (index>-1) {
 760                         rel.removeMemberByIndex(index, MainUndoStack.getGlobalStack().addAction);
 761                 } else if (selectedEntity is EntityCollection) {
 762                         var undo:CompositeUndoableAction=new CompositeUndoableAction("Remove selection from relations");
 763                         for each (var e:Entity in EntityCollection(selectedEntity).entities) rel.removeMember(e,undo.push);
 764                         MainUndoStack.getGlobalStack().addAction(undo);
 765                 }
 766       }
 767
 768       public function changeFeatureType(event:Event):void {
 769           if ( selectedEntity == null )
 770               return;
 771
 772           UIComponent.suspendBackgroundProcessing();
 773           var newFeature:Feature = currentCategorySelector.selectedType;
 774           var undoStack:Function = MainUndoStack.getGlobalStack().addAction;
 775           var action:CompositeUndoableAction = new CompositeUndoableAction(
 776                   "Set "+selectedEntity.getType()+" "+selectedEntity.id+" to "+newFeature.name);
 777                   selectedEntity.suspend();
 778
 779           // remove tags from the current feature
 780           if ( feature != null ) {
 781               for each( var oldtag:Object in feature.tags ) {
 782                   selectedEntity.setTag(oldtag["k"], null, action.push);
 783               }
 784           }
 785
 786           // set tags for new feature
 787           if ( newFeature != null ) {
 788               for each( var newtag:Object in newFeature.tags ) {
 789                   selectedEntity.setTag(newtag["k"], newtag["v"], action.push);
 790               }
 791           }
 792
 793                   selectedEntity.resume();
 794           undoStack(action);
 795           popupChange.close();
 796           initialiseEditors();
 797           UIComponent.resumeBackgroundProcessing();
 798       }
 799
 800         private function resizePOIGrid(event:Event):void {
 801                 var rows:Number=event.target.dataProvider.length/event.target.columnCount;
 802                 if (rows!=Math.floor(rows)) { rows=Math.floor(rows+1); }
 803                 event.target.height=rows*(event.target.rowHeight+1);
 804         }
 805   ]]></mx:Script>
 806 </mx:VBox>
 807