萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

GMap.NET 自訂 Marker 完整指南:圖示、拖曳、高亮、閃爍與點擊事件

前言

GMap.NET 是 .NET (WinForms/WPF) 常用的離線/線上地圖控件。本文詳細說明如何建立自訂 GMapMarker,實作自訂圖示、滑鼠拖曳移動、滑入高亮、定時器閃爍與點擊事件等完整互動功能。

一、架構概念

  • GMapControl:地圖容器,持有多個 GMapOverlay (圖層)。
  • GMapOverlay:圖層集合,可包含 Markers、Polygons、Routes。
  • GMapMarker:標記基類,需覆寫 OnRender(Graphics g) 繪製外觀。

二、方案 A:直接使用內建 GMarkerGoogle

// 載入圖片
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);

適用於單純顯示圖片、不需額外互動邏輯的情境。

三、方案 B:繼承 GMapMarker 完整自訂

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();
        }
    }
}

四、滑鼠拖曳移動 Marker

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。

五、高亮與閃爍效果

1. 滑入高亮 (使用 BorderPen)

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();
    }
}

2. 定時器閃爍 (使用 HaloPen)

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();
}

六、完整初始化範例 (Form Load)

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));
}

七、效能與記憶體注意事項

  • 圖片共享:多個 Marker 使用同一張圖片時,請共用同一 Image 實例,避免重複載入佔用記憶體。
  • 及時 Dispose:Pen、Image、Marker 皆實作 IDisposable,清除圖層時呼叫 overlay.Clear() 並手動 Dispose。
  • 大量標記:超過 2,000 標記建議改用 GMapMarker 簡化版或啟用虛擬化 (僅繪製可視範圍)。
copyright © 萬盛學電腦網 all rights reserved