C++ Builder 使用 Windows 系統 IP 位址輸入控件完整教學

為什麼需要專用 IP 控件？

在網路應用開發中，使用一般 TEdit 輸入 IP 位址存在諸多痛點：無法自動驗證各段範圍 (0-255)、不支援鍵盤導航、需自行處理字串與 32 位整數轉換。Windows 通用控制庫 (comctl32.dll) 內建專業級 IP Address Control (SysIPAddress32)，完美解決這些問題，且為系統原生元件，無額外部署負擔。

核心初始化步驟

1. 初始化通用控制庫

必須呼叫 InitCommonControlsEx 並指定 ICC_INTERNET_CLASSES 旗標：

#include <commctrl.h>

// 在 WinMain 或 FormCreate 最早處執行
INITCOMMONCONTROLSEX icex = {0};
icex.dwSize = sizeof(INITCOMMONCONTROLSEX);
icex.dwICC = ICC_INTERNET_CLASSES;
InitCommonControlsEx(&icex);

2. 建立 IP 控件實例

// 視窗類別名稱常數：WC_IPADDRESS (定義於 commctrl.h)
HWND hIpEdit = CreateWindowEx(
    0,                              // 擴展樣式
    WC_IPADDRESS,                   // 類別名稱 "SysIPAddress32"
    NULL,                           // 無標題
    WS_CHILD | WS_VISIBLE | WS_TABSTOP, // 樣式
    10, 10, 150, 25,                // 位置與大小
    hWndParent,                     // 父視窗
    (HMENU)IDC_IPADDRESS,           // 控制項 ID
    hInstance,                      // 應用程式實例
    NULL                            // 建立參數
);

六大核心訊息完整對照表

實用操作範例

設定 IP 位址 (192.168.1.100)

DWORD dwIP = MAKEIPADDRESS(192, 168, 1, 100); // 宏定義於 commctrl.h
SendMessage(hIpEdit, IPM_SETADDRESS, 0, (LPARAM)dwIP);

取得 IP 位址並轉為字串

DWORD dwIP = 0;
int nFields = (int)SendMessage(hIpEdit, IPM_GETADDRESS, 0, (LPARAM)&dwIP);
if (nFields == 4) {
    char szIP[16];
    wsprintfA(szIP, "%d.%d.%d.%d",
        FIRST_IPADDRESS(dwIP), SECOND_IPADDRESS(dwIP),
        THIRD_IPADDRESS(dwIP), FOURTH_IPADDRESS(dwIP));
    // 使用 szIP...
}

限制第一欄位為 10-200 (私有網段)

// 低位元組=下限(10), 高位元組=上限(200)
SendMessage(hIpEdit, IPM_SETRANGE, 0, (LPARAM)(200 << 8 | 10));

檢查使用者是否已輸入完整

if (SendMessage(hIpEdit, IPM_ISBLANK, 0, 0) == 0) {
    // 至少有一欄有輸入
    DWORD dwIP = 0;
    if (SendMessage(hIpEdit, IPM_GETADDRESS, 0, (LPARAM)&dwIP) == 4) {
        // 四欄皆已填滿
    }
}

處理通知訊息 IPN_FIELDCHANGED

當使用者修改任一欄位或焦點移動時觸發，可用於即時驗證或啟用/停用按鈕：

void __fastcall TForm1::WndProc(TMessage &Message) {
    if (Message.Msg == WM_NOTIFY) {
        LPNMHDR pNMHDR = (LPNMHDR)Message.LParam;
        if (pNMHDR->code == IPN_FIELDCHANGED) {
            LPNMIPADDRESS pIPAddr = (LPNMIPADDRESS)pNMHDR;
            // pIPAddr->iField = 變更的欄位索引 (0-3)
            // pIPAddr->iValue = 該欄位新值 (0-255)
            // 可在此即時檢查完整性
        }
    }
    TForm::WndProc(Message);
}

C++ Builder 整合技巧

• 將上述建立碼置於 FormCreate 或自訂元件建構子
• 建立包裝類別封裝 HWND 與訊息發送，提供 Text、IPAddress (DWORD)、Range[4] 等屬性
• 專案選項 Linker → Output → Dynamic RTL 需關閉，確保通用控制庫正確連結
• 部署時無需額外 DLL，comctl32.dll 為系統核心元件 (Win98/IE3 以上內建)

常見陷阱與解決方案