# OpenLayers.Control.SLDSelect

Perform selections on WMS layers using Styled Layer Descriptor (SLD)

#### Inherits from

- OpenLayers.Control

Summary

OpenLayers.Control.SLDSelect | Perform selections on WMS layers using Styled Layer Descriptor (SLD)
Properties |
events | {OpenLayers.Events} Events instance for listeners and triggering control specific events.
clearOnDeactivate | {Boolean} Should the selection be cleared when the control is deactivated.
layers | {Array(OpenLayers.Layer.WMS)} The WMS layers this control will work on.
selectionSymbolizer | {Object} Determines the styling of the selected objects.
layerOptions | {Object} The options to apply to the selection layer, by default the selection layer will be kept out of the layer switcher.
handlerOptions | {Object} Used to set non-default properties on the control’s handler
sketchStyle | {<OpenLayers.Style>|Object} Style or symbolizer to use for the sketch handler.
wfsCache | {Object} Cache to use for storing parsed results from <OpenLayers.Format.WFSDescribeFeatureType.read>.
layerCache | {Object} Cache to use for storing references to the selection layers.
Constructor |
OpenLayers.Control.SLDSelect | Create a new control for selecting features in WMS layers using Styled Layer Descriptor (SLD).
Functions |
destroy | Take care of things that are not handled in superclass.
activate | Activate the control.
deactivate | Deactivate the control.
setLayers | Set the layers on which the selection should be performed.

### Properties

### events

{OpenLayers.Events} Events instance for listeners and triggering control specific events.

#### Register a listener for a particular event with the following syntax

>     control.events.register(type, obj, listener);

#### Supported event types (in addition to those from OpenLayers.Control.events)

selected | Triggered when a selection occurs. Listeners receive an event with filters and layer properties. Filters will be an array of OpenLayers.Filter objects created in order to perform the particular selection.

### clearOnDeactivate

{Boolean} Should the selection be cleared when the control is deactivated. Default value is false.

### layers

{Array(OpenLayers.Layer.WMS)} The WMS layers this control will work on.

### selectionSymbolizer

{Object} Determines the styling of the selected objects. Default is a selection in red.

### layerOptions

{Object} The options to apply to the selection layer, by default the selection layer will be kept out of the layer switcher.

### handlerOptions

{Object} Used to set non-default properties on the control’s handler

### sketchStyle

{<OpenLayers.Style>|Object} Style or symbolizer to use for the sketch handler. The recommended way of styling the sketch layer, however, is to configure an OpenLayers.StyleMap in the layerOptions of the handlerOptions:

>     new OpenLayers.Control.SLDSelect(OpenLayers.Handler.Path, {
>         handlerOptions: {
>             layerOptions: {
>                 styleMap: new OpenLayers.StyleMap({
>                     "default": {strokeColor: "yellow"}
>                 });
>             }
>         }
>     });

### wfsCache

{Object} Cache to use for storing parsed results from <OpenLayers.Format.WFSDescribeFeatureType.read>. If not provided, these will be cached on the prototype.

### layerCache

{Object} Cache to use for storing references to the selection layers. Normally each source layer will have exactly 1 selection layer of type OpenLayers.Layer.WMS. If not provided, layers will be cached on the prototype. Note that if clearOnDeactivate is true, the layer will no longer be cached after deactivating the control.

### Constructor

### OpenLayers.Control.SLDSelect

Create a new control for selecting features in WMS layers using Styled Layer Descriptor (SLD).

#### Parameters

handler | {OpenLayers.Class} A sketch handler class. This determines the type of selection, e.g. box (OpenLayers.Handler.Box), point (OpenLayers.Handler.Point), path (OpenLayers.Handler.Path) or polygon (OpenLayers.Handler.Polygon) selection. To use circle type selection, use OpenLayers.Handler.RegularPolygon and pass the number of desired sides (e.g. 40) as “sides” property to the handlerOptions.
options | {Object} An object containing all configuration properties for the control.

#### Valid options

layers | Array({OpenLayers.Layer.WMS}) The layers to perform the selection on.

### Functions

### destroy

> destroy: function()

Take care of things that are not handled in superclass.

### activate

> activate: function()

Activate the control. Activating the control will perform a SLD WMS DescribeLayer request followed by a WFS DescribeFeatureType request so that the proper symbolizers can be chosen based on the geometry type.

### deactivate

> deactivate: function()

Deactivate the control. If clearOnDeactivate is true, remove the selection layer(s).

### setLayers

> setLayers: function( | layers | )

Set the layers on which the selection should be performed. Call the setLayers method if the layer(s) to be used change and the same control should be used on a new set of layers. If the control is already active, it will be active after the new set of layers is set.

#### Parameters

layers | {Array(OpenLayers.Layer.WMS)} The new set of layers on which the selection should be performed.

Instances of OpenLayers.Layer.WMS are used to display data from OGC Web Mapping Services.

> destroy: function()

Take care of things that are not handled in superclass.

> activate: function()

Activate the control.

> deactivate: function()

Deactivate the control.

> setLayers: function( | layers | )

Set the layers on which the selection should be performed.
Controls affect the display or behavior of the map.
{OpenLayers.Events} Events instance for listeners and triggering control specific events.
{Object} Used to set non-default properties on the control’s handler
{Boolean} Should the selection be cleared when the control is deactivated.
Handler for dragging a rectangle across the map.
Handler to draw a point on the map.
Handler to draw a path on the map.
Handler to draw a polygon on the map.
Handler to draw a regular polygon on the map.
Close