marker 標記元件

標記元件,標示地圖上的點,例如:建築物或是有興趣的點。標記的外觀,可以透過使用相關的屬性而制定,像是「圖像資料(ImageAsset)」或「填色(FillColorV)」。也可以使用「CreateMarker動態新增標記,並使用「Any Component」方塊進行設定。

Properties 屬性

AnchorHorizontal 錨標水平位置
設定或取得標記元件中心相對於其圖像的水平位置。有效值1為左方、2為右方、3為中央。


AnchorVertical 錨標垂直位置
設定或取得標記元件中心相對於其圖像的垂直位置。有效值1為上方、2為中央、3為下方。

Description 屬性
設定或取得顯示在資訊視窗中的描述。當使用者點擊標記時,資訊視窗就會出現。

Draggable 可拖曳
設定或取得是否使用者可以拖曳地圖功能。這項功能是藉由長按後拖曳標記至一個新位置進行存取。
EnableInfobox 使用資訊框
當使用者點擊標記時,啟用或停用資訊視窗的顯示。

FillColor 填色
設定或取得顏色,用來填入標記。此屬性僅適用於使用向量圖像的標記,包括默認圖標。

Height 高度
設定或取得標記高度(以像素為單位)。

HeightPercent 高度百分比
設定標記高度在螢幕高度中的比例。

ImageAsset 圖像資料
設定或取得標記顯示的圖像。若設置為空字串「 」,將使用默認標記圖像。
Latitude 緯度
設定或取得標記的緯度(以度為單位呈現)。正的數值代表赤道以北,負的數值代表赤道以南。如果想要同時更新緯度與經度,請使用SetLocation方法

Longitude 經
設定或取得標記的經度(以度為單位呈現)。正的數值代表本初子午線以東,負的數值代表本初子午線以西。如果想要同時更新緯度與經度,請使用SetLocation法。
StrokeColor 畫線顏色
設定或取得
筆畫的顏色,用來畫標記的輪廓。

StrokeWidth 線寬
設定或取得筆畫的寬度,用來畫標記的輪廓。

Title 標題
設定或取得顯示在資訊視窗內的標題,使用者點擊標記時,標題就會出現。

Type 種類
取得功能的類型。以標記元件來說,類型將會一直是「標記」。

Visible 可見性
設定或取得是否元件在螢幕上為可見,如果元件為可見,數值為真;如果元件隱藏,數值為否。
Width 寬度
設定或取得標記寬度(以像素為單位)。

WidthPercent 寬度百分比
設定標記寬度在螢幕寬度中的比例。


Events 事件

Click 被點選
當使用者敲擊標記時,此事件就會執行。

Drag 拖曳
當操作拖曳時,以事件就會執行。

LongClick 被長按
當使用者長點擊在標記上,但是並沒有觸發拖曳的動作,此事件就會運作。注意,如果「可否拖曳(Draggable)」屬性為否的話,「長點擊」事件將不會被觸發。

StartDrag 開始拖曳
在一項拖曳的操作開始之前,事件就會運作。

StopDrag 停止拖曳
在一項拖曳的操作完成之後,事件就會運作。

Methods 方法

BearingToFeature(component mapFeature, boolean centroids)
對特徵的方位角(地圖特徵(元件),重心(布林值))
回傳從標記到地圖特徵的方位角(從北方以度為單位)。如果重心為真,則由特徵重心方位計算。否則,將以特徵中最接近標記的點計算。

BearingToPoint(number latitude, number longitude, boolean centroids)對點的方位角(緯度(數字),經度(數字),重心(布林值))
回傳從標記到被給予經緯度間的方位角(從正北方以度為單位)

DistanceToFeature(component mapFeature, boolean centroids)
到特徵的距離(地圖特徵(元件),重心(布林值) )
計算標記與被指定的地圖特徵(mapFeature)之間的距離。若重心(centroids)為真,計算出來的結果會是兩項特徵的重心之間的距離。否則,會根據兩項功能最接近的點進行計算。此外,當重心為否,若圓形與地圖功能相交或包含,這個方法會回傳0,。如果一項錯誤產生,此項方法將會回傳-1。

DistanceToPoint(number latitude, number longitude, boolean centroids) 到點的距離(緯度(數字),經度(數字),重心(布林值)
運算標記與被給予的經緯度之間的距離。如果重心為真,距離的計算是從標記的重心一直到被給予的點。否則,距離將會從標記最靠近被給予的點的那一點開始計算。此外,如果重心為否,並且被給予的點在標記之內,那麼這個方法將會回傳0。如果錯誤發生,將會回傳-1。

HideInfobox 隱藏資訊欄位
如果標記為可見的話,隱藏其資訊欄位。否則,將不會有任何動作產生。

SetLocation(number latitude, number longitude) 設定位置(緯度(數字),經度(數字))
移動標記的中心至一個特定的緯度和經度。比起分別設定緯度和經度,此項方法更有效率。
ShowInfobox 顯示資訊欄位
如果標記為不可見的話,顯示其資訊欄位。否則,此項方法將沒有任何影響。即使「啟用資訊欄位(EnableInfobox)」屬性為否,此項方法仍可被用來顯示資訊欄位。