在網絡程序中,我們常常碰到需要用戶輸入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)。
●初始化Windows自定義控制庫●
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_CHILD|WS_VISIBLE,10,10,135,47,Handle,0,HInstance,NULL);
●使用IP控件●
在程序中,我們通過向IP控件發送消息來與它通訊。IP控件可以響應的消息有以下6個,這些消息及它們的含義見下表:
消息常量 消息值 作用 參數及返回值
IPM_CLEARADDRESS WM_USER+100 清除IP控件中的IP串 參數無
IPM_SETADDRESS WM_USER+101 設置IP控件的IP串 Lparam為32位的IP值
IPM_GETADDRESS WM_USER+102 獲取IP控件中的IP串所對應的IP值(32位整數) Lparam為一個指向Integer變量的指針。返回值等於IP控件中非控的字段數目;獲取到的IP值存放在lparam 所指向的Integer變量中。
IPM_SETRANGE WM_USER+103 設置IP控件4個部分的其中一個的IP取值范圍 Wparam指明要設置取值范圍的部分;lparam的低16位字為該字段的范圍:高字節為上限,低字節為下限。
IPM_SETFOCUS WM_USER+104 設輸入焦點 Wparam指明哪個部分獲取焦點
IPM_ISBLANK WM_USER+105 IP串是否為空 參數無。返回值:若為空,返回非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的最後一個參數。
★㈣設置取值范圍(IPM_SETRANGE)★
SendMessage (hIpEdit, IPM_SETRANGE, 0, 200<<8|100);
此語句將IP控件的第一部分的范圍限制為100~200。在IPM_SETRANGE消息中,Wparam指明要設置的字段, 而lparam的低16位字為該字段的范圍:高字節為上限,低字節為下限。
★㈤設置輸入焦點(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);
}