Partilhar via


Classe de 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

Bb399237.collapse_all(pt-br,VS.110).gifConstrutores public

Nome

Descrição

CNetAddressCtrl::CNetAddressCtrl

Constrói um objeto de CNetAddressCtrl .

Bb399237.collapse_all(pt-br,VS.110).gifMé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.

Caixa de diálogo com um controle de endereço de rede e uma InfoDica.

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 Criar requisitos de controles comuns do Windows Vista.

Consulte também

Referência

Classe de CNetAddressCtrl

Gráfico de hierarquia

Classe de CEdit