ajaxmapcontrol.cs

C# 的地图开发例子（sharp map)

// Copyright 2006 - Morten Nielsen (www.iter.dk)
//
// This file is part of SharpMap.
// SharpMap is free software; you can redistribute it and/or modify
// it under the terms of the GNU Lesser General Public License as published by
// the Free Software Foundation; either version 2 of the License, or
// (at your option) any later version.
// 
// SharpMap is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU Lesser General Public License for more details.

// You should have received a copy of the GNU Lesser General Public License
// along with SharpMap; if not, write to the Free Software
// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA 

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Text;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.HtmlControls;
using System.ComponentModel.Design;

namespace SharpMap.Web.UI.Ajax
{
	/// <summary>
	/// The Ajax Map Control is a javascript controlled map that is able to refresh
	/// the map without the whole webpage has to do a roundtrip to the server.
	/// </summary>
	/// <remarks>
	/// <para>This webcontrol is tested with both IE and FireFox.</para>
	/// <para>The webcontrol creates a client-side javascript object named after
	/// the ClientID of this control
	/// and appends "Obj" to it. Below are a list of some of the properties
	/// and methods of the client-side object. The <see cref="OnViewChanging"/> 
	/// and <see cref="OnViewChange"/> client-side events
	/// are also is parsing a reference to this object.</para>
	/// <list type="table">
	/// <listheader><term>Method/Property</term><description>Description</description></listheader>
	/// <item><term>.minX</term><description>World coordinate of the left side of the current view</description></item>
	/// <item><term>.maxY</term><description>World coordinate of the top of the current view</description></item>
	/// <item><term>.GetCenter()</term><description>Gets a center point object with the current view (use the .x and .y properties of the returned object for the coordinates)</description></item>
	/// <item><term>.zoom</term><description>The current zoom level of the map (map width)</description></item>
	/// <item><term>.zoomAmount</term><description>The amount to zoom on a zoom-in event (negative values equals zoom out)</description></item>
	/// <item><term>.container</term><description>Reference to the map box element</description></item>
	/// <item><term>.statusbar</term><description>Reference to the statusbar element</description></item>
	/// </list>
	/// </remarks>
	[DefaultProperty("Map")]
	[ToolboxData("<{0}:AjaxMapControl runat=\"server\"></{0}:AjaxMapControl>")]
	[Designer(typeof(AjaxMapControlDesigner))]
	public class AjaxMapControl : System.Web.UI.WebControls.WebControl, INamingContainer, ICallbackEventHandler
	{
		internal static System.Globalization.NumberFormatInfo numberFormat_EnUS = new System.Globalization.CultureInfo("en-US", false).NumberFormat;
		
		SharpMap.Map map;
		private System.Web.UI.WebControls.Image imgMap1;
		private System.Web.UI.WebControls.Image imgMap2;
		private HtmlGenericControl spanCursorLocation;
		private HtmlGenericControl divTopBar;

		private int _ZoomSpeed;

		/// <summary>
		/// Sets the speed which the zoom is (lower = faster).
		/// The default value is 15
		/// </summary>
		[Category("Behavior")]
		[DefaultValue(15)]
		[Description("Sets the speed which the zoom is (lower = faster).")]
		public int ZoomSpeed
		{
			get { return _ZoomSpeed; }
			set { _ZoomSpeed = value; }
		}

		private int _FadeSpeed;

		/// <summary>
		/// Sets the speed of the fade (lower = faster).
		/// The default value is 10
		/// </summary>
		[Category("Behavior")]
		[DefaultValue(10)]
		[Description("Sets the speed of the fade (lower = faster).")]
		public int FadeSpeed
		{
			get { return _FadeSpeed; }
			set { _FadeSpeed = value; }
		}

		private string _OnViewChange;

		/// <summary>
		/// Client-side method to call when map view have changed
		/// </summary>
		[Bindable(false)]
		[Category("Behavior")]
		[DefaultValue("")]
		[Description("Client-side method to call when map view have changed")]
		public string OnViewChange
		{
			get { return _OnViewChange; }
			set { _OnViewChange = value; }
		}

		private string _OnViewChanging;

		/// <summary>
		/// Client-side method to call when map are starting to update
		/// </summary>
		[Bindable(false)]
		[Category("Behavior")]
		[DefaultValue("")]
		[Description("Client-side method to call when map are starting to update")]
		public string OnViewChanging
		{
			get { return _OnViewChanging; }
			set { _OnViewChanging = value; }
		}

		private string _OnClickEvent;

		/// <summary>
		/// Gets or sets the clientside method to call when custom click-event is active.
		/// </summary>
		[Bindable(false)]
		[Category("Behavior")]
		[DefaultValue("")]
		[Description("Clientside method to call when custom click-event is active")]
		public string OnClickEvent
		{
			get { return _OnClickEvent; }
			set { _OnClickEvent = value; }
		}

		/// <summary>
		/// Gets the name of the clientside ClickEvent property on the map object.
		/// </summary>
		public string ClickEventPropertyName
		{
			get { return this.ClientID + "Obj.clickEvent"; }
		}

		/// <summary>
		/// Gets the name of the clientside ToogleClickEvent method to enable or disable 
		/// the custom click-event on the map object.
		/// </summary>
		public string ToogleClickEventMethodName
		{
			get { return this.ClientID + "Obj.toogleClickEvent"; }
		}
		/// <summary>
		/// Gets the name of the clientside DisableClickEvent method to disable 
		/// the custom click-event on the map object.
		/// </summary>
		public string DisableClickEventMethodName
		{
			get { return this.ClientID + "Obj.disableClickEvent"; }
		}
		/// <summary>
		/// Gets the name of the clientside EnableClickEvent method to enable
		/// the custom click-event on the map object.
		/// </summary>
		public string EnableClickEventMethodName
		{
			get { return this.ClientID + "Obj.enableClickEvent"; }
		}

		private bool _UseCache;

		/// <summary>
		/// Sets whether the control should use the http cache or call a specific maphandler
		/// </summary>
		[Bindable(false)]
		[Category("Behavior")]
		[DefaultValue(true)]
		[Description("Sets whether the control should use the http cache or call a specific maphandler")]
		public bool UseCache
		{
			get { return _UseCache; }
			set { _UseCache = value; }
		}

		private string _StatusBarText = "[X], [Y] - Map width=[ZOOM]";

		/// <summary>
		/// Text shown on the map status bar.
		/// </summary>
		/// <remarks>
		/// <para>Use [X] and [Y] to display cursor position in world coordinates and [ZOOM] for displaying the zoom value.</para>
		/// <para>The default value is "[X], [Y] - Map width=[ZOOM]"</para>
		/// </remarks>
		[Bindable(false)]
		[Category("Appearance")]
		[DefaultValue("[X], [Y] - Map width=[ZOOM]")]
		[Description("Text shown on the map status bar.")]
		public string StatusBarText
		{
			get { return _StatusBarText; }
			set { _StatusBarText = value; }
		}

		private string _ResponseFormat = "myMapHandler.aspx?Width=[WIDTH]&Height=[HEIGHT]&Zoom=[ZOOM]&X=[X]&Y=[Y]";

		/// <summary>
		/// Formatting of the callback response used when <see cref="UseCache"/> is false.
		/// </summary>
		/// <remarks>
		/// <para>
		/// Use [X] and [Y] for center position, [ZOOM] for zoom value,
		/// [WIDTH] for image width and [WIDTH] for image height. These values will automatically
		/// be replaced by the current values. The return-result should correspond to the url of
		/// a maphandler that renders the map from these values
		/// </para>
		/// <para>myMapHandler.aspx?Width=[WIDTH]&amp;Height=[HEIGHT]&amp;Zoom=[ZOOM]&amp;X=[X]&amp;Y=[Y]</para>
		/// </remarks>
		[Bindable(false)]
		[Category("Data")]
		[DefaultValue("myMapHandler.aspx?Width=[WIDTH]&Height=[HEIGHT]&Zoom=[ZOOM]&X=[X]&Y=[Y]")]
		[Description("Formatting of the callback response used when UseCache property is false.")]
		public string ResponseFormat
		{
			get { return _ResponseFormat; }