CNetAddressCtrl-Klasse
Die Klasse stellt die CNetAddressCtrl Netzwerkadressen-Steuerelement dar, die Sie verwenden können, um das Format von IPv4, von IPv6 und benannten DNS-Adressen einzugeben und zu überprüfen.
class CNetAddressCtrl : public CEdit
Mitglieder
Öffentliche Konstruktoren
Name |
Description |
---|---|
Erstellt ein CNetAddressCtrl-Objekt. |
Öffentliche Methoden
Name |
Description |
---|---|
Erstellt eine Netzwerkadressen-Steuerelement mit angegebenen Formaten und fügt sie dem aktuellen CNetAddressCtrl-Objekt. |
|
Erstellt eine Netzwerkadressen-Steuerelement mit angegebenen erweiterten Formaten und fügt sie dem aktuellen CNetAddressCtrl-Objekt. |
|
Zeigt eine Fehlersprechblaseninfo an, wenn der Benutzer eine nicht unterstützte Netzwerkadresse in der Adressenkontrolle des aktuellen Netzwerks eingibt. |
|
Ruft eine überprüfen und analysierte Darstellung der Netzwerkadresse ab, die mit der Adressenkontrolle des aktuellen Netzwerks zugeordnet ist. |
|
Ruft den Typ der Netzwerkadresse ab, die den Adressenkontrolle des aktuellen Netzwerks unterstützen kann. |
|
Legt den Typ der Netzwerkadresse fest, den die Adressenkontrolle des aktuellen Netzwerks unterstützen kann. |
Hinweise
Die Netzwerkadressen-Steuerelement überprüft, ob das Format der Adresse, die der Benutzer eingibt, richtig ist.Das Steuerelement nicht tatsächlich schließt an die Netzwerkadresse an.Die CNetAddressCtrl::SetAllowType-Methode gibt eine oder mehrere Typen Adresse an, die die CNetAddressCtrl::GetAddress-Methode analysieren und überprüfen kann.Eine Adresse kann in Form eines IPv4, eines IPv6 oder mit einer Adresse für einen Server, ein Netzwerk, einen Host oder ein Broadcastmeldungsziel sein.Wenn das Format der Adresse falsch ist, können Sie die CNetAddressCtrl::DisplayErrorTip-Methode verwenden, um ein Infotippmeldungsfeld anzuzeigen, das sich grafisch im Textfeld der Netzwerkadressen-Steuerelement und zeigt eine vordefinierte Fehlermeldung anzeigt.
Die CNetAddressCtrl-Klasse wird von CEdit-Klasse abgeleitet.Daher bietet das Netzwerkadressen-Steuerelement Zugriff auf alle Windows-Bearbeitungssteuerelementmeldungen.
Die folgende Abbildung stellt ein Dialogfeld dar, das eine Netzwerkadressen-Steuerelement enthält.Das Textfeld (1) für das Netzwerkadressen-Steuerelement enthält eine ungültige Netzwerkadresse.Die Infotippmeldung (2) wird angezeigt, wenn die Netzwerkadresse ungültig ist.
Beispiel
Im folgenden Codebeispiel ist Teil eines Dialogfelds, das eine Netzwerkadresse überprüft.Die Ereignishandler für drei Optionsfelder geben an, dass die Netzwerkadresse einer von drei Adresstypen sein kann.Der Benutzer gibt eine Adresse im Textfeld des Netzwerksteuerelements ein drückt, dann eine Schaltfläche, um die Adresse zu überprüfen.Wenn die Adresse gültig ist, wird eine Erfolgsmeldung angezeigt; andernfalls wird die vordefinierte Infotippfehlermeldung angezeigt.
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"));
}
Im folgenden Codebeispiel aus der Dialogfeldheaderdatei definiert die NC_ADDRESS und NET_ADDRESS_INFORMATION-Variablen, die durch die CNetAddressCtrl::GetAddress-Methode erforderlich sind.
NC_ADDRESS m_na;
NET_ADDRESS_INFO m_nai;
Vererbungshierarchie
CNetAddressCtrl
Anforderungen
Header: afxcmn.h
Diese Klasse wird in Windows Vista und höher unterstützt.
Zusätzliche Anforderungen für diese Klasse werden in Build-Anforderungen für Windows Vista-gemeinsame Regelungen beschrieben.