C++ MFC 類成員函數巢狀呼叫：InsertSort 未宣告錯誤解決方案

開發者在 MFC 專案中，於全域函數 Mfa() 內呼叫類成員函數 InsertSort()，編譯錯誤 C2065: 'InsertSort' : undeclared identifier。本文分析作用域規則並提供三種解決方案。

錯誤根因：作用域與 this 指標

class CZHANGMIN1View : public CView {
    // 成員函數
    void InsertSort(unsigned char* pArray, int iLength) { ... }
};

// 全域函數 / 非成員函數
HDIB Mfa(HDIB hDIB, int n) {
    // ... 
    InsertSort(pArray, k); // ❌ 錯誤：Mfa 不是 CZHANGMIN1View 成員，無 this 指標
    // ...
}

• InsertSort 是 CZHANGMIN1View 的非靜態成員函數
• 非靜態成員函數呼叫**需要物件實例** (隱含 this 指標)
• Mfa 是全域函數，**無 this 指標**，無法直接呼叫成員函數

三種解決方案

方案一：將 Mfa 改為成員函數 — 最符合 OOP 設計 ✅

class CZHANGMIN1View : public CView {
public:
    void InsertSort(unsigned char* pArray, int iLength) { ... }
    
    HDIB Mfa(HDIB hDIB, int n) {  // ← 移入類別內部
        // ...
        InsertSort(pArray, k);    // ✅ 正確：隱含 this->InsertSort()
        // ...
    }
    
    void OnMfadaptive() {
        CZHANGMIN1Doc* pDoc = GetDocument();
        pDoc->m_hDIB = Mfa(pDoc->m_hDIB, 3); // 呼叫成員函數
        Invalidate(TRUE);
    }
};

• 優點：封裝性好、直接存取成員變數、符合 MFC Document/View 架構
• 缺點：若 Mfa 需在多處複用，耦合度較高

方案二：將 InsertSort 改為 static 靜態成員函數

class CZHANGMIN1View : public CView {
public:
    static void InsertSort(unsigned char* pArray, int iLength) { // ← static
        // 不使用 this、成員變數
    }
};

HDIB Mfa(HDIB hDIB, int n) {
    // ...
    CZHANGMIN1View::InsertSort(pArray, k); // ✅ 類別名呼叫，無需實例
    // ...
}

• 優點：不改變 Mfa 全域性質、效能略高 (無 this 傳遞)
• 缺點：InsertSort 無法存取非靜態成員、語意上「排序演算法」通常不屬於 View 類別

方案三：提取為獨立工具類/命名空間 — 最佳工程實踐 ✅

// ImageProcessing.h
namespace ImageProcessing {
    void InsertSort(unsigned char* pArray, int iLength) {
        // 純演算法，無副作用、無依賴
    }
    
    HDIB AdaptiveMedianFilter(HDIB hDIB, int n) {
        // ...
        InsertSort(pArray, k);
        // ...
    }
}

// CZHANGMIN1View.cpp
#include "ImageProcessing.h"

void CZHANGMIN1View::OnMfadaptive() {
    CZHANGMIN1Doc* pDoc = GetDocument();
    pDoc->m_hDIB = ImageProcessing::AdaptiveMedianFilter(pDoc->m_hDIB, 3);
    Invalidate(TRUE);
}

• 優點：關注點分離、演算法可複用、易單元測試、降低 View 類別複雜度、符合單一職責原則
• 缺點：需新增檔案、稍微增加專案結構

方案比較總結

MFC 專案結構建議

專案/
├── View/
│   ├── CZHANGMIN1View.h/.cpp     // 僅處理 UI、事件、繪圖
├── Doc/
│   ├── CZHANGMIN1Doc.h/.cpp      // 資料模型、序列化
├── Algorithm/
│   ├── ImageProcessing.h/.cpp    // 影像演算法核心
│   ├── FilterBase.h              // 濾波器基類
└── Common/
    ├── Utils.h                   // 通用工具
    └── Math.h                    // 數學函數

總結

C2065 錯誤本質是非成員函數嘗試呼叫非靜態成員函數。最佳解法是將演算法邏輯提取至獨立工具類/命名空間，實現關注點分離、提升可測試性與複用性。若專案規模較小，將 Mfa 遷入 View 類別或標記 InsertSort 為 static 均可快速解決。