GeoExt

Table Of Contents

Previous topic

GeoExt.LegendPanel

Next topic

GeoExt.Popup

GeoExt.MapPanel

Extends
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.