GeoExt.MapPanel

Extends

• Ext.Panel

xtype

gx_mappanel

class GeoExt.MapPanel(config)

Create a panel container for a map. The map contained by this panel will initially be zoomed to either the center and zoom level configured by the center and zoom configuration options, or the configured extent, or - if neither are provided - the extent returned by the map’s getExtent() method.

Example Use

Sample code to create a panel with a new map:

var mapPanel = new GeoExt.MapPanel({
    border: false,
    renderTo: "div-id",
    map: {
        maxExtent: new OpenLayers.Bounds(-90, -45, 90, 45)
    }
});

Sample code to create a map panel with a bottom toolbar in a Window:

var win = new Ext.Window({
    title: "My Map",
    items: [{
        xtype: "gx_mappanel",
        bbar: new Ext.Toolbar()
    }]
});

Config Options

Configuration properties in addition to those listed for Ext.Panel.

center

OpenLayers.LonLat or Array(Number) A location for the initial map center. If an array is provided, the first two items should represent x & y coordinates.

extent

OpenLayers.Bounds or Array(Number) An initial extent for the map (used if center and zoom are not provided. If an array, the first four items should be minx, miny, maxx, maxy.

layers

GeoExt.data.LayerStore or GeoExt.data.GroupingStore or Array(OpenLayers.Layer) A store holding records. The layers provided here will be added to this MapPanel’s map when it is rendered.

map

OpenLayers.Map or Object A configured map or a configuration object for the map constructor. A configured map will be available after construction through the map property.

prettyStateKeys

Boolean Set this to true if you want pretty strings in the MapPanel’s state keys. More specifically, layer.name instead of layer.id will be used in the state keys if this option is set to true. But in that case you have to make sure you don’t have two layers with the same name. Defaults to false.

zoom

Number An initial zoom level for the map.

Public Properties

Public properties in addition to those listed for Ext.Panel.

MapPanel.layers

GeoExt.data.LayerStore A store containing GeoExt.data.LayerRecord objects.

MapPanel.map

OpenLayers.Map or Object A map or map configuration.