Classe CNetAddressCtrl
La classe CNetAddressCtrl rappresenta il controllo indirizzo di rete, che è possibile utilizzare per immettere e convalidare il formato di indirizzi IPv4, IPv6 e DNS denominati.
Sintassi
class CNetAddressCtrl : public CEdit
Membri
Costruttori pubblici
| Nome | Descrizione |
|---|---|
| CNetAddressCtrl::CNetAddressCtrl | Costruisce un oggetto CNetAddressCtrl. |
Metodi pubblici
| Nome | Descrizione |
|---|---|
| CNetAddressCtrl::Create | Crea un controllo degli indirizzi di rete con gli stili specificati e lo collega all'oggetto corrente CNetAddressCtrl . |
| CNetAddressCtrl::CreateEx | Crea un controllo degli indirizzi di rete con gli stili estesi specificati e lo collega all'oggetto corrente CNetAddressCtrl . |
| CNetAddressCtrl::D isplayErrorTip | Visualizza un suggerimento per il fumetto degli errori quando l'utente immette un indirizzo di rete non supportato nel controllo dell'indirizzo di rete corrente. |
| CNetAddressCtrl::GetAddress | Recupera una rappresentazione convalidata e analizzata dell'indirizzo di rete associato al controllo dell'indirizzo di rete corrente. |
| CNetAddressCtrl::GetAllowType | Recupera il tipo di indirizzo di rete che il controllo dell'indirizzo di rete corrente può supportare. |
| CNetAddressCtrl::SetAllowType | Imposta il tipo di indirizzo di rete supportato dal controllo dell'indirizzo di rete corrente. |
Osservazioni:
Il controllo degli indirizzi di rete verifica che il formato dell'indirizzo immesso dall'utente sia corretto. Il controllo non si connette effettivamente all'indirizzo di rete. Il metodo CNetAddressCtrl::SetAllowType specifica uno o più tipi di indirizzo che il metodo CNetAddressCtrl::GetAddress può analizzare e verificare. Un indirizzo può essere sotto forma di indirizzo IPv4, IPv6 o denominato per un server, una rete, un host o una destinazione di messaggi broadcast. Se il formato dell'indirizzo non è corretto, è possibile utilizzare il metodo CNetAddressCtrl::D isplayErrorTip per visualizzare una finestra di messaggio di descrizione informazioni che punta graficamente alla casella di testo del controllo indirizzo di rete e visualizza un messaggio di errore predefinito.
La CNetAddressCtrl classe è derivata dalla classe CEdit . Di conseguenza, il controllo degli indirizzi di rete fornisce l'accesso a tutti i messaggi di controllo di modifica di Windows.
Nella figura seguente viene illustrata una finestra di dialogo contenente un controllo degli indirizzi di rete. La casella di testo (1) per il controllo degli indirizzi di rete contiene un indirizzo di rete non valido. Il messaggio di descrizione informazioni (2) viene visualizzato se l'indirizzo di rete non è valido.
Esempi
L'esempio di codice seguente è una parte di una finestra di dialogo che convalida un indirizzo di rete. I gestori eventi per tre pulsanti di opzione specificano che l'indirizzo di rete può essere uno dei tre tipi di indirizzo. L'utente immette un indirizzo nella casella di testo del controllo di rete, quindi preme un pulsante per convalidare l'indirizzo. Se l'indirizzo è valido, viene visualizzato un messaggio di operazione riuscita; in caso contrario, viene visualizzato il messaggio di errore predefinito della descrizione informazioni.
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"));
}
Nell'esempio di codice seguente del file di intestazione della finestra di dialogo vengono definite le variabili NC_ADDRESS e NET_ADDRESS_INFO richieste dal metodo CNetAddressCtrl::GetAddress .
NC_ADDRESS m_na;
NET_ADDRESS_INFO m_nai;
Gerarchia di ereditarietà
CNetAddressCtrl
Requisiti
Intestazione: afxcmn.h
Questa classe è supportata in Windows Vista e versioni successive.
I requisiti aggiuntivi per questa classe sono descritti in Requisiti di compilazione per i controlli comuni di Windows Vista.
CNetAddressCtrl::CNetAddressCtrl
Costruisce un oggetto CNetAddressCtrl.
CNetAddressCtrl();
Osservazioni:
Usare il metodo CNetAddressCtrl::Create o CNetAddressCtrl::CreateEx per creare un controllo di rete e collegarlo all'oggetto CNetAddressCtrl .
CNetAddressCtrl::Create
Crea un controllo degli indirizzi di rete con gli stili specificati e lo collega all'oggetto corrente CNetAddressCtrl .
virtual BOOL Create(
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID);
Parametri
dwStyle
[in] Combinazione bit per bit di stili da applicare al controllo. Per altre informazioni, vedere Modificare gli stili.
rect
[in] Riferimento a una struttura RECT che contiene la posizione e le dimensioni del controllo.
pParentWnd
[in] Puntatore non Null a un oggetto CWnd che rappresenta la finestra padre del controllo.
nID
[in] ID del controllo.
Valore restituito
TRUE se questo metodo ha esito positivo; in caso contrario, FALSE.
CNetAddressCtrl::CreateEx
Crea un controllo degli indirizzi di rete con gli stili estesi specificati e lo collega all'oggetto corrente CNetAddressCtrl .
virtual BOOL CreateEx(
DWORD dwExStyle,
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID);
Parametri
dwExStyle
[in] Combinazione bit per bit (OR) di stili estesi da applicare al controllo. Per altre informazioni, vedere il parametro dwExStyle della funzione CreateWindowEx .
dwStyle
[in] Combinazione bit per bit (OR) di stili da applicare al controllo. Per altre informazioni, vedere Modificare gli stili.
rect
[in] Riferimento a una struttura RECT che contiene la posizione e le dimensioni del controllo.
pParentWnd
[in] Puntatore non Null a un oggetto CWnd che rappresenta la finestra padre del controllo.
nID
[in] ID del controllo.
Valore restituito
TRUE se questo metodo ha esito positivo; in caso contrario, FALSE.
CNetAddressCtrl::D isplayErrorTip
Visualizza un messaggio di errore nel suggerimento fumetto associato al controllo dell'indirizzo di rete corrente.
HRESULT DisplayErrorTip();
Valore restituito
Valore S_OK se questo metodo ha esito positivo; in caso contrario, un codice di errore.
Osservazioni:
Usare il metodo CNetAddressCtrl::SetAllowType per specificare i tipi di indirizzi che il controllo degli indirizzi di rete corrente può supportare. Usare il metodo CNetAddressCtrl::GetAddress per convalidare e analizzare l'indirizzo di rete immesso dall'utente. Utilizzare il metodo CNetAddressCtrl::D isplayErrorTip per visualizzare una descrizione infotip del messaggio di errore se il metodo CNetAddressCtrl::GetAddress non riesce.
Questo messaggio richiama la macro NetAddr_DisplayErrorTip , descritta in Windows SDK. La macro invia il NCM_DISPLAYERRORTIP messaggio.
CNetAddressCtrl::GetAddress
Recupera una rappresentazione convalidata e analizzata dell'indirizzo di rete associato al controllo dell'indirizzo di rete corrente.
HRESULT GetAddress(PNC_ADDRESS pAddress) const;
Parametri
pAddress
[in, out] Puntatore a una struttura NC_ADDRESS . Impostare il membro pAddrInfo di questa struttura sull'indirizzo di una struttura NET_ADDRESS_INFO prima di chiamare il metodo GetAddress.
Valore restituito
Il valore S_OK se questo metodo ha esito positivo; in caso contrario, un codice di errore COM. Per altre informazioni sui possibili codici di errore, vedere la sezione Valore restituito della macro NetAddr_GetAddress .
Osservazioni:
Se questo metodo ha esito positivo, la struttura NET_ADDRESS_INFO contiene informazioni aggiuntive sull'indirizzo di rete.
Usare il metodo CNetAddressCtrl::SetAllowType per specificare i tipi di indirizzi supportati dal controllo dell'indirizzo di rete corrente. Usare il metodo CNetAddressCtrl::GetAddress per convalidare e analizzare l'indirizzo di rete immesso dall'utente. Utilizzare il metodo CNetAddressCtrl::D isplayErrorTip per visualizzare una descrizione infotip del messaggio di errore se il metodo CNetAddressCtrl::GetAddress non riesce.
Questo metodo richiama la macro NetAddr_GetAddress , descritta in Windows SDK. La macro invia il messaggio di NCM_GETADDRESS.
CNetAddressCtrl::GetAllowType
Recupera il tipo di indirizzo di rete che il controllo dell'indirizzo di rete corrente può supportare.
DWORD GetAllowType() const;
Valore restituito
Combinazione bit per bit (OR) di flag che specifica i tipi di indirizzi che il controllo degli indirizzi di rete può supportare. Per altre informazioni, vedere NET_STRING.
Osservazioni:
Questo messaggio richiama la macro NetAddr_GetAllowType , descritta in Windows SDK. La macro invia il messaggio di NCM_GETALLOWTYPE.
CNetAddressCtrl::SetAllowType
Imposta il tipo di indirizzo di rete supportato dal controllo dell'indirizzo di rete corrente.
HRESULT SetAllowType(DWORD dwAddrMask);
Parametri
dwAddrMask
[in] Combinazione bit per bit (OR) di flag che specifica i tipi di indirizzi che il controllo degli indirizzi di rete può supportare. Per altre informazioni, vedere NET_STRING.
Valore restituito
S_OK se questo metodo ha esito positivo; in caso contrario, un codice di errore COM.
Osservazioni:
Usare il metodo CNetAddressCtrl::SetAllowType per specificare i tipi di indirizzi che il controllo degli indirizzi di rete corrente può supportare. Usare il metodo CNetAddressCtrl::GetAddress per convalidare e analizzare l'indirizzo di rete immesso dall'utente. Utilizzare il metodo CNetAddressCtrl::D isplayErrorTip per visualizzare una descrizione infotip del messaggio di errore se il metodo CNetAddressCtrl::GetAddress non riesce.
Questo messaggio richiama la macro NetAddr_SetAllowType , descritta in Windows SDK. La macro invia il messaggio di NCM_SETALLOWTYPE.