CNetAddressCtrl-Klasse
Die Klasse CNetAddressCtrl stellt das Netzwerkadressen-Steuerelement dar, das verwendet werden kann, um IPv4-, IPv6- und benannte DNS-Adressen einzugeben und ihr Format zu überprüfen.
Syntax
class CNetAddressCtrl : public CEdit
Member
Öffentliche Konstruktoren
| Name | Beschreibung |
|---|---|
| CNetAddressCtrl::CNetAddressCtrl | Erstellt ein CNetAddressCtrl-Objekt. |
Öffentliche Methoden
| Name | Beschreibung |
|---|---|
| CNetAddressCtrl::Create | Erstellt ein Netzwerkadresssteuerelement mit angegebenen Formatvorlagen und fügt es an das aktuelle CNetAddressCtrl Objekt an. |
| CNetAddressCtrl::CreateEx | Erstellt ein Netzwerkadresssteuerelement mit angegebenen erweiterten Formatvorlagen und fügt es an das aktuelle CNetAddressCtrl Objekt an. |
| CNetAddressCtrl::D isplayErrorTip | Zeigt einen Fehlersprechblasentipp an, wenn der Benutzer eine nicht unterstützte Netzwerkadresse in das aktuelle Netzwerkadresssteuerelement eingibt. |
| CNetAddressCtrl::GetAddress | Ruft eine überprüfte und analysierte Darstellung der Netzwerkadresse ab, die dem aktuellen Netzwerkadresssteuerelement zugeordnet ist. |
| CNetAddressCtrl::GetAllowType | Ruft den Typ der Netzwerkadresse ab, die vom aktuellen Netzwerkadresssteuerelement unterstützt werden kann. |
| CNetAddressCtrl::SetAllowType | Legt den Typ der Netzwerkadresse fest, die vom aktuellen Netzwerkadresssteuerelement unterstützt werden kann. |
Hinweise
Das Netzwerkadressensteuerelement überprüft, ob das vom Benutzer eingegebene Format korrekt ist. Das Steuerelement stellt keine Verbindung mit der Netzwerkadresse her. Die CNetAddressCtrl::SetAllowType-Methode gibt einen oder mehrere Adresstypen an, die die CNetAddressCtrl::GetAddress-Methode analysieren und überprüfen kann. Eine Adresse kann in Form einer IPv4-, IPv6- oder benannten Adresse für ein Server-, Netzwerk-, Host- oder Übertragungsnachrichtenziel sein. Wenn das Format der Adresse falsch ist, können Sie die CNetAddressCtrl::D isplayErrorTip-Methode verwenden, um ein Infotip-Meldungsfeld anzuzeigen, das grafisch auf das Textfeld des Netzwerkadresssteuerelements zeigt und eine vordefinierte Fehlermeldung anzeigt.
Die CNetAddressCtrl Klasse wird von der CEdit-Klasse abgeleitet. Folglich bietet die Netzwerkadresssteuerung Zugriff auf alle Windows-Bearbeitungssteuerungsmeldungen.
Die folgende Abbildung zeigt ein Dialogfeld, das ein Netzwerkadresssteuerelement enthält. Das Textfeld (1) für das Netzwerkadresssteuerelement enthält eine ungültige Netzwerkadresse. Die Infoinfomeldung (2) wird angezeigt, wenn die Netzwerkadresse ungültig ist.
Beispiele
Das folgende Codebeispiel ist ein Teil eines Dialogfelds, das eine Netzwerkadresse überprüft. Die Ereignishandler für drei Optionsfelder geben an, dass die Netzwerkadresse einen von drei Adresstypen sein kann. Der Benutzer gibt eine Adresse in das Textfeld des Netzwerksteuerelements ein, und 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 Infoinfo-Fehlermeldung 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 Dialogheaderdatei werden die variablen NC_ADDRESS und NET_ADDRESS_INFO definiert, die von der CNetAddressCtrl::GetAddress-Methode benötigt werden.
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.
Weitere Anforderungen für diese Klasse werden in build requirements for Windows Vista Common Controls beschrieben.
CNetAddressCtrl::CNetAddressCtrl
Erstellt ein CNetAddressCtrl-Objekt.
CNetAddressCtrl();
Hinweise
Verwenden Sie die Methode "CNetAddressCtrl::Create " oder "CNetAddressCtrl::CreateEx ", um ein Netzwerksteuerelement zu erstellen und an das CNetAddressCtrl Objekt anzufügen.
CNetAddressCtrl::Create
Erstellt ein Netzwerkadresssteuerelement mit angegebenen Formatvorlagen und fügt es an das aktuelle CNetAddressCtrl Objekt an.
virtual BOOL Create(
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID);
Parameter
dwStyle
[in] Eine bitweise Kombination von Formatvorlagen, die auf das Steuerelement angewendet werden sollen. Weitere Informationen finden Sie unter "Formatvorlagen bearbeiten".
rect
[in] Ein Verweis auf eine RECT-Struktur , die die Position und Größe des Steuerelements enthält.
pParentWnd
[in] Ein Nicht-Null-Zeiger auf ein CWnd-Objekt , das das übergeordnete Fenster des Steuerelements ist.
Nid
[in] Die ID des Steuerelements.
Rückgabewert
TRUE, wenn diese Methode erfolgreich ist; andernfalls FALSE.
CNetAddressCtrl::CreateEx
Erstellt ein Netzwerkadresssteuerelement mit angegebenen erweiterten Formatvorlagen und fügt es an das aktuelle CNetAddressCtrl Objekt an.
virtual BOOL CreateEx(
DWORD dwExStyle,
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID);
Parameter
dwExStyle
[in] Eine bitweise Kombination (OR) erweiterter Formatvorlagen, die auf das Steuerelement angewendet werden sollen. Weitere Informationen finden Sie im dwExStyle-Parameter der CreateWindowEx-Funktion .
dwStyle
[in] Eine bitweise Kombination (OR) von Formatvorlagen, die auf das Steuerelement angewendet werden sollen. Weitere Informationen finden Sie unter "Formatvorlagen bearbeiten".
rect
[in] Ein Verweis auf eine RECT-Struktur , die die Position und Größe des Steuerelements enthält.
pParentWnd
[in] Ein Nicht-Null-Zeiger auf ein CWnd-Objekt , das das übergeordnete Fenster des Steuerelements ist.
Nid
[in] Die ID des Steuerelements.
Rückgabewert
TRUE, wenn diese Methode erfolgreich ist; andernfalls FALSE.
CNetAddressCtrl::D isplayErrorTip
Zeigt eine Fehlermeldung in der Sprechblase-Info an, die dem aktuellen Netzwerkadresssteuerelement zugeordnet ist.
HRESULT DisplayErrorTip();
Rückgabewert
Der Wert S_OK , wenn diese Methode erfolgreich ist; andernfalls ein Fehlercode.
Hinweise
Verwenden Sie die CNetAddressCtrl::SetAllowType-Methode , um die Typen von Adressen anzugeben, die das aktuelle Netzwerkadresssteuerelement unterstützen kann. Verwenden Sie die CNetAddressCtrl::GetAddress-Methode , um die vom Benutzer eingegebene Netzwerkadresse zu überprüfen und zu analysieren. Verwenden Sie die CNetAddressCtrl::D isplayErrorTip-Methode , um eine Infoinfo zur Fehlermeldung anzuzeigen, wenn die CNetAddressCtrl::GetAddress-Methode nicht erfolgreich ist.
Diese Meldung ruft das NetAddr_DisplayErrorTip Makro auf, das im Windows SDK beschrieben wird. Dieses Makro sendet die NCM_DISPLAYERRORTIP Nachricht.
CNetAddressCtrl::GetAddress
Ruft eine überprüfte und analysierte Darstellung der Netzwerkadresse ab, die dem aktuellen Netzwerkadresssteuerelement zugeordnet ist.
HRESULT GetAddress(PNC_ADDRESS pAddress) const;
Parameter
pAddress
[in, out] Zeiger auf eine NC_ADDRESS Struktur. Legen Sie das pAddrInfo-Element dieser Struktur auf die Adresse einer NET_ADDRESS_INFO Struktur fest, bevor Sie die GetAddress-Methode aufrufen.
Rückgabewert
Der Wert S_OK, wenn diese Methode erfolgreich ist; andernfalls ein COM-Fehlercode. Weitere Informationen zu den möglichen Fehlercodes finden Sie im Abschnitt "Rückgabewert" des NetAddr_GetAddress-Makros .
Hinweise
Wenn diese Methode erfolgreich ist, enthält die NET_ADDRESS_INFO-Struktur zusätzliche Informationen zur Netzwerkadresse.
Verwenden Sie die CNetAddressCtrl::SetAllowType-Methode , um die Typen von Adressen anzugeben, die das aktuelle Netzwerkadresssteuerelement unterstützen kann. Verwenden Sie die CNetAddressCtrl::GetAddress-Methode , um die vom Benutzer eingegebene Netzwerkadresse zu überprüfen und zu analysieren. Verwenden Sie die CNetAddressCtrl::D isplayErrorTip-Methode , um eine Infoinfo zur Fehlermeldung anzuzeigen, wenn die CNetAddressCtrl::GetAddress-Methode nicht erfolgreich ist.
Diese Methode ruft das NetAddr_GetAddress Makro auf, das im Windows SDK beschrieben wird. Dieses Makro sendet die NCM_GETADDRESS Nachricht.
CNetAddressCtrl::GetAllowType
Ruft den Typ der Netzwerkadresse ab, die vom aktuellen Netzwerkadresssteuerelement unterstützt werden kann.
DWORD GetAllowType() const;
Rückgabewert
Eine bitweise Kombination (OR) von Flags, die die Typen von Adressen angibt, die das Netzwerkadresssteuerelement unterstützen kann. Weitere Informationen finden Sie unter NET_STRING.
Hinweise
Diese Meldung ruft das NetAddr_GetAllowType-Makro auf, das im Windows SDK beschrieben wird. Dieses Makro sendet die NCM_GETALLOWTYPE Nachricht.
CNetAddressCtrl::SetAllowType
Legt den Typ der Netzwerkadresse fest, die vom aktuellen Netzwerkadresssteuerelement unterstützt werden kann.
HRESULT SetAllowType(DWORD dwAddrMask);
Parameter
dwAddrMask
[in] Eine bitweise Kombination (OR) von Flags, die die Typen von Adressen angibt, die das Netzwerkadresssteuerelement unterstützen kann. Weitere Informationen finden Sie unter NET_STRING.
Rückgabewert
S_OK, wenn diese Methode erfolgreich ist; andernfalls ein COM-Fehlercode.
Hinweise
Verwenden Sie die CNetAddressCtrl::SetAllowType-Methode , um die Typen von Adressen anzugeben, die das aktuelle Netzwerkadresssteuerelement unterstützen kann. Verwenden Sie die CNetAddressCtrl::GetAddress-Methode , um die vom Benutzer eingegebene Netzwerkadresse zu überprüfen und zu analysieren. Verwenden Sie die CNetAddressCtrl::D isplayErrorTip-Methode , um eine Infoinfo zur Fehlermeldung anzuzeigen, wenn die CNetAddressCtrl::GetAddress-Methode nicht erfolgreich ist.
Diese Meldung ruft das NetAddr_SetAllowType-Makro auf, das im Windows SDK beschrieben wird. Dieses Makro sendet die NCM_SETALLOWTYPE Nachricht.