C# GDI+ PointF 構造函數陷阱：字面量預設為 double 必須加 F 後綴

C# 中使用 GDI+ 繪圖時，PointF 結構體構造函數參數類型為 float。直接寫 new PointF(6.56, 7.58) 會編譯報錯，因為 C# 數值字面量預設類型推導規則。本文詳細解析類型推導機制、正確寫法、隱式轉換規則與最佳實踐。

錯誤現象

// 錯誤代碼
PointF p = new PointF(6.56, 7.58);  // CS1503: 無法從 "double" 轉換為 "float"

// 報錯信息
// Argument 1: cannot convert from 'double' to 'float'
// Argument 2: cannot convert from 'double' to 'float'

根因：C# 實數字面量預設為 double

• C# 語言規範：帶小數點的數值字面量（如 6.56）預設類型為 double。
• PointF(float x, float y) 構造函數要求 float 參數。
• double 到 float 屬於窄化轉換（可能丟失精度），C# 禁止隱式窄化轉換，必須顯式強制轉換或使用 float 字面量。

正確寫法三種

C# 數值字面量類型後綴完整表

隱式轉換規則矩陣 (無資料丟失方向)

// 隱式轉換鏈 (編譯器自動插入)
byte → short → int → long → float → double
           ↑
           char → int
           
// decimal 無隱式轉換到/從 float/double (精度考量)
// 必須顯式轉換：(float)3.14m 或 3.14f

關鍵點：long → float 是隱式允許的（雖可能丟失精度），但 double → float 禁止隱式，因為 double 精度高於 float，屬於明確窄化。

GDI+ 繪圖常見 PointF 使用場景

using (Graphics g = this.CreateGraphics())
using (Pen pen = new Pen(Color.Red, 2))
{
    // 繪製折線
    PointF[] points = {
        new PointF(10.5f, 20.3f),
        new PointF(100.7f, 50.1f),
        new PointF(150.2f, 120.9f)
    };
    g.DrawLines(pen, points);
    
    // 繪製字符串 (需 StringFormat)
    g.DrawString("Hello", this.Font, Brushes.Black, new PointF(50f, 50f));
    
    // 繪製矩形 (RectangleF)
    RectangleF rect = new RectangleF(10f, 10f, 100f, 50f);
    g.DrawRectangle(pen, Rectangle.Round(rect)); // 或 g.DrawRectangle(pen, rect.X, rect.Y, rect.Width, rect.Height);
}

避坑檢查單

1. [ ] 所有 PointF、SizeF、RectangleF 構造參數是否加 f 後綴？
2. [ ] 數學計算結果賦值給 float 變量時是否顯式轉換 (float)(x * y)？
3. [ ] 從 double 變量/屬性賦值給 float 時是否加 (float)？
4. [ ] decimal (貨幣) 與 float/double 混用時是否顯式轉換？
5. [ ] 關閉專案屬性 → Build → Prefer 32-bit 可能影響浮點性能，但不影響類型檢查。

總結

C# 實數字面量預設為 double，PointF 需要 float，double → float 禁止隱式轉換。給所有浮點字面量加 f 後綴 是最簡單、最安全、性能最好的習慣。這不僅適用於 PointF，還適用於所有 float 參數的 API 調用（WPF、Unity、OpenTK 等）。