CIPAddressCtrl 類別

發行項
10/12/2023

提供 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 ）僅適用于在 Microsoft Internet Explorer 4.0 和更新版本下執行的程式。它們也會在未來版本的 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 。

矩形
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 結構的參考，描述要建立之視窗的大小和位置，在 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 類別
 階層架構圖表

共用方式為