Classe CIPAddressCtrl

Fornisce la funzionalità del controllo indirizzo IP comune di Windows.

Sintassi

class CIPAddressCtrl : public CWnd

Membri

Costruttori pubblici

Metodi pubblici

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à

CObject

CCmdTarget

CWnd

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.

1. Chiamare il costruttore , che crea l'oggetto CIPAddressCtrl .

2. 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.

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.

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.

Vedi anche

Classe CWnd
Grafico della gerarchia