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

CObject

CCmdTarget

CWnd

CEdit

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.

Siehe auch

CNetAddressCtrl-Klasse
Hierarchiediagramm
CEdit-Klasse