Control to modify features. When activated, a click renders the vertices of a feature - these vertices can then be dragged. By default, the delete key will delete the vertex under the mouse. New features are added by dragging “virtual vertices” between vertices. Create a new control with the OpenLayers.Control.ModifyFeature constructor.
| OpenLayers.
|
Control to modify features. |
| Properties | |
| documentDrag | {Boolean} If set to true, dragging vertices will continue even if the mouse cursor leaves the map viewport. |
| geometryTypes | {Array(String)} To restrict modification to a limited set of geometry types, send a list of strings corresponding to the geometry class names. |
| clickout | {Boolean} Unselect features when clicking outside any feature. |
| toggle | {Boolean} Unselect a selected feature on click. |
| standalone | {Boolean} Set to true to create a control without SelectFeature capabilities. |
| deleteCodes | {Array(Integer)} Keycodes for deleting verticies. |
| virtualStyle | {Object} A symbolizer to be used for virtual vertices. |
| vertexRenderIntent | {String} The renderIntent to use for vertices. |
| mode | {Integer} Bitfields specifying the modification mode. |
| createVertices | {Boolean} Create new vertices by dragging the virtual vertices in the middle of each edge. |
| onModificationStart | {Function} Deprecated. |
| onModification | {Function} Deprecated. |
| onModificationEnd | {Function} Deprecated. |
| Constructor | |
| OpenLayers.
|
Create a new modify feature control. |
| Functions | |
| destroy | Take care of things that are not handled in superclass. |
| activate | Activate the control. |
| deactivate | Deactivate the control. |
| selectFeature | Select a feature for modification in standalone mode. |
| unselectFeature | Called when the select feature control unselects a feature. |
| Constants | |
| RESHAPE | {Integer} Constant used to make the control work in reshape mode |
| RESIZE | {Integer} Constant used to make the control work in resize mode |
| ROTATE | {Integer} Constant used to make the control work in rotate mode |
| DRAG | {Integer} Constant used to make the control work in drag mode |
{Boolean} Set to true to create a control without SelectFeature capabilities. Default is false. If standalone is true, to modify a feature, call the selectFeature method with the target feature. Note that you must call the unselectFeature method to finish feature modification in standalone mode (before starting to modify another feature).
{String} The renderIntent to use for vertices. If no virtualStyle is provided, this renderIntent will also be used for virtual vertices, with a fillOpacity and strokeOpacity of 0.3. Default is null, which means that the layer’s default style will be used for vertices.
{Integer} Bitfields specifying the modification mode. Defaults to OpenLayers.Control.ModifyFeature.RESHAPE. To set the mode to a combination of options, use the | operator. For example, to allow the control to both resize and rotate features, use the following syntax
control.mode = OpenLayers.Control.ModifyFeature.RESIZE |
OpenLayers.Control.ModifyFeature.ROTATE;
{Function} Deprecated. Register for “beforefeaturemodified” instead. The “beforefeaturemodified” event is triggered on the layer before any modification begins.
Optional function to be called when a feature is selected to be modified. The function should expect to be called with a feature. This could be used for example to allow to lock the feature on server-side.
{Function} Deprecated. Register for “afterfeaturemodified” instead. The “afterfeaturemodified” event is triggered on the layer after a feature has been modified.
Optional function to be called when a feature is finished being modified. The function should expect to be called with a feature.
Create a new modify feature control.
| layer | {OpenLayers.Layer.Vector} Layer that contains features that will be modified. |
| options | {Object} Optional object whose properties will be set on the control. |
selectFeature: function( feature )
Select a feature for modification in standalone mode. In non-standalone mode, this method is called when a feature is selected by clicking. Register a listener to the beforefeaturemodified event and return false to prevent feature modification.
| feature | {OpenLayers.Feature.Vector} the selected feature. |
unselectFeature: function( feature )
Called when the select feature control unselects a feature.
| feature | {OpenLayers.Feature.Vector} The unselected feature. |
Take care of things that are not handled in superclass.
destroy: function()
Activate the control.
activate: function()
Deactivate the control.
deactivate: function()
Select a feature for modification in standalone mode.
selectFeature: function( feature )
Called when the select feature control unselects a feature.
unselectFeature: function( feature )