Compartir a través de


Clase CNetDirecciónCtrl

La clase de CNetAddressCtrl representa el control de dirección de red, que puede utilizar para especificar y validar el formato de IPv4, de IPv6, y de direcciones DNS con nombre.

class CNetAddressCtrl : public CEdit

Miembros

Constructores públicos

Name

Descripción

CNetAddressCtrl::CNetAddressCtrl

Crea un objeto CNetAddressCtrl.

Métodos públicos

Name

Descripción

CNetAddressCtrl::Create

Crea un control de dirección de red con estilos especificados y lo asocia al objeto actual de CNetAddressCtrl .

CNetAddressCtrl::CreateEx

Crea un control de dirección de red con estilos extendidos especificados y lo asocia al objeto actual de CNetAddressCtrl .

CNetAddressCtrl::DisplayErrorTip

Muestra un globo de sugerencias de error cuando el usuario escribe una dirección de red no compatibles en el control de dirección de red actual.

CNetAddressCtrl::GetAddress

Recupera una representación validar y analizada de dirección de red asociado al control de dirección de red actual.

CNetAddressCtrl::GetAllowType

Recupera el tipo de dirección de red que el control de dirección de red actual puede admitir.

CNetAddressCtrl::SetAllowType

Establece el tipo de dirección de red que el control de dirección de red actual puede admitir.

Comentarios

El control de dirección de red comprueba que el formato de la dirección que el usuario escribe es correcto. El control no conectarse realmente la dirección de red. el método de CNetAddressCtrl::SetAllowType especifica uno o más tipos de dirección que el método de CNetAddressCtrl::GetAddress pueda analizar y comprobar. Una dirección puede realizarse en forma de IPv4, IPv6, o dirección denominada para un servidor, una red, un host, o un destino del mensaje de difusión. Si el formato de la dirección es incorrecto, puede utilizar el método de CNetAddressCtrl::DisplayErrorTip para mostrar un cuadro de mensaje de infotip que señala gráficamente el cuadro de texto del control de dirección de red y muestra un mensaje de error predefinido.

la clase de CNetAddressCtrl es derivada de la clase de CEdit . Por consiguiente, el control de dirección de red proporciona acceso a todos los mensajes del control de edición de Windows.

La ilustración siguiente describe un diálogo que contiene un control de dirección de red. El cuadro de texto (1) del control de dirección de red contiene una dirección de red válida. Se muestra el mensaje de infotip (2) si la dirección de red no es válida.

Cuadro de diálogo con un control de dirección de red y un recuadro informativo.

Ejemplo

El siguiente ejemplo de código forma parte de un diálogo que valide una dirección de red. Los controladores de eventos para tres botones de radio especifica que la dirección de red puede tener uno de estos tres tipos de dirección. El usuario escribe una dirección en el cuadro de texto del control de red, se presiona un botón para validar la dirección. Si la dirección es válido, se muestra un mensaje correcto; si no, se muestra el mensaje de error predefinido de infotip.

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"));
    }

El ejemplo de código siguiente del archivo de encabezado de diálogo define las variables de NC_ADDRESS y de NET_ADDRESS_INFORMATION requeridas por el método de CNetAddressCtrl::GetAddress .

 NC_ADDRESS m_na;
    NET_ADDRESS_INFO m_nai;

Jerarquía de herencia

CObject

CCmdTarget

CWnd

CEdit

CNetAddressCtrl

Requisitos

encabezado: afxcmn.h

Esta clase se admite en Windows Vista y posterior.

los requisitos adicionales para esta clase se describen en Requisitos de compilación para los controles comunes de Windows Vista.

Vea también

Referencia

Clase CNetDirecciónCtrl

Gráfico de jerarquías

CEdit (Clase)