使用Windows系統提供的IP控件

2019-11-17 05:12:27

字體：大中小

來源：轉載

供稿：網友

在網絡程序中，我們經常碰到需要用戶輸入ip地址的情況。然而C++ Builder并沒有為我們提供可以用于輸入IP串的控件，于是我們只好用TEdit控件（單行文本框）來接受用戶輸入的IP串。但是，使用TEdit來輸入IP串并不是一個好的主意，因為處理起來非常不方便。

事實上，在我們的身旁有一個專門用來輸入IP串的Windows控件，就象網絡鏈接屬性中， Internet 協議 (TCP/IP) 屬性中輸入IP的控件。IP控件會拒絕非法的IP串（在每個部分只能輸入0~255之間的數字）；它讓你可以輕松地獲取控件中的IP串所對應的IP值（32位整數），這省去了IP串和IP值之間相互轉換的麻煩；此外，你還能限制IP控件中所能輸入的IP的范圍。在本文中，我將向大家介紹如何在我們的C++ Builder程序中使用Windows的IP控件。Windows中有兩個非常重要的動態聯結庫：commctrl.dll和comctl32.dll，它們是Windows的自定義控制庫（Windows Common Controls）。自定義控制庫中包含了許多常用的Windows控件，如Statusbar，Coolbar，HotKey等；在C++ Builder中，這些控件大多數都已被包裝成可視化控件了。在Microsoft推出Internet EXPlorer 3之后，自定義控制庫中新增了一些控件，其中就包括Windows的IP控件（IP Address edit control）?！癯跏蓟疻indows自定義控制庫●Windows提供了兩個API函數，InitCommonControls和InitCommonControlsEx，用來初始化自定義控制庫。從名字我們不難看出這兩個API函數的關系：后者是前者的增強。假如你希望在程序中使用IP控件，你必須用InitCommonControlsEx來完成對自定義控制庫以及類的初始化。函數InitCommonControlsEx的原型如下：

typedef strUCt tagINITCOMMONCONTROLSEX {
DWord dwSize;// size of this structure
DWORD dwICC;// flags indicating which classes to be initialized
} INITCOMMONCONTROLSEX, *LPINITCOMMONCONTROLSEX;
WINCOMMCTRLAPI BOOL WINAPI InitCommonControlsEx(LPINITCOMMONCONTROLSEX);
IP控件屬于ICC_INTERNET_CLASSES類別的控件，假如要使用該控件，你應該在程序中包含如下的初始化代碼：
TInitCommonControlsEx ICC;
ICC.dwSize = sizeof(TInitCommonControlsEx);
ICC.dwICC= ICC_INTERNET_CLASSES;
if(!InitCommonControlsEx(&ICC))
return;//初始化組件失敗

●創建IP控件●Windows API函數CreateWindow或者CreateWindowEx都可以用來創建一個IP控件實例。IP控件的窗口類名為"SysIPAddress32",C++ Builder的commctrl.pas單元為其定義了一個符號常量WC_IPADDRESS。下面這條語句將在Form1上創建一個IP控件。HWND hIpEdit = CreateWindow(WC_IPADDRESS,NULL,WS_CHILDWS_VISIBLE,10,10,135,47,Handle,0,HInstance,NULL);●使用IP控件●在程序中，我們通過向IP控件發送消息來與它通訊。IP控件可以響應的消息有以下6個，這些消息及它們的含義見下表：消息常量消息值作用參數及返回值IPM_CLEARADDRESSWM_USER+100清除IP控件中的IP串參數無IPM_SETADDRESSWM_USER+101設置IP控件的IP串Lparam為32位的IP值IPM_GETADDRESSWM_USER+102獲取IP控件中的IP串所對應的IP值(32位整數)Lparam為一個指向Integer變量的指針。返回值等于IP控件中非控的字段數目；獲取到的IP值存放在lparam 所指向的Integer變量中。IPM_SETRANGEWM_USER+103設置IP控件4個部分的其中一個的IP取值范圍Wparam指明要設置取值范圍的部分；lparam的低16位字為該字段的范圍：高字節為上限，低字節為下限。
IPM_SETFOCUSWM_USER+104設輸入焦點Wparam指明哪個部分獲取焦點IPM_ISBLANKWM_USER+105IP串是否為空參數無。返回值：若為空，返回非0；不為空，返回0★㈠清空IP串（IPM_CLEARADDRESS）★SendMessage(hIpEdit,IPM_CLEARADDRESS,0,0);★㈡設置IP串（IPM_SETADDRESS）★

int nIP;
nIP=MAKEIPADDRESS(192,168,0,1); 
SendMessage(hIpEdit,IPM_SETADDRESS,0,nIP);
此例將IP控件的內容設為"192.168.0.1"，其中MAKEIPADDRESS是一個Win32宏，定義在commctrl.h頭文件中，它用來合成一個32位的IP值：
#define MAKEIPADDRESS(b1,b2,b3,b4)
((LPARAM)(((DWORD)(b1)<<24)+((DWORD)(b2)<<16)+((DWORD)(b3)<<8)+((DWORD)(b4))))
★㈢獲取IP值（IPM_GETADDRESS）★
int nIP;
SendMessage(hIpEdit,IPM_GETADDRESS,0,int(&nIP));
//nIP++;
//SendMessage(hIpEdit,IPM_SETADDRESS,0,nIP);//將IP加1再賦給IP控件。

若想要獲取IP控件中IP串所對應的IP值，你應該向IP控件發送IPM_GETADDRESS消息，并且需要把一個32位整數的地址作為SendMessage的最后一個參數?！铫柙O置取值范圍（IPM_SETRANGE）★SendMessage (hIpEdit, IPM_SETRANGE, 0, 200<<8100);此語句將IP控件的第一部分的范圍限制為100~200。在IPM_SETRANGE消息中，Wparam指明要設置的字段，而lparam的低16位字為該字段的范圍：高字節為上限，低字節為下限?！铫樵O置輸入焦點（IPM_SETFOCUS）★SendMessage(hIpEdit,IPM_SETFOCUS,3,0);//將輸入焦點設在IP控件的第四部分。㈥判定IP串是否為空（IPM_ISBLANK）

if(!SendMessage(hIpEdit,IPM_ISBLANK,0,0)) 
{
//IP控件中的IP串為空
}
else
{
//IP控件中的IP串至少有一部分不是空的
}

●IP控件的通知消息●當IP串被改動后或者輸入焦點發生了轉移，IP控件就會向它的父窗口發送通知消息IPN_FIELDCHANGED。在大多數情況下，我們都可以忽略此通知消息。以下是處理通知消息IPN_FIELDCHANGED的一個示例：

void __fastcall TForm1::WndPRoc(TMessage &Msg)
{
LPNMHDR p=(LPNMHDR)Msg.LParam;
if(Msg.Msg==WM_NOTIFY)
{
if(p->code==IPN_FIELDCHANGED)
{
//處理IP控件的IPN_FIELDCHANGED通知消息
}
}
TForm::WndProc(Msg);
}