Google Maps API 2.0解析(4-公用函数)

  

//创建一个以a为NodeName的htmlElement。b,c,d为可选参数，分别为：父对象、位置、大小
  function CreateElement(a,b,c,d)
  {
   var e=GetDocument(b).createElement(a);
   if(b)
   {
    AppendChild(b,e)
   }
   if(c)SetPosition(e,c);
   if(d)SetSize(e,d);
   return e
  }
  //创建文本节点，a试问本内容，b是父节点
  function CreateTextNode(a,b)
  {
   var c=GetDocument(b).createTextNode(a);
   if(b)
   {
    AppendChild(b,c)
   }
   return c
  }
  //返回文档对象
  function GetDocument(a)
  {
   return(a?a.ownerDocument:null)||document
  }
  function GetPixelValue(a)
  {
   return getMathRound(a)+"px"
  }
  function GetEMValue(a)
  {
   return a+"em"
  }
  //设置HTML控件的位置
  function SetPosition(a,b)
  {
   var c=a.style;
   c.position="absolute";
   c.left=GetPixelValue(b.x);
   c.top=GetPixelValue(b.y)
  }
  function setLeft(a,b)
  {
   a.style.left=GetPixelValue(b)
  }
  //设置控件的大小
  function SetSize(a,b)
  {
   var c=a.style;
   c.width=GetPixelValue(b.width);
   c.height=GetPixelValue(b.height)
  }
  function setWidth(a,b)
  {
   a.style.width=GetPixelValue(b)
  }
  function setHeight(a,b)
  {
   a.style.height=GetPixelValue(b)
  }
  function GetElementById(a)
  {
   return document.getElementById(a)
  }
  function setDisplayNone(a)
  {
   a.style.display="none"
  }
  function setDisplayNormal(a)
  {
   a.style.display=""
  }
  function setVisibilityHidden(a)
  {
   a.style.visibility="hidden"
  }
  function setVisibilityNormal(a)
  {
   a.style.visibility=""
  }
  function setVisibilityVisible(a)
  {
   a.style.visibility="visible"
  }
  function setPositionRelative(a)
  {
   a.style.position="relative"
  }
  function setPositionAbsolute(a)
  {
   a.style.position="absolute"
  }
  function setOverflowHidden(a)
  {
   a.style.overflow="hidden"
  }
  //返回最接近a,而且在b,c范围内的值
  function GetNumberInRange(a,b,c)
  {
   if(b!=null)
   {
    a=GetMathMax(a,b)
   }
   if(c!=null)
   {
    a=GetMathMin(a,c)
   }
   return a
  }
  //本函数类似于一个取余的过程
  function getLoopNumber(a,b,c)
  {
   while(a>c)
   {
    a-=c-b
   }
   while(a<b)
   {
    a+=c-b
   }
   return a
  }
  function getMathRound(a)
  {
   return Math.round(a)
  }
  function getMathFloor(a)
  {
   return Math.floor(a)
  }
  function ib(a)
  {
   return Math.ceil(a)
  }
  //获取最大值
  function GetMathMax(a,b)
  {
   return Math.max(a,b)
  }
  //获取最小值
  function GetMathMin(a,b)
  {
   return Math.min(a,b)
  }
  function getMathAbs(a)
  {
   return Math.abs(a)
  }
  //设置鼠标样式
  function setCursor(a,b)
  {
   try
   {
    a.style.cursor=b
   }
   catch(c)
   {
    if(b=="pointer")
    {
     setCursor(a,"hand")
    }
   }
  }
  //阻止事件默认行为的执行
  function PreventEventDefault(a)
  {
   if(browser.type==1)
   {
    window.event.cancelBubble=true;
    window.event.returnValue=false
   }
   else
   {
    a.preventDefault();
    a.stopPropagation()
   }
  }
  //取消事件冒泡
  function CancelEventBubble(a)
  {
   if(browser.type==1)
   {
    window.event.cancelBubble=true
   }
   else
   {
    a.stopPropagation()
   }
  }
  function SetNoPrint(a)
  {
   a.className="gmnoprint"
  }
  function setNoScreen(a)
  {
   a.className="gmnoscreen"
  }
  function setZIndex(a,b)
  {
   a.style.zIndex=b
  }
  //变量是否已经定义
  function isDefined(a)
  {
   return typeof a!="undefined"
  }
  function isNumber(a)
  {
   return typeof a=="number"
  }
  //c毫秒后执行a的b方法
  function setWindowTimeOut(a,b,c)
  {
   return window.setTimeout(function()
   {
    b.apply(a)
   },c)
  }

  //计算两个HTML控件(b包含a)之间的位置差距
  function getOffset(a,b)
  {
   var c=new GPoint(0,0);
   while(a&&a!=b)
   {
    if(a.nodeName=="BODY")
    {
     getBodyOffset(c,a)
    }
    var d=getBorderSize(a);
    c.x+=d.width;
    c.y+=d.height;
    if(a.nodeName!="BODY"||!browser.isFirefox())
    {
     c.x+=a.offsetLeft;
     c.y+=a.offsetTop
    }
    if(browser.isFirefox()&&browser.revision>=1.8&&a.offsetParent&&a.offsetParent.nodeName!="BODY"&&getStyleValue(a.offsetParent,"overflow")!="visible")
    {
     var d=getBorderSize(a.offsetParent);
     c.x+=d.width;
     c.y+=d.height
    }
    if(a.offsetParent)
    {
     c.x-=a.offsetParent.scrollLeft;
     c.y-=a.offsetParent.scrollTop
    }
    if(browser.type!=1&&Yd(a))
    {
     if(browser.isFirefox())
     {
      c.x-=self.pageXOffset;
      c.y-=self.pageYOffset;
      var e=getBorderSize(a.offsetParent.parentNode);
      c.x+=e.width;
      c.y+=e.height
     }
     break
    }
    if(browser.type==2&&a.offsetParent)
    {
     var d=getBorderSize(a.offsetParent);
     c.x-=d.width;
     c.y-=d.height
    }
    a=a.offsetParent
   }
   if(browser.type==1&&!b&&document.documentElement)
   {
    c.x+=document.documentElement.clientLeft;
    c.y+=document.documentElement.clientTop
   }
   if(b&&a==null)
   {
    var f=getOffset(b);
    return new GPoint(c.x-f.x,c.y-f.y)
   }
   else
   {
    return c
   }
  }
  function Yd(a)
  {
   if(a.offsetParent&&a.offsetParent.nodeName=="BODY"&&getStyleValue(a.offsetParent,"position")=="static")
   {
    if(browser.type==0&&getStyleValue(a,"position")!="static")
    {
     return true
    }
    else if(browser.type!=0&&getStyleValue(a,"position")=="absolute")
    {
     return true
    }
   }
   return false
  }
  //获取Body对象的margin和border所使用的像素大小
  function getBodyOffset(a,b)
  {
   var c=false;
   if(browser.isFirefox())
   {
    c=getStyleValue(b,"overflow")!="visible"&&getStyleValue(b.parentNode,"overflow")!="visible";
    var d=getStyleValue(b,"position")!="static";
    if(d||c)
    {
     a.x+=getCssDummy(b,"margin-left");
     a.y+=getCssDummy(b,"margin-top");
     var e=getBorderSize(b.parentNode);
     a.x+=e.width;
     a.y+=e.height
    }
    if(d)
    {
     a.x+=getCssDummy(b,"left");
     a.y+=getCssDummy(b,"top")
    }
   }
   if((browser.isFirefox()||browser.type==1)&&document.compatMode!="BackCompat"||c)
   {
    if(self.pageYOffset)
    {
     a.x-=self.pageXOffset;
     a.y-=self.pageYOffset
    }
    else
    {
     a.x-=document.documentElement.scrollLeft;
     a.y-=document.documentElement.scrollTop
    }
   }
  }
  //获取一个HTML对象的clientX和clientY
  function getClientPoint(a)
  {
   if(browser.type==2)
   {
    return new GPoint(a.pageX-self.pageXOffset,a.pageY-self.pageYOffset)
   }
   else
   {
    return new GPoint(a.clientX,a.clientY)
   }
  }
  //获取事件a发生处相对于b的位置
  function getEventOffset(a,b)
  {
   if(isDefined(a.offsetX))
   {
    var c=getEventTarget(a);
    var d=getOffset(c,b);
    var e=new GPoint(a.offsetX,a.offsetY);
    if(browser.type==2)
    {
     var f=getBorderSize(c);
     e.x-=f.width;
     e.y-=f.height
    }
    return new GPoint(d.x+e.x,d.y+e.y)
   }
   else if(isDefined(a.clientX))
   {
    var g=getClientPoint(a);
    var h=getOffset(b);
    return new GPoint(g.x-h.x,g.y-h.y)
   }
   else
   {
    return GPoint.ORIGIN
   }
  }
  //获取事件的触发源
  function getEventTarget(a)
  {
   var b=a.target||a.srcElement;
   if(b.nodeType==3)
   {
    b=b.parentNode
   }
   return b
  }
  //从数据a之中删除b项，返回删除的个数
  function RemoveFromArray(a,b,c)
  {
   var d=0;
   for(var e=0;e<a.length;++e)
   {
    if(a[e]===b||c&&a[e]==b)
    {
     a.splice(e--,1);
     d++
    }
   }
   return d
  }
  //向数组a添加一个项d,如果存在相同项目，则不添加并返回false
  function addToArray(a,b,c)
  {
   for(var d=0;d<a.length;++d)
   {
    if(a[d]===b||c&&a[d]==b)
    {
     return false
    }
   }
   a.push(b);
   return true
  }
  //将b对象设置为a的子项
  function AppendChild(a,b)
  {
   a.appendChild(b)
  }
  //从文档之中删除a
  function deposeNode(a)
  {
   if(a.parentNode)
   {
    a.parentNode.removeChild(a);
    clearNode(a)
   }
  }
  //清空a的所有子对象
  function removeNodeChildren(a)
  {
   var b;
   while(b=a.firstChild)
   {
    clearNode(b);
    a.removeChild(b)
   }
  }
  //设置a的innerHTML
  function setInnerHTML(a,b)
  {
   if(a.innerHTML!=b)
   {
    removeNodeChildren(a);
    a.innerHTML=b
   }
  }
  //设置a不可被用户选中
  function SetUnSelectable(a)
  {
   if(browser.isFirefox())
   {
    a.style.MozUserSelect="none"
   }
   else
   {
    a.unselectable="on";
    a.onselectstart=falseFunction
   }
  }
  //以多种参数执行b的c方法，参数列表在a之中
  function runMethodByArgumentsArray(a,b,c)
  {
   for(var d=0;d<a.length;d++)
   {
    c.call(b,a[d],d)
   }
  }
  //为多个对象(对象数组a)执行b方法，取返回结果的最大值或最小值
  //如果c为Math.max，则为最大值
  //如果c为Math.min,则为最小值
  function getComparedMethodResult(a,b,c)
  {
   var d;
   for(var e=0;e<a.length;++e)
   {
    var f=b.apply(a[e]);
    if(e==0)
    {
     d=f
    }
    else
    {
     d=c(d,f)
    }
   }
   return d
  }
  //为数组a之中的每一个项目运行b方法
  function RunMethodForAll(a,b)
  {
   for(var c=0;c<a.length;++c)
   {
    b.call(a[c])
   }
  }
  //为数组a之中的每一个项目运行b方法，并将运行结果以数组的方式返回
  function getMethodResultArray(a,b)
  {
   var c=[];
   for(var d=0;d<a.length;++d)
   {
    c.push(b.call(a[d]))
   }
   return c
  }
  //将数组b的一段内容复制到数组a之中
  function CopyArray(a,b,c,d)
  {
   var e=c||0;
   var f=d||b.length;
   for(var g=e;g<f;++g)
   {
    a.push(b[g])
   }
  }
  function falseFunction()
  {
   return false
  }
  //格式化经纬度数字
  function formatLatLngNumber(a)
  {
   var b=Math.round(a*1000000)/1000000;
   return b.toString()
  }
  //返回弧度
  function getRadianByDegree(a)
  {
   return a*GMath_PI/180
  }
  //返回角度
  function getDegreeByRadian(a)
  {
   return a/(GMath_PI/180)
  }
  //判断两点坐标之间的距离是否小到可以认为是同一个坐标点
  function isSameCoordinatePoint(a,b)
  {
   return getMathAbs(a-b)<=1.0E-9
  }


  //设置html对象的不透明度
  function setObjectOpacity(a,b)
  {
   if(browser.type==1)
   {
    a.style.filter="alpha(opacity="+getMathRound(b*100)+")"
   }
   else
   {
    a.style.opacity=b
   }
  }
  //创建一个背景为黑色，半透明层，在GLog里面使用
  function Md(a,b,c)
  {
   var d=CreateElement("div",a,b,c);
   d.style.backgroundColor="black";
   setObjectOpacity(d,0.35);
   return d
  }
  //返回Style属性
  function getStyleValue(a,b)
  {
   var c=GetDocument(a);
   if(a.currentStyle)
   {
    var d=getCssName(b);
    return a.currentStyle[d]
   }
   else if(c.defaultView&&c.defaultView.getComputedStyle)
   {
    var e=c.defaultView.getComputedStyle(a,"");
    return e?e.getPropertyValue(b):""
   }
   else
   {
    var d=getCssName(b);
    return a.style[d]
   }
  }
  var Bc="__mapsBaseCssDummy__";
  //本方法是Google地图制作精细的表现，本方法的目的是获取一个层的像素属性大小，Google为了能在所有浏览器里面都能有最好的效果，特意用本函数来避免浏览器处理不一致的情况
  //比如同样是margin，IE和Firefox就会有细微的不同的，这个不同大家制作网页的时候经常忽略，可是Google考虑到了
  function getCssDummy(a,b,c)
  {
   var d;
   if(c)
   {
    d=c
   }
   else
   {
    d=getStyleValue(a,b)
   }
   if(isNumber(d))
   {
    return d
   }
   else if(isNaN(parseInt(d)))
   {
    return d
   }
   else if(d.length>2&&d.substring(d.length-2)=="px")
   {
    return parseInt(d)
   }
   else
   {
    var e=a.ownerDocument.getElementById(Bc);
    if(!e)
    {
     var e=CreateElement("div",a,new GPoint(0,0),new GSize(0,0));
     e.id=Bc;
     setVisibilityHidden(e)
    }
    else
    {
     a.parentNode.appendChild(e)
    }
    e.style.width="0px";
    e.style.width=d;
    return e.offsetWidth
   }
  }
  var Cc="border-left-width";
  var Dc="border-top-width";
  //返回对象的border占用的像素大小
  function getBorderSize(a)
  {
   var b,c;
   var d=getStyleValue(a,Cc);
   if(isNaN(parseInt(d)))
   {
    b=0
   }
   else
   {
    b=getCssDummy(a,Cc,d)
   }
   var e=getStyleValue(a,Dc);
   if(isNaN(parseInt(e)))
   {
    c=0
   }
   else
   {
    c=getCssDummy(a,Dc,e)
   }
   return new GSize(b,c)
  }
  //这个函数的作用是将一个CSS属性名称变换JavaScript的引用名称，例如将font-size变换为fontSize
  //看到这里，我对Google的API开发人员的佩服又进了一层，首先是我从来不知道,replace函数还可以用function做参数的
  //其次是这么简单的转化方式我闻所未闻，要是我，肯定要做一个映射表了
  function getCssName(a)
  {
   return a.replace(/-(\w)/g,function(b,c)
   {
    return(""+c).toUpperCase()
   }
   )
  }
  //取消a包涵的所有输入框的输入焦点
  function blurChildrenInput(a)
  {
   RunFunction(a,function(b)
   {
    if(b.nodeName=="INPUT"&&b.getAttribute("type").toLowerCase()=="text"||b.nodeName=="TEXTAREA")
    {
     try
     {
      b.blur()
     }
     catch(c)
     {
     }
    }
   }
   )
  }
  //将b的原型赋给a
  function InheritClass(a,b)
  {
   var c=function()
   {
   };
   c.prototype=b.prototype;
   a.prototype=new c()
  };

        本节比较长，都是一些公用的函数，这些函数并没有对外开放，不过却是非常重要的，有些函数的存在只是为了代码混淆，而有些则是为了代码的清晰和可维护性而存在的。