MapBase (pParentElem, pTrans, locX, locY, locWidth, locHeight)
Description
主地圖函式物件,總管所有地圖元素的建構、呈現、更新及解構等,為Ultra版地圖網頁最主要函式。
Position
MapBase.js
Parameters
Parameter
|
Description
|
pParentElem
|
網頁DOM容器物件(Container Object),地圖將建構於此容器物件內。通常是div元素,也可以是span或其他類似容器件。
|
pTrans
|
設定使用ScaleTransformation或CachedLevelTransformation物件。
|
locX
|
地圖於容器物件中左上角位置,單位為像素或百分比。
|
locY
|
地圖於容器物件中左上角位置,單位為像素或百分比。
|
IocWidth
|
地圖於容器物件中寬度,單位為像素或百分比。
|
locHeight
|
地圖於容器物件中高度,單位為像素或百分比。
|
Properties
Property
|
Description
|
none
|
none
|
Methods
Method
|
Type
|
Description
|
FinalRelease()
|
|
主地圖函式物件解構函式,呼叫FinalRelease以釋放已建構的地圖及其所包含地圖元素。
|
getHObject()
|
|
取得地圖DOM物件,用於呈現相關幾何圖形物件,如多邊形選取之多邊形物件及選取結果之幾何物件展示。
|
getHPackage()
|
|
取得地圖之容器物件,用於放置其他資訊窗,如查詢結果表格視窗及索引圖視窗等。
|
getClientWidth()
|
|
取得地圖可視寬度,單位為像素。
|
getClientHeight()
|
|
取得地圖可視高度,單位為像素。
|
getCenterX()
|
|
取得圖面中心點X坐標。
|
putCenterX(newVal)
|
|
設定圖面中心點X坐標。
|
getCenterY()
|
|
取得圖面中心點Y坐標。
|
putCenterY(newVal)
|
|
設定圖面中心點Y坐標。
|
getScale()
|
|
取得圖面比例尺。
|
putScale(newVal)
|
|
設定圖面比例尺。
|
getCellSizeX()
|
|
取得螢幕上單一像素的實際地圖大小(X方向)。
|
getCellSizeY()
|
|
取得螢幕上單一像素的實際地圖大小(Y方向)。
|
MoveMapTo(centerX, centerY)
|
|
設定地圖中心點的圖面坐標。
|
ZoomMapTo(pEnvelope)
|
|
縮放地圖至pEnvelope變數範圍。
|
getCursorPosition(tEvent)
|
|
取得目前滑鼠遊標位置。
|
ToMapPoint(dX, dY)
|
|
將相對於可視地圖的螢幕坐標轉換為圖面坐標。
|
FromMapPoint(dX, dY)
|
|
將圖面坐標轉換為相對於可視地圖的螢幕坐標。
|
ToMapDistX(dX)
|
|
將螢幕坐標距離轉換為圖面坐標距離(X方向)。
|
ToMapDistY(dY)
|
|
將螢幕坐標距離轉換為圖面坐標距離(Y方向)。
|
FromMapDistX(dX)
|
|
將圖面坐標距離轉換為螢幕坐標距離(X方向)。
|
FromMapDistY(dY)
|
|
將圖面坐標距離轉換為螢幕坐標距離(Y方向)。
|
SelectMapTool(pMapEvent)
|
|
設定地圖目前操作工具。結束目前工具,並初始化指定工具。
|
getLayers()
|
|
取得服務圖層的子圖層陣列。
|
AddLayer(pElem)
|
|
加入圖層至地圖。
|
RemoveLayer(pLayer)
|
|
移除特定圖層。
|
RemoveAllLayers()
|
|
移除所有圖層。
|
getElements(nIndex)
|
|
取得地圖元素陣列。
|
AddElement(pElem)
|
|
加入一個新的地圖元素至地圖元素陣列。
|
RemoveElement(pElem)
|
|
將地圖元素於地圖元素陣列中移除。
|
RemoveAllElements()
|
|
移除所有地圖元素。
|
getExtent()
|
|
取得地圖範圍。
|
RefreshMap(bClearAll)
|
|
重新整理地圖。
|
MoveToAnimation(MapPT, MapScale, pFinalFunc)
|
|
以動畫形式移動地圖至指定圖面坐標及縮放層級,並於完成後呼叫pFinalFunc。pFinalFunc為function物件。
|
getViewport()
|
sg.geometry.Extent
|
取得目前view extent
|
Events
Event
|
Description
|
load
|
載入地圖時觸發
|
layer-add
|
加入Layer時觸發
|
layer-remove
|
移除單一Layer時觸發
|
layers-removed
|
同時移除多個Layer時觸發
|
mousedown
|
按下滑鼠時觸發
|
mouseup
|
放開滑鼠時觸發
|
mouseover
|
滑鼠移過時觸發
|
dblclick
|
連續點擊滑鼠時觸發
|
drag-start
|
開始拖曳地圖時觸發
|
drag
|
拖曳地圖時觸發
|
drag-end
|
拖曳地圖結束時觸發
|
angle-changed
|
地圖角度改變時(地圖被旋轉時)觸發
|
zoom-start
|
開始縮放地圖時觸發
|
zoom-end
|
縮放地圖結束時觸發
|
zoom
|
縮放地圖中觸發
|
See live example
©2015 Supergeo Technologies Inc.
|