CIPAddressCtrl, classe

Fournit les fonctionnalités du contrôle commun d'adresse IP Windows.

Syntaxe

class CIPAddressCtrl : public CWnd

Membres

Constructeurs publics

Méthodes publiques

Notes

Un contrôle d’adresse IP, un contrôle similaire à un contrôle d’édition, vous permet d’entrer et de manipuler une adresse numérique au format IP (Internet Protocol).

Ce contrôle (et par conséquent la CIPAddressCtrl classe) est disponible uniquement pour les programmes exécutés sous Microsoft Internet Explorer 4.0 et versions ultérieures. Ils seront également disponibles sous les futures versions de Windows et Windows NT.

Pour plus d’informations générales sur le contrôle d’adresse IP, consultez Contrôles d’adresse IP dans le Kit de développement logiciel (SDK) Windows.

Hiérarchie d'héritage

CObject

CCmdTarget

CWnd

CIPAddressCtrl

Spécifications

En-tête : afxcmn.h

CIPAddressCtrl ::CIPAddressCtrl

Crée un objet CIPAddressCtrl.

CIPAddressCtrl();

CIPAddressCtrl ::ClearAddress

Efface le contenu du contrôle d’adresse IP.

void ClearAddress();

Notes

Cette fonction membre implémente le comportement du message Win32 IPM_CLEARADDRESS, comme décrit dans le Kit de développement logiciel (SDK) Windows.

CIPAddressCtrl ::Create

Crée un contrôle d’adresse IP et l’attache à un CIPAddressCtrl objet.

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

Paramètres

dwStyle
Style du contrôle d’adresse IP. Appliquez une combinaison de styles de fenêtre. Vous devez inclure le style WS_CHILD, car le contrôle doit être une fenêtre enfant. Consultez CreateWindow dans le Kit de développement logiciel (SDK) Windows pour obtenir la liste des styles Windows.

rect
Référence à la taille et à la position du contrôle d’adresse IP. Il peut s’agir d’un objet CRect ou d’une structure RECT .

pParentWnd
Pointeur vers la fenêtre parente du contrôle d’adresse IP. Elle ne doit pas être NULL.

nID
ID du contrôle d’adresse IP.

Valeur de retour

Différent de zéro si l’initialisation a réussi ; sinon 0.

Notes

Vous construisez un CIPAddressCtrl objet en deux étapes.

1. Appelez le constructeur, qui crée l’objet CIPAddressCtrl .

2. Appel Create, qui crée le contrôle d’adresse IP.

Si vous souhaitez utiliser des styles windows étendus avec votre contrôle, appelez CreateEx au lieu de Create.

CIPAddressCtrl ::CreateEx

Appelez cette fonction pour créer un contrôle (fenêtre enfant) et l’associer à l’objet CIPAddressCtrl .

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

Paramètres

dwExStyle
Spécifie le style étendu du contrôle en cours de création. Pour obtenir la liste des styles Windows étendus, consultez le paramètre dwExStyle pour CreateWindowEx dans le Kit de développement logiciel (SDK) Windows.

dwStyle
Style du contrôle d’adresse IP. Appliquez une combinaison de styles de fenêtre. Vous devez inclure le style WS_CHILD, car le contrôle doit être une fenêtre enfant. Consultez CreateWindow dans le Kit de développement logiciel (SDK) Windows pour obtenir la liste des styles Windows.

rect
Référence à une structure RECT décrivant la taille et la position de la fenêtre à créer, dans les coordonnées clientes de pParentWnd.

pParentWnd
Pointeur vers la fenêtre qui est le parent du contrôle.

nID
ID de la fenêtre enfant du contrôle.

Valeur de retour

Valeur différente de zéro cas de réussite ; sinon, 0.

Notes

Utilisez CreateEx plutôt que Créer pour appliquer des styles Windows étendus, spécifiés par le préface de style étendu Windows WS_EX_.

CIPAddressCtrl ::GetAddress

Récupère les valeurs d’adresse pour les quatre champs du contrôle d’adresse IP.

int GetAddress(
    BYTE& nField0,
    BYTE& nField1,
    BYTE& nField2,
    BYTE& nField3);

int GetAddress(DWORD& dwAddress);

Paramètres

nField0
Référence au champ 0 à partir d’une adresse IP packée.

nField1
Référence au champ 1 à partir d’une adresse IP packée.

nField2
Référence au champ 2 à partir d’une adresse IP packée.

nField3
Référence au champ 3 à partir d’une adresse IP packée.

dwAddress
Référence à l’adresse d’une valeur DWORD qui reçoit l’adresse IP. Consultez les remarques d’une table qui montre comment dwAddress est rempli.

Valeur de retour

Nombre de champs non vides dans le contrôle d’adresse IP.

Notes

Cette fonction membre implémente le comportement du message Win32 IPM_GETADDRESS, comme décrit dans le Kit de développement logiciel (SDK) Windows. Dans le premier prototype ci-dessus, les nombres des champs 0 à 3 du contrôle, lus respectivement à gauche, remplissent les quatre paramètres. Dans le deuxième prototype ci-dessus, dwAddress est rempli comme suit.

CIPAddressCtrl ::IsBlank

Détermine si tous les champs du contrôle d’adresse IP sont vides.

BOOL IsBlank() const;

Valeur de retour

Différent de zéro si tous les champs de contrôle d’adresse IP sont vides ; sinon 0.

Notes

Cette fonction membre implémente le comportement du message Win32 IPM_ISBLANK, comme décrit dans le Kit de développement logiciel (SDK) Windows.

CIPAddressCtrl ::SetAddress

Définit les valeurs d’adresse pour les quatre champs du contrôle d’adresse IP.

void SetAddress(
    BYTE nField0,
    BYTE nField1,
    BYTE nField2,
    BYTE nField3);

void SetAddress(DWORD dwAddress);

Paramètres

nField0
Valeur du champ 0 à partir d’une adresse IP packée.

nField1
Valeur du champ 1 à partir d’une adresse IP packée.

nField2
Valeur du champ 2 à partir d’une adresse IP packée.

nField3
Valeur du champ 3 à partir d’une adresse IP packée.

dwAddress
Valeur DWORD qui contient la nouvelle adresse IP. Consultez les remarques d’une table qui montre comment la valeur DWORD est remplie.

Notes

Cette fonction membre implémente le comportement du message Win32 IPM_SETADDRESS, comme décrit dans le Kit de développement logiciel (SDK) Windows. Dans le premier prototype ci-dessus, les nombres des champs 0 à 3 du contrôle, lus respectivement à gauche, remplissent les quatre paramètres. Dans le deuxième prototype ci-dessus, dwAddress est rempli comme suit.

CIPAddressCtrl ::SetFieldFocus

Définit le focus clavier sur le champ spécifié dans le contrôle d’adresse IP.

void SetFieldFocus(WORD nField);

Paramètres

nField
Index de champ de base zéro sur lequel le focus doit être défini. Si cette valeur est supérieure au nombre de champs, le focus est défini sur le premier champ vide. Si tous les champs ne sont pas vides, le focus est défini sur le premier champ.

Notes

Cette fonction membre implémente le comportement du message Win32 IPM_SETFOCUS, comme décrit dans le Kit de développement logiciel (SDK) Windows.

CIPAddressCtrl ::SetFieldRange

Définit la plage dans le champ spécifié dans le contrôle d’adresse IP.

void SetFieldRange(
    int nField,
    BYTE nLower,
    BYTE nUpper);

Paramètres

nField
Index de champ de base zéro auquel la plage sera appliquée.

nLower
Référence à un entier recevant la limite inférieure du champ spécifié dans ce contrôle d’adresse IP.

nUpper
Référence à un entier recevant la limite supérieure du champ spécifié dans ce contrôle d’adresse IP.

Notes

Cette fonction membre implémente le comportement du message Win32 IPM_SETRANGE, comme décrit dans le Kit de développement logiciel (SDK) Windows. Utilisez les deux paramètres, nLower et nUpper, pour indiquer les limites inférieures et supérieures du champ, au lieu du paramètre wRange utilisé avec le message Win32.

Voir aussi

CWnd, classe
Graphique hiérarchique