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 地址控件是一种类似于编辑控件的控件,使你能够以 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 对象。

  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 SDK 中的 CreateWindow

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