GMap.NET 是 .NET (WinForms/WPF) 常用的離線/線上地圖控件。本文詳細說明如何建立自訂 GMapMarker,實作自訂圖示、滑鼠拖曳移動、滑入高亮、定時器閃爍與點擊事件等完整互動功能。
GMapControl:地圖容器,持有多個 GMapOverlay (圖層)。GMapOverlay:圖層集合,可包含 Markers、Polygons、Routes。GMapMarker:標記基類,需覆寫 OnRender(Graphics g) 繪製外觀。// 載入圖片
Bitmap bmp = (Bitmap)Bitmap.FromFile(@"F:\Projects\GMapDemo\Images\pin.png");
// 建立標記 (自動置中)
GMapMarker marker = new GMarkerGoogle(new PointLatLng(25.033, 121.565), bmp);
overlay.Markers.Add(marker);
適用於單純顯示圖片、不需額外互動邏輯的情境。
using System;
using System.Drawing;
using GMap.NET;
using GMap.NET.WindowsForms;
namespace GMapWinFormDemo
{
public class GMapMarkerImage : GMapMarker
{
public Image Image { get; set; }
public Pen BorderPen { get; set; } // 高亮矩形框
public Pen HaloPen { get; set; } // 閃爍橢圓框
public GMapMarkerImage(PointLatLng p, Image img) : base(p)
{
Image = img;
Size = new Size(img.Width, img.Height);
// 置中偏移:讓圖片中心對準經緯度座標
Offset = new Point(-Size.Width / 2, -Size.Height / 2);
}
public override void OnRender(Graphics g)
{
if (Image == null) return;
Rectangle rect = new Rectangle(LocalPosition.X, LocalPosition.Y, Size.Width, Size.Height);
g.DrawImage(Image, rect);
if (BorderPen != null) g.DrawRectangle(BorderPen, rect); // 高亮
if (HaloPen != null) g.DrawEllipse(HaloPen, rect); // 閃爍
}
public override void Dispose()
{
BorderPen?.Dispose();
HaloPen?.Dispose();
base.Dispose();
}
}
}
private GMapMarkerImage _draggingMarker;
private bool _isMouseDown;
private void MapControl_MouseDown(object sender, MouseEventArgs e)
{
if (e.Button == MouseButtons.Left)
{
// 嘗試取得滑鼠下方的 Marker
var marker = mapControl.Overlays
.SelectMany(o => o.Markers)
.OfType<GMapMarkerImage>()
.FirstOrDefault(m => m.IsMouseOver == true); // 需自行實作 HitTest 或用 GMapControl 事件
if (marker != null)
{
_draggingMarker = marker;
_isMouseDown = true;
}
}
}
private void MapControl_MouseMove(object sender, MouseEventArgs e)
{
if (_isMouseDown && _draggingMarker != null)
{
// 將螢幕座標轉經緯度
PointLatLng latLng = mapControl.FromLocalToLatLng(e.X, e.Y);
_draggingMarker.Position = latLng;
mapControl.Invalidate(); // 觸發重繪
}
}
private void MapControl_MouseUp(object sender, MouseEventArgs e)
{
_isMouseDown = false;
_draggingMarker = null;
}
提示:GMap.NET 內建 OnMarkerClick、OnMarkerEnter、OnMarkerLeave 事件,建議直接訂閱這些事件處理高亮/選取,而非自行 HitTest。
private void MapControl_OnMarkerEnter(GMapMarker item)
{
if (item is GMapMarkerImage m)
{
m.BorderPen = new Pen(Brushes.Yellow, 3);
mapControl.Invalidate();
}
}
private void MapControl_OnMarkerLeave(GMapMarker item)
{
if (item is GMapMarkerImage m)
{
m.BorderPen?.Dispose();
m.BorderPen = null;
mapControl.Invalidate();
}
}
private System.Windows.Forms.Timer _blinkTimer = new System.Windows.Forms.Timer { Interval = 500 };
private void StartBlink(IEnumerable<GMapMarkerImage> targets)
{
_blinkTimer.Tick += (s, e) =>
{
foreach (var m in targets)
{
if (m.HaloPen == null)
m.HaloPen = new Pen(Brushes.Red, 2);
else
{
m.HaloPen.Dispose();
m.HaloPen = null;
}
}
mapControl.Invalidate();
};
_blinkTimer.Start();
}
private void Form1_Load(object sender, EventArgs e)
{
// 地圖基本設定
mapControl.MapProvider = GMap.NET.MapProviders.GMapProviders.OpenStreetMap;
mapControl.Position = new PointLatLng(25.033, 121.565);
mapControl.MinZoom = 3; mapControl.MaxZoom = 18; mapControl.Zoom = 12;
mapControl.MouseWheelZoomEnabled = true;
// 圖層
var overlay = new GMapOverlay("markers");
mapControl.Overlays.Add(overlay);
// 建立幾個測試 Marker
Image img = Image.FromFile(@"Images\pin.png");
for (int i = 0; i < 5; i++)
{
var m = new GMapMarkerImage(
new PointLatLng(25.033 + i * 0.01, 121.565 + i * 0.01), img);
m.ToolTipText = $"站點 {i + 1}";
m.ToolTipMode = MarkerTooltipMode.OnMouseOver;
overlay.Markers.Add(m);
}
// 訂閱事件
mapControl.OnMarkerEnter += MapControl_OnMarkerEnter;
mapControl.OnMarkerLeave += MapControl_OnMarkerLeave;
mapControl.OnMarkerClick += (m, e) => MessageBox.Show($"點擊: {m.ToolTipText}");
// 啟動閃爍示範 (前 2 個)
StartBlink(overlay.Markers.OfType<GMapMarkerImage>().Take(2));
}
Image 實例,避免重複載入佔用記憶體。Pen、Image、Marker 皆實作 IDisposable,清除圖層時呼叫 overlay.Clear() 並手動 Dispose。GMapMarker 簡化版或啟用虛擬化 (僅繪製可視範圍)。