MapObjects 專題圖渲染全解析：七大渲染器原理與實作代碼

渲染器體系概覽

MapObjects 2.x 提供 Renderer 抽象基類，七大具體渲染器對應不同視覺化需求：

核心實作片段

1. 圖表渲染：直方圖與餅圖

var cr = new ChartRendererClass();
cr.ChartType = ChartTypeConstants.moBar; // 或 moPIE
cr.FieldCount = 2;
cr.set_Field(0, "SURF_ELEV"); cr.set_Color(0, ColorConstants.moRed);
cr.set_Field(1, "DEPTH");     cr.set_Color(1, ColorConstants.moGreen);
layer.Renderer = cr;
map.Refresh();

2. 點密度渲染

var ddr = new DotDensityRendererClass();
ddr.Field = "DEPTH";
ddr.DotSize = 3; ddr.DotColor = ColorConstants.moBlue;
ddr.DotValue = 1; ddr.DrawBackground = true;
layer.Renderer = ddr;

3. 唯一值渲染（國家色碼）

var vmr = new ValueMapRendererClass();
vmr.Field = "FIPS_CODE";
vmr.ValueCount = countryCodes.Count;
vmr.UseDefault = true; vmr.DefaultSymbol.Color = ColorConstants.moYellow;
for (short i = 0; i < vmr.ValueCount; i++)
    vmr.set_Value(i, countryCodes[i]);
layer.Renderer = vmr;

4. 分級渲染（人口統計）

var cbr = new ClassBreaksRendererClass();
cbr.SymbolType = SymbolTypeConstants.moPointSymbol;
cbr.Field = "POPULATION";
var stat = layer.Records.CalculateStatistics("POPULATION");
double val = stat.Mean - 3 * stat.StdDev;
for (int i = 0; i < 6; i++) {
    if (val >= stat.Min && val <= stat.Max) {
        cbr.BreakCount++;
        cbr.set_Break(cbr.BreakCount - 1, val);
    }
    val += stat.StdDev;
}
cbr.SizeSymbols(3, 8);           // 大小漸變
cbr.RampColors(moWhite, moRed);  // 顏色漸變
layer.Renderer = cbr;

5. 組合渲染：標註 + 唯一值

var gr = new GroupRendererClass();
gr.Add(valueMapRenderer);  // 底層：面塊色
gr.Add(labelRenderer);     // 上層：文字標註
layer.Renderer = gr;

常見坑點與對策

• Refresh() 不生效：嘗試 map.Extent = map.FullExtent 強制重繪。
• Recordset 操作：MoveNext() 循環讀取屬性值，用畢須 Close() 釋放游標。
• Statistics 依賴數值欄位：字串欄位呼叫 CalculateStatistics 會拋例外。
• ZRenderer 需幾何帶 Z 值：Shapefile 必須為 PointZ/PolygonZ 類型，否則無效果。

架構建議

將渲染器建立邏輯封裝為 IRendererFactory，依圖層類型/用戶選擇動態產生，UI 僅持有 Renderer 參考，符合開放封閉原則。範例專案採 WinForms + AxMapObjects2，代碼結構清晰，可直接遷移至 WPF/WinUI 專案（改用 WindowsFormsHost 載入 ActiveX）。