Classe CIPAddressCtrl
Fornisce la funzionalità del controllo indirizzo IP comune di Windows.
Sintassi
class CIPAddressCtrl : public CWnd
Membri
Costruttori pubblici
| Nome | Descrizione |
|---|---|
| CIPAddressCtrl::CIPAddressCtrl | Costruisce un oggetto CIPAddressCtrl. |
Metodi pubblici
| Nome | Descrizione |
|---|---|
| CIPAddressCtrl::ClearAddress | Cancella il contenuto del controllo indirizzo IP. |
| CIPAddressCtrl::Create | Crea un controllo indirizzi IP e lo collega a un CIPAddressCtrl oggetto . |
| CIPAddressCtrl::CreateEx | Crea un controllo Indirizzo IP con gli stili estesi di Windows specificati e lo collega a un CIPAddressCtrl oggetto . |
| CIPAddressCtrl::GetAddress | Recupera i valori degli indirizzi per tutti e quattro i campi nel controllo degli indirizzi IP. |
| CIPAddressCtrl::IsBlank | Determina se tutti i campi nel controllo degli indirizzi IP sono vuoti. |
| CIPAddressCtrl::SetAddress | Imposta i valori degli indirizzi per tutti e quattro i campi nel controllo degli indirizzi IP. |
| CIPAddressCtrl::SetFieldFocus | Imposta lo stato attivo della tastiera sul campo specificato nel controllo indirizzo IP. |
| CIPAddressCtrl::SetFieldRange | Imposta l'intervallo nel campo specificato nel controllo indirizzo IP. |
Osservazioni:
Un controllo Indirizzo IP, un controllo simile a un controllo di modifica, consente di immettere e modificare un indirizzo numerico in formato IP (Internet Protocol).
Questo controllo (e quindi la CIPAddressCtrl classe ) è disponibile solo per i programmi in esecuzione in Microsoft Internet Explorer 4.0 e versioni successive. Saranno disponibili anche nelle versioni future di Windows e Windows NT.
Per informazioni più generali sul controllo degli indirizzi IP, vedere Controlli degli indirizzi IP in Windows SDK.
Gerarchia di ereditarietà
CIPAddressCtrl
Requisiti
Intestazione: afxcmn.h
CIPAddressCtrl::CIPAddressCtrl
Crea un oggetto CIPAddressCtrl.
CIPAddressCtrl();
CIPAddressCtrl::ClearAddress
Cancella il contenuto del controllo indirizzo IP.
void ClearAddress();
Osservazioni:
Questa funzione membro implementa il comportamento del messaggio Win32 IPM_CLEARADDRESS, come descritto in Windows SDK.
CIPAddressCtrl::Create
Crea un controllo indirizzi IP e lo collega a un CIPAddressCtrl oggetto .
virtual BOOL Create(
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID);
Parametri
dwStyle
Stile del controllo Indirizzo IP. Applicare una combinazione di stili di finestra. È necessario includere lo stile WS_CHILD perché il controllo deve essere una finestra figlio. Per un elenco degli stili di Windows, vedere CreateWindow in Windows SDK.
rect
Riferimento alla dimensione e alla posizione del controllo indirizzi IP. Può essere un oggetto CRect o una struttura RECT .
pParentWnd
Puntatore alla finestra padre del controllo indirizzi IP. Non deve essere NULL.
nID
ID del controllo dell'indirizzo IP.
Valore restituito
Diverso da zero se l'inizializzazione ha avuto esito positivo; in caso contrario, 0.
Osservazioni:
Si costruisce un CIPAddressCtrl oggetto in due passaggi.
Chiamare il costruttore , che crea l'oggetto
CIPAddressCtrl.Chiamare
Create, che crea il controllo dell'indirizzo IP.
Se si desidera usare gli stili di windows estesi con il controllo, chiamare CreateEx anziché Create.
CIPAddressCtrl::CreateEx
Chiamare questa funzione per creare un controllo (una finestra figlio) e associarlo all'oggetto CIPAddressCtrl .
virtual BOOL CreateEx(
DWORD dwExStyle,
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID);
Parametri
dwExStyle
Specifica lo stile esteso del controllo da creare. Per un elenco degli stili di Windows estesi, vedere il parametro dwExStyle per CreateWindowEx in Windows SDK.
dwStyle
Stile del controllo Indirizzo IP. Applicare una combinazione di stili di finestra. È necessario includere lo stile WS_CHILD perché il controllo deve essere una finestra figlio. Per un elenco degli stili di Windows, vedere CreateWindow in Windows SDK.
rect
Riferimento a una struttura RECT che descrive le dimensioni e la posizione della finestra da creare, nelle coordinate client di pParentWnd.
pParentWnd
Puntatore alla finestra padre del controllo.
nID
ID finestra figlio del controllo.
Valore restituito
Diverso da zero se ha esito positivo; in caso contrario 0.
Osservazioni:
Usare CreateEx invece di Crea per applicare stili di Windows estesi, specificati dalla prefazione dello stile esteso di Windows WS_EX_.
CIPAddressCtrl::GetAddress
Recupera i valori degli indirizzi per tutti e quattro i campi nel controllo degli indirizzi IP.
int GetAddress(
BYTE& nField0,
BYTE& nField1,
BYTE& nField2,
BYTE& nField3);
int GetAddress(DWORD& dwAddress);
Parametri
nField0
Riferimento al valore del campo 0 da un indirizzo IP compresso.
nField1
Riferimento al valore del campo 1 da un indirizzo IP compresso.
nField2
Riferimento al valore del campo 2 da un indirizzo IP compresso.
nField3
Riferimento al valore del campo 3 da un indirizzo IP compresso.
dwAddress
Riferimento all'indirizzo di un valore DWORD che riceve l'indirizzo IP. Vedere La sezione Osservazioni per una tabella che mostra come viene riempito dwAddress .
Valore restituito
Numero di campi non vuoti nel controllo degli indirizzi IP.
Osservazioni:
Questa funzione membro implementa il comportamento del messaggio Win32 IPM_GETADDRESS, come descritto in Windows SDK. Nel primo prototipo precedente, i numeri nei campi da 0 a 3 del controllo, letti rispettivamente da sinistra a destra, popolano i quattro parametri. Nel secondo prototipo precedente, dwAddress viene popolato come segue.
| Campo | Bit contenenti il valore del campo |
|---|---|
| 0 | Da 24 a 31 |
| 1 | Da 16 a 23 |
| 2 | Da 8 a 15 |
| 3 | da 0 a 7 |
CIPAddressCtrl::IsBlank
Determina se tutti i campi nel controllo degli indirizzi IP sono vuoti.
BOOL IsBlank() const;
Valore restituito
Diverso da zero se tutti i campi Controllo indirizzi IP sono vuoti; in caso contrario, 0.
Osservazioni:
Questa funzione membro implementa il comportamento del messaggio Win32 IPM_ISBLANK, come descritto in Windows SDK.
CIPAddressCtrl::SetAddress
Imposta i valori degli indirizzi per tutti e quattro i campi nel controllo degli indirizzi IP.
void SetAddress(
BYTE nField0,
BYTE nField1,
BYTE nField2,
BYTE nField3);
void SetAddress(DWORD dwAddress);
Parametri
nField0
Valore del campo 0 da un indirizzo IP compresso.
nField1
Valore del campo 1 da un indirizzo IP compresso.
nField2
Valore del campo 2 da un indirizzo IP compresso.
nField3
Valore del campo 3 da un indirizzo IP compresso.
dwAddress
Valore DWORD che contiene il nuovo indirizzo IP. Vedere La sezione Osservazioni per una tabella che mostra come viene compilato il valore DWORD.
Osservazioni:
Questa funzione membro implementa il comportamento del messaggio Win32 IPM_SETADDRESS, come descritto in Windows SDK. Nel primo prototipo precedente, i numeri nei campi da 0 a 3 del controllo, letti rispettivamente da sinistra a destra, popolano i quattro parametri. Nel secondo prototipo precedente, dwAddress viene popolato come segue.
| Campo | Bit contenenti il valore del campo |
|---|---|
| 0 | Da 24 a 31 |
| 1 | Da 16 a 23 |
| 2 | Da 8 a 15 |
| 3 | da 0 a 7 |
CIPAddressCtrl::SetFieldFocus
Imposta lo stato attivo della tastiera sul campo specificato nel controllo indirizzo IP.
void SetFieldFocus(WORD nField);
Parametri
nField
Indice di campo in base zero su cui deve essere impostato lo stato attivo. Se questo valore è maggiore del numero di campi, lo stato attivo viene impostato sul primo campo vuoto. Se tutti i campi non sono vuoti, lo stato attivo viene impostato sul primo campo.
Osservazioni:
Questa funzione membro implementa il comportamento del messaggio Win32 IPM_SETFOCUS, come descritto in Windows SDK.
CIPAddressCtrl::SetFieldRange
Imposta l'intervallo nel campo specificato nel controllo indirizzo IP.
void SetFieldRange(
int nField,
BYTE nLower,
BYTE nUpper);
Parametri
nField
Indice di campo in base zero a cui verrà applicato l'intervallo.
nLower
Riferimento a un numero intero che riceve il limite inferiore del campo specificato in questo controllo indirizzo IP.
nUpper
Riferimento a un numero intero che riceve il limite superiore del campo specificato in questo controllo indirizzo IP.
Osservazioni:
Questa funzione membro implementa il comportamento del messaggio Win32 IPM_SETRANGE, come descritto in Windows SDK. Usare i due parametri, nLower e nUpper, per indicare i limiti inferiori e superiori del campo, anziché il parametro wRange usato con il messaggio Win32.