CNetAddressCtrl – třída
Třída CNetAddressCtrl představuje řízení síťových adres, které můžete použít k zadání a ověření formátu IPv4, IPv6 a pojmenovaných adres DNS.
Syntaxe
class CNetAddressCtrl : public CEdit
Členové
Veřejné konstruktory
| Název | Popis |
|---|---|
| CNetAddressCtrl::CNetAddressCtrl | CNetAddressCtrl Vytvoří objekt. |
Veřejné metody
| Název | Popis |
|---|---|
| CNetAddressCtrl::Create | Vytvoří ovládací prvek síťové adresy se zadanými styly a připojí ho k aktuálnímu CNetAddressCtrl objektu. |
| CNetAddressCtrl::CreateEx | Vytvoří ovládací prvek síťové adresy se zadanými rozšířenými styly a připojí ho k aktuálnímu CNetAddressCtrl objektu. |
| CNetAddressCtrl::D isplayErrorTip | Zobrazí bublinový tip chyby, když uživatel zadá nepodporovanou síťovou adresu v aktuálním ovládacím prvku síťové adresy. |
| CNetAddressCtrl::GetAddress | Načte ověřenou a parsovanou reprezentaci síťové adresy přidružené k aktuálnímu řízení síťových adres. |
| CNetAddressCtrl::GetAllowType | Načte typ síťové adresy, kterou může aktuální řízení síťových adres podporovat. |
| CNetAddressCtrl::SetAllowType | Nastaví typ síťové adresy, kterou může aktuální ovládací prvek síťové adresy podporovat. |
Poznámky
Ovládací prvek síťové adresy ověří správnost formátu adresy, kterou uživatel zadá. Ovládací prvek se ve skutečnosti nepřipojuje k síťové adrese. Metoda CNetAddressCtrl::SetAllowType určuje jeden nebo více typů adres, které může metoda CNetAddressCtrl::GetAddress parsovat a ověřit. Adresa může být ve formě IPv4, IPv6 nebo pojmenované adresy pro server, síť, hostitele nebo cíl zprávy všesměrového vysílání. Pokud je formát adresy nesprávný, můžete použít metodu CNetAddressCtrl::D isplayErrorTip k zobrazení pole zprávy s popisem informací, které graficky odkazuje na textové pole ovládacího prvku síťová adresa a zobrazí předdefinovanou chybovou zprávu.
Třída CNetAddressCtrl je odvozena z CEdit třídy. V důsledku toho řízení síťové adresy poskytuje přístup ke všem zprávám ovládacích prvků systému Windows.
Následující obrázek znázorňuje dialogové okno, které obsahuje ovládací prvek síťové adresy. Textové pole (1) pro ovládací prvek síťové adresy obsahuje neplatnou síťovou adresu. Pokud je síťová adresa neplatná, zobrazí se informační zpráva (2).
Příklady
Následující příklad kódu je část dialogového okna, která ověřuje síťovou adresu. Obslužné rutiny událostí pro tři přepínače určují, že síťová adresa může být jedním ze tří typů adres. Uživatel zadá adresu do textového pole síťového ovládacího prvku a stisknutím tlačítka adresu ověří. Pokud je adresa platná, zobrazí se zpráva o úspěchu; v opačném případě se zobrazí předdefinovaná chybová zpráva s popisem informací.
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"));
}
Následující příklad kódu ze souboru záhlaví dialogového okna definuje NC_ADDRESS a NET_ADDRESS_INFO proměnné, které jsou vyžadovány CNetAddressCtrl::GetAddress metoda.
NC_ADDRESS m_na;
NET_ADDRESS_INFO m_nai;
Hierarchie dědičnosti
CNetAddressCtrl
Požadavky
Hlavička: afxcmn.h
Tato třída je podporována v systému Windows Vista a novějších verzích.
Další požadavky pro tuto třídu jsou popsány v části Požadavky na sestavení pro běžné ovládací prvky systému Windows Vista.
CNetAddressCtrl::CNetAddressCtrl
CNetAddressCtrl Vytvoří objekt.
CNetAddressCtrl();
Poznámky
Pomocí metody CNetAddressCtrl::Create nebo CNetAddressCtrl::CreateEx vytvořte síťový ovládací prvek a připojte ho k objektuCNetAddressCtrl.
CNetAddressCtrl::Create
Vytvoří ovládací prvek síťové adresy se zadanými styly a připojí ho k aktuálnímu CNetAddressCtrl objektu.
virtual BOOL Create(
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID);
Parametry
dwStyle
[v] Bitové kombinace stylů, které se mají použít u ovládacího prvku. Další informace najdete v tématu Úpravy stylů.
Rect
[v] Odkaz na strukturu RECT , která obsahuje pozici a velikost ovládacího prvku.
pParentWnd
[v] Nenulový ukazatel na objekt CWnd , který je nadřazeným oknem ovládacího prvku.
Nid
[v] ID ovládacího prvku.
Návratová hodnota
TRUE, pokud tato metoda je úspěšná; jinak NEPRAVDA.
CNetAddressCtrl::CreateEx
Vytvoří ovládací prvek síťové adresy se zadanými rozšířenými styly a připojí ho k aktuálnímu CNetAddressCtrl objektu.
virtual BOOL CreateEx(
DWORD dwExStyle,
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID);
Parametry
dwExStyle
[v] Bitové kombinace (OR) rozšířených stylů, které se mají použít u ovládacího prvku. Další informace naleznete v dwExStyle parametr CreateWindowExEx funkce.
dwStyle
[v] Bitové kombinace (OR) stylů, které se mají použít u ovládacího prvku. Další informace najdete v tématu Úpravy stylů.
Rect
[v] Odkaz na strukturu RECT , která obsahuje pozici a velikost ovládacího prvku.
pParentWnd
[v] Nenulový ukazatel na objekt CWnd , který je nadřazeným oknem ovládacího prvku.
Nid
[v] ID ovládacího prvku.
Návratová hodnota
TRUE, pokud tato metoda je úspěšná; jinak NEPRAVDA.
CNetAddressCtrl::D isplayErrorTip
Zobrazí chybovou zprávu v tipu bubliny, která je přidružená k aktuálnímu ovládacímu prvku síťové adresy.
HRESULT DisplayErrorTip();
Návratová hodnota
Hodnota S_OK , pokud je tato metoda úspěšná, jinak kód chyby.
Poznámky
Pomocí metody CNetAddressCtrl::SetAllowType určete typy adres, které může aktuální řízení síťových adres podporovat. Pomocí metody CNetAddressCtrl::GetAddress ověřte a parsujte síťovou adresu, kterou uživatel zadá. Pomocí metody CNetAddressCtrl::D isplayErrorTip zobrazte popis chybové zprávy, pokud CNetAddressCtrl::GetAddress metoda není úspěšná.
Tato zpráva vyvolá NetAddr_DisplayErrorTip makro, které je popsáno v sadě Windows SDK. Toto makro odešle NCM_DISPLAYERRORTIP zprávu.
CNetAddressCtrl::GetAddress
Načte ověřenou a parsovanou reprezentaci síťové adresy, která je přidružená k aktuálnímu řízení síťových adres.
HRESULT GetAddress(PNC_ADDRESS pAddress) const;
Parametry
pAddress
[in, out] Ukazatel na strukturu NC_ADDRESS Před voláním metody GetAddress nastavte člen pAddrInfo této struktury na adresu NET_ADDRESS_INFO struktury.
Návratová hodnota
Hodnota S_OK, pokud je tato metoda úspěšná; jinak kód chyby modelu COM. Další informace o možných kódech chyb najdete v části Návratová hodnota makra NetAddr_GetAddress .
Poznámky
Pokud je tato metoda úspěšná, NET_ADDRESS_INFO struktura obsahuje další informace o síťové adrese.
Pomocí metody CNetAddressCtrl::SetAllowType určete typy adres, které může aktuální řízení síťových adres podporovat. Pomocí metody CNetAddressCtrl::GetAddress ověřte a parsujte síťovou adresu, kterou uživatel zadá. Pomocí metody CNetAddressCtrl::D isplayErrorTip zobrazte popis chybové zprávy, pokud CNetAddressCtrl::GetAddress metoda není úspěšná.
Tato metoda vyvolá NetAddr_GetAddress makro, které je popsáno v sadě Windows SDK. Toto makro odešle NCM_GETADDRESS zprávu.
CNetAddressCtrl::GetAllowType
Načte typ síťové adresy, kterou může aktuální řízení síťových adres podporovat.
DWORD GetAllowType() const;
Návratová hodnota
Bitová kombinace (OR) příznaků, které určují typy adres, které může řízení síťových adres podporovat. Další informace najdete v tématu NET_STRING.
Poznámky
Tato zpráva vyvolá makro NetAddr_GetAllowType , které je popsáno v sadě Windows SDK. Toto makro odešle NCM_GETALLOWTYPE zprávu.
CNetAddressCtrl::SetAllowType
Nastaví typ síťové adresy, kterou může aktuální ovládací prvek síťové adresy podporovat.
HRESULT SetAllowType(DWORD dwAddrMask);
Parametry
dwAddrMask
[v] Bitová kombinace (OR) příznaků, které určují typy adres, které může řízení síťových adres podporovat. Další informace najdete v tématu NET_STRING.
Návratová hodnota
S_OK, pokud je tato metoda úspěšná; jinak kód chyby modelu COM.
Poznámky
Pomocí metody CNetAddressCtrl::SetAllowType určete typy adres, které může aktuální řízení síťových adres podporovat. Pomocí metody CNetAddressCtrl::GetAddress ověřte a parsujte síťovou adresu, kterou uživatel zadá. Pomocí metody CNetAddressCtrl::D isplayErrorTip zobrazte popis chybové zprávy, pokud CNetAddressCtrl::GetAddress metoda není úspěšná.
Tato zpráva vyvolá NetAddr_SetAllowType makro, které je popsáno v sadě Windows SDK. Toto makro odešle NCM_SETALLOWTYPE zprávu.