Classe CNetAddressCtrl

A classe de CNetAddressCtrl representa o controle de endereço de rede, que você pode usar para entrada e validar o formato IPv4, IPv6, e de endereços de nome DNS.

class CNetAddressCtrl : public CEdit

Membros

Construtores public

Nome	Descrição
CNetAddressCtrl::CNetAddressCtrl	Constrói um objeto de CNetAddressCtrl .

Métodos públicos

Nome	Descrição
CNetAddressCtrl::Create	Cria um controle de endereço de rede com os estilos especificados e anexa ao objeto atual de CNetAddressCtrl .
CNetAddressCtrl::CreateEx	Cria um controle de endereço de rede com os estilos estendidos especificados e anexá-la ao objeto atual de CNetAddressCtrl .
CNetAddressCtrl::DisplayErrorTip	Exibe um balão de dica de erro quando o usuário inserir um endereço de rede sem suporte no controle de endereço de rede atual.
CNetAddressCtrl::GetAddress	Recupera uma representação validada e analisada de endereço de rede associado ao controle de endereço de rede atual.
CNetAddressCtrl::GetAllowType	Recupera o tipo de endereço de rede que o controle de endereço de rede atual pode oferecer suporte.
CNetAddressCtrl::SetAllowType	Define o tipo de endereço de rede que o controle de endereço de rede atual pode oferecer suporte.

Comentários

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

A classe de CNetAddressCtrl é derivada da classe de CEdit . Portanto, o controle de endereço de rede fornece acesso a todas as mensagens do controle de edição do windows.

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

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 especifica 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, então pressiona um botão para validar o endereço. Se o endereço é válido, uma mensagem é exibida com êxito; caso contrário, a mensagem de erro predefinida de infotip é 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 de arquivo de cabeçalho da caixa de diálogo define as variáveis de NC_ADDRESS e de NET_ADDRESS_INFORMATION que são exigidos pelo método de CNetAddressCtrl::GetAddress .

  NC_ADDRESS m_na;
    NET_ADDRESS_INFO m_nai;

Hierarquia de herança

CObject

CCmdTarget

CWnd

CEdit

CNetAddressCtrl

Requisitos

Cabeçalho: afxcmn.h

Essa classe é suportado em Windows Vista e posteriormente.

Os requisitos adicionais para essa classe são descritos em Requisitos de compilação para controles comuns do Windows Vista.

Consulte também

Referência

Classe CNetAddressCtrl

Gráfico da hierarquia

Classe CEdit