CIPAddressCtrl 類別

發行項
08/04/2024

提供 Windows 通用 IP 位址控制項的功能。

語法

class CIPAddressCtrl : public CWnd

成員

公用建構函式

名稱	描述
CIPAddressCtrl：：CIPAddressCtrl	建構 `CIPAddressCtrl` 物件。

公用方法

名稱	描述
CIPAddressCtrl：：ClearAddress	清除IP位址控制件的內容。
CIPAddressCtrl：：Create	建立IP位址控制件，並將它附加至 `CIPAddressCtrl` 物件。
CIPAddressCtrl：：CreateEx	使用指定的 Windows 擴充樣式建立 IP 位址控制件，並將它附加至 `CIPAddressCtrl` 物件。
CIPAddressCtrl：：GetAddress	擷取IP位址控制件中所有四個字段的位址值。
CIPAddressCtrl：：IsBlank	判斷IP位址控制件中的所有欄位是否都是空的。
CIPAddressCtrl：：SetAddress	設定IP位址控制件中所有四個字段的位址值。
CIPAddressCtrl：：SetFieldFocus	將鍵盤焦點設定為IP位址控制件中指定的欄位。
CIPAddressCtrl：：SetFieldRange	設定IP位址控制件中指定欄位中的範圍。

備註

IP 位址控制項，類似於編輯控制元件的控制項，可讓您以因特網通訊協定（IP）格式輸入及操作數值位址。

此控件（因此類別 CIPAddressCtrl ）僅適用於在 Internet Explorer 4.0 和更新版本 Microsoft下執行的程式。它們也會在未來版本的 Windows 和 Windows NT 下提供。

如需IP位址控制件的詳細資訊，請參閱 Windows SDK 中的IP位址控制件。

繼承階層架構

CObject

CCmdTarget

CWnd

CIPAddressCtrl

需求

標頭： afxcmn.h

CIPAddressCtrl：：CIPAddressCtrl

建立 CIPAddressCtrl 物件。

CIPAddressCtrl();

CIPAddressCtrl：：ClearAddress

清除IP位址控制件的內容。

void ClearAddress();

備註

此成員函式會實作 Win32 訊息 IPM_CLEARADDRESS的行為，如 Windows SDK 中所述。

CIPAddressCtrl：：Create

建立IP位址控制件，並將它附加至 CIPAddressCtrl 物件。

virtual BOOL Create(
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

參數

dwStyle
IP 位址控制件的樣式。套用視窗樣式的組合。您必須包含WS_CHILD樣式，因為控件必須是子視窗。如需 Windows 樣式清單，請參閱 Windows SDK 中的 CreateWindow 。

rect
IP 位址控制件大小和位置的參考。它可以是 CRect 物件或 RECT 結構。

pParentWnd
IP 位址控制件父視窗的指標。它不得為 NULL。

nID
IP 位址控制件的識別碼。

傳回值

如果初始化成功，則為非零;否則為 0。

備註

您會在兩個步驟中建構 CIPAddressCtrl 物件。

呼叫建構函式，這個建構函式會 CIPAddressCtrl 建立物件。
呼叫 Create，這會建立IP位址控制件。

如果您要搭配控制檔使用延伸視窗樣式，請呼叫 CreateEx 而非 Create。

CIPAddressCtrl：：CreateEx

呼叫此函式來建立控件（子視窗），並將它與 CIPAddressCtrl 對象產生關聯。

virtual BOOL CreateEx(
    DWORD dwExStyle,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

參數

dwExStyle
指定要建立之控件的擴充樣式。如需擴充 Windows 樣式的清單，請參閱 Windows SDK 中 CreateWindowEx 的 dwExStyle 參數。

rect
RECT 結構的參考，描述要建立之視窗的大小和位置，在 pParentWnd 的用戶端座標中。

pParentWnd
控件父系之視窗的指標。

nID
控制件的子視窗識別碼。

傳回值

如果成功則為非零；否則為 0。

備註

使用 CreateEx 而不是 Create 來套用延伸的 Windows 樣式，由 Windows 擴充樣式前文WS_EX_所指定。

CIPAddressCtrl：：GetAddress

擷取IP位址控制件中所有四個字段的位址值。

int GetAddress(
    BYTE& nField0,
    BYTE& nField1,
    BYTE& nField2,
    BYTE& nField3);

int GetAddress(DWORD& dwAddress);

參數

nField0
來自已封裝IP位址之欄位0值的參考。

nField1
來自已封裝IP位址之欄位 1 值的參考。

nField2
來自已封裝IP位址之欄位 2 值的參考。

nField3
來自已封裝IP位址之欄位3值的參考。

dwAddress
接收IP位址之 DWORD 值地址的參考。如需顯示 dwAddress 填滿方式的數據表，請參閱<備註>。

傳回值

IP 位址控制件中的非空白欄位數目。

備註

此成員函式會實作 Win32 訊息 IPM_GETADDRESS的行為，如 Windows SDK 中所述。在上述第一個原型中，控件欄位 0 到 3 中的數字分別由左至右讀取，填入四個參數。在上述第二個原型中， dwAddress 會填入如下。

欄位	包含域值的位
0	24 到 31
1	16 到 23
2	8 到 15
3	0 到 7

CIPAddressCtrl：：IsBlank

判斷IP位址控制件中的所有欄位是否都是空的。

BOOL IsBlank() const;

傳回值

如果所有IP位址控制欄位都是空的，則為非零;否則為 0。

備註

此成員函式會實作 Win32 訊息 IPM_ISBLANK的行為，如 Windows SDK 中所述。

CIPAddressCtrl：：SetAddress

設定IP位址控制件中所有四個字段的位址值。

void SetAddress(
    BYTE nField0,
    BYTE nField1,
    BYTE nField2,
    BYTE nField3);

void SetAddress(DWORD dwAddress);

參數

nField0
來自已封裝IP位址的欄位0值。

nField1
包裝IP位址的欄位1值。

nField2
包裝IP位址的欄位 2 值。

nField3
包裝IP位址的欄位3值。

dwAddress
包含新IP位址的 DWORD 值。如需顯示 DWORD 值填滿方式的數據表，請參閱<備註>。

備註

此成員函式會實作 Win32 訊息 IPM_SETADDRESS的行為，如 Windows SDK 中所述。在上述第一個原型中，控件欄位 0 到 3 中的數字分別由左至右讀取，填入四個參數。在上述第二個原型中， dwAddress 會填入如下。

欄位	包含域值的位
0	24 到 31
1	16 到 23
2	8 到 15
3	0 到 7

CIPAddressCtrl：：SetFieldFocus

將鍵盤焦點設定為IP位址控制件中指定的欄位。

void SetFieldFocus(WORD nField);

參數

nField
應該設定焦點之以零起始的欄位索引。如果此值大於欄位數目，焦點會設定為第一個空白欄位。如果所有欄位都是非空白的，焦點會設定為第一個字段。

備註

此成員函式會實作 Win32 訊息 IPM_SETFOCUS的行為，如 Windows SDK 中所述。

CIPAddressCtrl：：SetFieldRange

設定IP位址控制件中指定欄位中的範圍。

void SetFieldRange(
    int nField,
    BYTE nLower,
    BYTE nUpper);

參數

nField
要套用範圍之以零起始的欄位索引。

nLower
這個IP位址控制件中指定字段下限之整數的參考。

nUpper
這個IP位址控制件中，接收指定欄位上限之整數的參考。

備註

此成員函式會實作 Win32 訊息 IPM_SETRANGE的行為，如 Windows SDK 中所述。使用兩個參數 nLower 和 nUpper 來指出欄位的下限和上限，而不是搭配 Win32 訊息使用的 wRange 參數。

另請參閱

CWnd 類別
 階層架構圖表

共用方式為