Classe de CNetAddressCtrl

La classe d' CNetAddressCtrl représente le contrôle d'adresse réseau, que vous pouvez utiliser pour entrer et valider le format de l'IPv4, de IPv6 l', et les adresses nommées DNS.

class CNetAddressCtrl : public CEdit

Membres

Constructeurs publics

Nom	Description
CNetAddressCtrl::CNetAddressCtrl	Construit un objet CNetAddressCtrl.

Méthodes publiques

Nom	Description
CNetAddressCtrl::Create	Crée un contrôle d'adresse réseau avec les styles spécifiés et l'attache à l'objet actuel d' CNetAddressCtrl .
CNetAddressCtrl::CreateEx	Crée un contrôle d'adresse réseau avec les styles étendus spécifiés et l'attache à l'objet actuel d' CNetAddressCtrl .
CNetAddressCtrl::DisplayErrorTip	Affiche une info-bulle d'erreur lorsque l'utilisateur entre une adresse réseau non pris en charge dans le contrôle actuel d'adresse réseau.
CNetAddressCtrl::GetAddress	Extrait une représentation validée et analysée de l'adresse réseau associée au contrôle actuel d'adresse réseau.
CNetAddressCtrl::GetAllowType	Récupère le type d'adresse réseau que le contrôle actuel d'adresse réseau peut prendre en charge.
CNetAddressCtrl::SetAllowType	Définit le type d'adresse réseau que le contrôle actuel d'adresse réseau peut prendre en charge.

Notes

Le contrôle d'adresse réseau vérifie que le format de l'adresse que l'utilisateur entre est correct.Le contrôle ne se connecte pas réellement à l'adresse réseau.La méthode de CNetAddressCtrl::SetAllowType spécifie un ou plusieurs types d'adresse que la méthode de CNetAddressCtrl::GetAddress peut analyser et vérifier.Une adresse peut être sous la forme d'IPv4, de IPv6, ou d'adresse nommée pour un serveur, un réseau, un hôte, ou une destination des messages de distribution.Si le format de l'adresse est incorrect, vous pouvez utiliser la méthode de CNetAddressCtrl::DisplayErrorTip pour afficher un message d'infotip qui indique graphiquement la zone de texte du contrôle d'adresse réseau et affiche un message d'erreur intégré.

La classe d' CNetAddressCtrl est dérivée de la classe de CEdit .En conséquence, le contrôle d'adresse réseau fournit l'accès à tous les messages de contrôle d'édition windows.

L'illustration suivante représente une boîte de dialogue qui contient un contrôle d'adresse réseau.La zone de texte (1) pour le contrôle d'adresse réseau contient une adresse réseau non valide.Le message d'infotip (2) s'affiche si l'adresse réseau n'est pas valide.

Exemple

L'exemple de code suivant fait partie d'une boîte de dialogue qui valide une adresse réseau.Les gestionnaires d'événements pour trois cases d'option spécifient que l'adresse réseau peut être l'un des trois types d'adresse.L'utilisateur entre une adresse dans la zone de texte du contrôle de réseau, puis appuie sur un bouton pour valider l'adresse.Si l'adresse est valide, un message de réussite est restitué ; sinon, le message d'erreur intégré d'infotip s'affiche.

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

L'exemple de code suivant du fichier d'en-tête de dialogue définit les variables de NC_ADDRESS et de NET_ADDRESS_INFORMATION requises par la méthode de CNetAddressCtrl::GetAddress .

    NC_ADDRESS m_na;
    NET_ADDRESS_INFO m_nai;

Hiérarchie d'héritage

CObject

CCmdTarget

CWnd

CEdit

CNetAddressCtrl

Configuration requise

en-tête : afxcmn.h

Cette classe est prise en Windows Vista et versions ultérieures.

Les spécifications supplémentaires pour cette classe sont décrites dans Spécifications de génération des contrôles communs Windows Vista.

Voir aussi

Référence

Classe de CNetAddressCtrl

Graphique de la hiérarchie

Classe de CEdit