CNetAddressCtrl osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Az CNetAddressCtrl osztály a hálózati cím vezérlőelemet jelöli, amellyel beírhatja és ellenőrizheti az IPv4, az IPv6 és a névvel ellátott DNS-címek formátumát.

Szemantika

class CNetAddressCtrl : public CEdit

Tagok

Nyilvános konstruktorok

Név	Description
CNetAddressCtrl::CNetAddressCtrl	Egy `CNetAddressCtrl` objektumot hoz létre.

Nyilvános metódusok

Név	Description
CNetAddressCtrl::Létrehozás	Létrehoz egy hálózati címvezérlőt a megadott stílusokkal, és csatolja az aktuális `CNetAddressCtrl` objektumhoz.
CNetAddressCtrl::CreateEx	Létrehoz egy hálózati címvezérlőt a megadott kiterjesztett stílusokkal, és csatolja az aktuális `CNetAddressCtrl` objektumhoz.
CNetAddressCtrl::D isplayErrorTip	Hibabuborék-tippet jelenít meg, amikor a felhasználó nem támogatott hálózati címet ad meg az aktuális hálózati címvezérlőben.
CNetAddressCtrl::GetAddress	Az aktuális hálózati címvezérlőhöz társított hálózati cím érvényesített és elemezett ábrázolását kéri le.
CNetAddressCtrl::GetAllowType	Lekéri az aktuális hálózati címvezérlő által támogatott hálózati cím típusát.
CNetAddressCtrl::SetAllowType	Beállítja az aktuális hálózati címvezérlő által támogatott hálózati cím típusát.

Megjegyzések

A hálózati címvezérlő ellenőrzi, hogy a felhasználó által megadott cím formátuma helyes-e. A vezérlő valójában nem csatlakozik a hálózati címhez. A CNetAddressCtrl::SetAllowType metódus egy vagy több címtípust határoz meg, amelyet a CNetAddressCtrl::GetAddress metódus elemezni és ellenőrizni tud. Egy cím lehet IPv4, IPv6 vagy névvel ellátott cím a kiszolgáló, a hálózat, a gazdagép vagy a szórásos üzenet céljához. Ha a cím formátuma helytelen, a CNetAddressCtrl::D isplayErrorTip metódussal megjeleníthet egy infotip üzenetmezőt, amely grafikusan a hálózati címvezérlő szövegdobozára mutat, és előre definiált hibaüzenetet jelenít meg.

Az CNetAddressCtrl osztály a CEdit osztályból származik. Ennek következtében a hálózati címvezérlő hozzáférést biztosít az összes Windows-szerkesztési vezérlőüzenethez.

Az alábbi ábra egy hálózati címvezérlőt tartalmazó párbeszédpanelt ábrázol. A hálózati címvezérlő szövegmezője (1) érvénytelen hálózati címet tartalmaz. A (2) információs tipp üzenet jelenik meg, ha a hálózati cím érvénytelen.

Párbeszédpanel hálózati címvezérlővel és információs tippel.

Examples

Az alábbi példakód egy hálózati címet érvényesítő párbeszédpanel egy része. A három választógomb eseménykezelői megadják, hogy a hálózati cím három címtípus egyike lehet. A felhasználó megadja a címet a hálózati vezérlő szövegmezőjében, majd lenyom egy gombot a cím ellenőrzéséhez. Ha a cím érvényes, megjelenik egy sikeres üzenet; ellenkező esetben megjelenik az előre definiált infotip hibaüzenet.

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

A párbeszédpanel fejlécfájljának következő kód példája a CNetAddressCtrl::GetAddress metódus által megkövetelt NC_ADDRESS és NET_ADDRESS_INFO változókat határozza meg.

NC_ADDRESS m_na;
NET_ADDRESS_INFO m_nai;

Öröklési hierarchia

CNetAddressCtrl

Requirements

Fejléc: afxcmn.h

Ez az osztály Windows Vista és újabb verziókban is támogatott.

Az osztály további követelményeit a Windows Vista gyakori vezérlőinek buildelési követelményei ismertetik.

CNetAddressCtrl::CNetAddressCtrl

Egy CNetAddressCtrl objektumot hoz létre.

CNetAddressCtrl();

Megjegyzések

A CNetAddressCtrl::Create vagy CNetAddressCtrl::CreateEx metódussal hozzon létre egy hálózati vezérlőt, és csatolja az CNetAddressCtrl objektumhoz.

CNetAddressCtrl::Létrehozás

Létrehoz egy hálózati címvezérlőt a megadott stílusokkal, és csatolja az aktuális CNetAddressCtrl objektumhoz.

virtual BOOL Create(
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Paraméterek

dwStyle
[in] A vezérlőelemre alkalmazni kívánt stílusok bitenkénti kombinációja. További információ: Stílusok szerkesztése.

téglalap
[in] A vezérlő pozícióját és méretét tartalmazó RECT-struktúrára mutató hivatkozás.

pParentWnd
[in] Nem null mutató egy CWnd objektumra, amely a vezérlő szülőablaka.

Nid
[in] A vezérlő azonosítója.

Visszaadott érték

IGAZ, ha ez a módszer sikeres; egyéb esetben HAMIS.

CNetAddressCtrl::CreateEx

Létrehoz egy hálózati címvezérlőt a megadott kiterjesztett stílusokkal, és csatolja az aktuális CNetAddressCtrl objektumhoz.

virtual BOOL CreateEx(
    DWORD dwExStyle,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Paraméterek

dwExStyle
[in] A vezérlőelemre alkalmazni kívánt kiterjesztett stílusok bitenkénti kombinációja (OR). További információ: a CreateWindowEx függvény dwExStyle paramétere.

dwStyle
[in] A vezérlőelemre alkalmazni kívánt stílusok bitenkénti kombinációja (OR). További információ: Stílusok szerkesztése.

téglalap
[in] A vezérlő pozícióját és méretét tartalmazó RECT-struktúrára mutató hivatkozás.

pParentWnd
[in] Nem null mutató egy CWnd objektumra, amely a vezérlő szülőablaka.

Nid
[in] A vezérlő azonosítója.

Visszaadott érték

IGAZ, ha ez a módszer sikeres; egyéb esetben HAMIS.

CNetAddressCtrl::D isplayErrorTip

Az aktuális hálózati címvezérlőhöz társított buborékhegyen megjelenő hibaüzenetet jeleníti meg.

HRESULT DisplayErrorTip();

Visszaadott érték

Az érték S_OK , ha ez a módszer sikeres, ellenkező esetben hibakód.

Megjegyzések

A CNetAddressCtrl::SetAllowType metódussal adja meg az aktuális hálózati címvezérlő által támogatott címtípusokat. A CNetAddressCtrl::GetAddress metódus használatával ellenőrizheti és elemezheti a felhasználó által megadott hálózati címet. Ha a CNetAddressCtrl::GetAddress metódus sikertelen, a CNetAddressCtrl::D isplayErrorTip metódus használatával jeleníthet meg hibaüzenet-információs tippet.

Ez az üzenet meghívja a Windows SDK-ban leírt NetAddr_DisplayErrorTip makrót. A makró elküldi az NCM_DISPLAYERRORTIP üzenetet.

CNetAddressCtrl::GetAddress

Az aktuális hálózati címvezérlőhöz társított hálózati cím érvényesített és elemezett ábrázolását kéri le.

HRESULT GetAddress(PNC_ADDRESS pAddress) const;

Paraméterek

pAddress
[be, ki] Mutató egy NC_ADDRESS szerkezetre. A GetAddress metódus meghívása előtt állítsa a struktúra pAddrInfo tagját egy NET_ADDRESS_INFO struktúra címére.

Visszaadott érték

Az érték S_OK, ha ez a módszer sikeres; egyéb esetben COM-hibakód. A lehetséges hibakódokkal kapcsolatos további információkért lásd a NetAddr_GetAddress makró Visszatérési érték szakaszát.

Megjegyzések

Ha ez a módszer sikeres, a NET_ADDRESS_INFO-struktúra további információkat tartalmaz a hálózati címről.

Használja a CNetAddressCtrl::SetAllowType metódust az aktuális hálózati címvezérlő által támogatott címtípusok megadásához. A CNetAddressCtrl::GetAddress metódus használatával ellenőrizheti és elemezheti a felhasználó által megadott hálózati címet. Ha a CNetAddressCtrl::GetAddress metódus sikertelen, a CNetAddressCtrl::D isplayErrorTip metódus használatával jeleníthet meg hibaüzenet-információs tippet.

Ez a metódus meghívja a Windows SDK-ban leírt NetAddr_GetAddress makrót. Ez a makró elküldi a NCM_GETADDRESS üzenetet.

CNetAddressCtrl::GetAllowType

Lekéri az aktuális hálózati címvezérlő által támogatott hálózati cím típusát.

DWORD GetAllowType() const;

Visszaadott érték

A hálózati címvezérlő által támogatott címek típusát meghatározó jelzők bitenkénti kombinációja (OR). További információ: NET_STRING.

Megjegyzések

Ez az üzenet meghívja a Windows SDK-ban leírt NetAddr_GetAllowType makrót. Ez a makró elküldi a NCM_GETALLOWTYPE üzenetet.

CNetAddressCtrl::SetAllowType

Beállítja az aktuális hálózati címvezérlő által támogatott hálózati cím típusát.

HRESULT SetAllowType(DWORD dwAddrMask);

Paraméterek

dwAddrMask
[in] A hálózati címvezérlő által támogatott címek típusát meghatározó jelzők bitenkénti kombinációja (OR). További információ: NET_STRING.

Visszaadott érték

S_OK, hogy ez a módszer sikeres-e; egyéb esetben COM-hibakód.

Megjegyzések

Ez az üzenet meghívja a Windows SDK-ban leírt NetAddr_SetAllowType makrót. Ez a makró elküldi a NCM_SETALLOWTYPE üzenetet.

Lásd még

CNetAddressCtrl osztály
hierarchiadiagram
CEdit osztály

Visszajelzés

Hasznosnak találta ezt az oldalt?

Last updated on 2026-02-23

Megosztás a következőn keresztül:

CNetAddressCtrl osztály

Szemantika

Tagok

Nyilvános konstruktorok

Nyilvános metódusok

Megjegyzések

Examples

Öröklési hierarchia

Requirements

CNetAddressCtrl::CNetAddressCtrl

Megjegyzések

CNetAddressCtrl::Létrehozás

Paraméterek

Visszaadott érték

CNetAddressCtrl::CreateEx

Paraméterek

Visszaadott érték

CNetAddressCtrl::D isplayErrorTip

Visszaadott érték

Megjegyzések

CNetAddressCtrl::GetAddress

Paraméterek

Visszaadott érték

Megjegyzések

CNetAddressCtrl::GetAllowType

Visszaadott érték

Megjegyzések

CNetAddressCtrl::SetAllowType

Paraméterek

Visszaadott érték

Megjegyzések

Lásd még

Visszajelzés

További források