CIPAddressCtrl, classe
Fournit les fonctionnalités du contrôle commun d'adresse IP Windows.
Syntaxe
class CIPAddressCtrl : public CWnd
Membres
Constructeurs publics
| Nom | Description |
|---|---|
| CIPAddressCtrl ::CIPAddressCtrl | Construit un objet CIPAddressCtrl. |
Méthodes publiques
| Nom | Description |
|---|---|
| CIPAddressCtrl ::ClearAddress | Efface le contenu du contrôle d’adresse IP. |
| CIPAddressCtrl ::Create | Crée un contrôle d’adresse IP et l’attache à un CIPAddressCtrl objet. |
| CIPAddressCtrl ::CreateEx | Crée un contrôle d’adresse IP avec les styles étendus Windows spécifiés et l’attache à un CIPAddressCtrl objet. |
| CIPAddressCtrl ::GetAddress | Récupère les valeurs d’adresse pour les quatre champs du contrôle d’adresse IP. |
| CIPAddressCtrl ::IsBlank | Détermine si tous les champs du contrôle d’adresse IP sont vides. |
| CIPAddressCtrl ::SetAddress | Définit les valeurs d’adresse pour les quatre champs du contrôle d’adresse IP. |
| CIPAddressCtrl ::SetFieldFocus | Définit le focus clavier sur le champ spécifié dans le contrôle d’adresse IP. |
| CIPAddressCtrl ::SetFieldRange | Définit la plage dans le champ spécifié dans le contrôle d’adresse IP. |
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
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.
Appelez le constructeur, qui crée l’objet
CIPAddressCtrl.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.
| Champ | Bits contenant la valeur du champ |
|---|---|
| 0 | 24 à 31 |
| 1 | 16 à 23 |
| 2 | 8 à 15 |
| 3 | 0 à 7 |
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.
| Champ | Bits contenant la valeur du champ |
|---|---|
| 0 | 24 à 31 |
| 1 | 16 à 23 |
| 2 | 8 à 15 |
| 3 | 0 à 7 |
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
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour