CNetAddressCtrl, classe
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 |
|---|---|
Construit un objet CNetAddressCtrl. |
Méthodes publiques
Nom |
Description |
|---|---|
Crée un contrôle d'adresse réseau avec les styles spécifiés et l'attache à l'objet actuel d' CNetAddressCtrl . |
|
Crée un contrôle d'adresse réseau avec les styles étendus spécifiés et l'attache à l'objet actuel d' CNetAddressCtrl . |
|
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. |
|
Extrait une représentation validée et analysée de l'adresse réseau associée au contrôle actuel d'adresse réseau. |
|
Récupère le type d'adresse réseau que le contrôle actuel d'adresse réseau peut prendre en charge. |
|
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.
.png "Dialogue avec contrôle de l'adresse réseau et info-bulle.")
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
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 pour la génération des contrôles communs Windows Vista.