CIPAddressCtrl 类

项目
10/18/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 地址控件是一种类似于编辑控件的控件，使你能够以 Internet 协议 (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 SDK 中的 CreateWindow 。

rect
对 IP 地址控件的大小和位置的引用。它可以是 CRect 对象或 RECT 结构。

pParentWnd
指向 IP 地址控件的父窗口的指针。不得为 NULL。

nID
IP 地址控件的 ID。

返回值

如果初始化成功，则返回非零值；否则返回 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
控件的子窗口 ID。

返回值

如果成功，则不为 0；否则为 0。

注解

使用 CreateEx 而不是 Create 来应用由 Windows 扩展样式前言 WS_EX_ 指定的扩展 Windows 样式。

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 类
 层次结构图

通过