共用方式為


CIPAddressCtrl 類別

提供 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 物件。

  1. 呼叫建構函式,這個建構函式會 CIPAddressCtrl 建立 物件。

  2. 呼叫 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 參數

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

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 中所述。 使用兩個參數 nLowernUpper 來指出欄位的下限和上限,而不是搭配 Win32 訊息使用的 wRange 參數。

另請參閱

CWnd 類別
階層架構圖表