CNetAddressCtrl选件类

CNetAddressCtrl 选件类表示网络地址控件，可以使用输入和验证IPv4、IPv6和名为DNS地址格式。

class CNetAddressCtrl : public CEdit

成员

公共构造函数

名称	说明
CNetAddressCtrl::CNetAddressCtrl	构造 CNetAddressCtrl 对象。

公共方法

名称	说明
CNetAddressCtrl::Create	使用指定的样式创建网络地址控件并将其附加到当前 CNetAddressCtrl 对象。
CNetAddressCtrl::CreateEx	使用指定的扩展样式创建网络地址控件并将其附加到当前 CNetAddressCtrl 对象。
CNetAddressCtrl::DisplayErrorTip	当用户在当今网络地址控件时，输入一个不受支持的网络地址显示错误气球状提示。
CNetAddressCtrl::GetAddress	检索网络地址的验证的和分析的表示与当今网络地址控件。
CNetAddressCtrl::GetAllowType	检索当今网络地址控件可以支持网络地址的类型。
CNetAddressCtrl::SetAllowType	设置当今网络地址控件可以支持网络地址的类型。

备注

网络地址控件验证用户输入地址的格式是否正确。 控件并不实际连接到网络地址。 CNetAddressCtrl::SetAllowType 方法指定 CNetAddressCtrl::GetAddress 方法可以分析和验证地址的一种或多种类型。 以IPv4、IPv6或命名地址服务器，网络，宿主的形式，地址可能很，或者广播消息目标。 如果地址的格式不正确，则可以使用 CNetAddressCtrl::DisplayErrorTip 方法显示图形方式指向网络地址控件文本框并显示预定义的错误消息中的信息提示消息框。

CNetAddressCtrl 选件类从 CEdit 选件类派生。 因此，网络地址控件提供对所有Windows编辑控件消息。

下图显示包含一个网络地址控件的对话框。 网络地址控件的文本框(1)包含无效网络地址。 如果网络地址无效，信息提示消息(2)显示。

示例

下面的代码示例是验证网络地址对话框的部分。 三个单选按钮的事件处理程序指定网络地址可能是三个地址类型之一。 用户在网络控件的文本框中输入地址，然后按按钮验证该地址。 如果该地址是否有效，成功将显示;否则，预定义的信息提示将显示一条错误消息。

void CCNetAddressCtrl_s1Dlg::OnBnClickedRadio1()
{
    m_netAddr.SetAllowType(NET_STRING_IPV4_ADDRESS);
}

void CCNetAddressCtrl_s1Dlg::OnBnClickedRadio2()
{
    m_netAddr.SetAllowType(NET_STRING_IPV6_ADDRESS);
}

void CCNetAddressCtrl_s1Dlg::OnBnClickedRadio3()
{
    m_netAddr.SetAllowType(NET_STRING_NAMED_ADDRESS);
}

void CCNetAddressCtrl_s1Dlg::OnBnClickedButton1()
{
    m_na.pAddrInfo = &m_nai;
    HRESULT rslt = m_netAddr.GetAddress(&m_na);
    if (rslt != S_OK)
        m_netAddr.DisplayErrorTip();
    else
    {
        MessageBox(
            _T("Success!"), _T("Validation Results"));
    }

下面的代码示例从对话框标头文件定义 CNetAddressCtrl::GetAddress 方法所需的 NC_ADDRESS 和 NET_ADDRESS_INFO 变量。

    NC_ADDRESS m_na;
    NET_ADDRESS_INFO m_nai;

继承层次结构

CObject

CCmdTarget

CWnd

CEdit

CNetAddressCtrl

要求

标头: afxcmn.h

此选件类在 Windows Vista 和更高版本支持。

此选件类的其他要求。Windows vista公共控件的生成要求所述。

请参见

参考

CNetAddressCtrl选件类

层次结构图

CEdit选件类