Partilhar via


Classe CNetAddressCtrl

The CNetAddressCtrl classe representa o controle de endereço de rede, que pode ser usada para entrada e validar o formato do IPv4, IPv6 e endereços DNS nomeados.

class CNetAddressCtrl : public CEdit

Comentários

O controle de endereço de rede verifica se o formato do endereço que o usuário insere está correto.O controle, na verdade, não conecta para o endereço de rede.The CNetAddressCtrl::SetAllowType método Especifica um ou mais tipos de endereço que o CNetAddressCtrl::GetAddress método pode analisar e verificar. Um endereço pode ser na forma de um IPv4, IPv6 ou nomeado endereço para um servidor, rede, host ou o destino de mensagem de difundido.Se o formato do endereço está incorreto, você pode usar o CNetAddressCtrl::DisplayErrorTip método para exibir uma caixa de mensagem infotip que aponta para a caixa de texto de controle de endereço de rede e exibe uma mensagem de erro predefinidos graficamente.

The CNetAddressCtrl classe é derivada da CEdit classe.Conseqüentemente, o controle de endereço de rede fornece acesso a todas as mensagens de controle de edição do Windows.

A figura a seguir mostra uma caixa de diálogo que contém um controle de endereço de rede.O texto caixa (1) para o controle de endereço de rede contém um endereço de rede inválido.A mensagem de infotip (2) será exibida se o endereço de rede é inválido.

Requisitos

Cabeçalho: afxcmn.h

Essa classe é suportada no Windows Vista e mais recente.

Requisitos adicionais para esta classe são descritos em compilação Requisitos para controles comuns do Windows Vista.

Exemplo

O exemplo de código a seguir é uma parte de uma caixa de diálogo que valida um endereço de rede.Os manipuladores de eventos para três botões de opção especificar que o endereço de rede pode ser um dos três tipos de endereço.O usuário insere um endereço na caixa de texto do controle de rede e, em seguida, pressiona um botão para validar o endereço.Se o endereço for válido, será exibida uma mensagem de êxito; caso contrário, a mensagem de erro infotip predefinidos é exibida.

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

O exemplo de código a seguir do arquivo de cabeçalho de caixa de diálogo define o NC_ADDRESS and NET_ADDRESS_INFO variáveis que são necessários para o CNetAddressCtrl::GetAddress método.

  NC_ADDRESS m_na;
    NET_ADDRESS_INFO m_nai;

Consulte também

Referência

Classe CNetAddressCtrl

Gráfico de hierarquia

Classe CEdit

Outros recursos

CNetAddressCtrl membros