CIPAddressCtrl Class
Proporciona la funcionalidad del control de dirección IP común de Windows.
Sintaxis
class CIPAddressCtrl : public CWnd
Miembros
Constructores públicos
| Nombre | Descripción |
|---|---|
| CIPAddressCtrl::CIPAddressCtrl | Construye un objeto CIPAddressCtrl. |
Métodos públicos
| Nombre | Descripción |
|---|---|
| CIPAddressCtrl::ClearAddress | Borra el contenido del control de direcciones IP. |
| CIPAddressCtrl::Create | Crea un control de dirección IP y lo asocia a un objeto CIPAddressCtrl. |
| CIPAddressCtrl::CreateEx | Crea un control de dirección IP con los estilos extendidos de Windows especificados y lo asocia a un objeto CIPAddressCtrl. |
| CIPAddressCtrl::GetAddress | Recupera los valores de dirección de los cuatro campos del control de direcciones IP. |
| CIPAddressCtrl::IsBlank | Determina si todos los campos del control de direcciones IP están vacíos. |
| CIPAddressCtrl::SetAddress | Establece los valores de dirección de los cuatro campos del control de direcciones IP. |
| CIPAddressCtrl::SetFieldFocus | Establece el foco del teclado en el campo especificado en el control de direcciones IP. |
| CIPAddressCtrl::SetFieldRange | Establece el intervalo del campo especificado en el control de direcciones IP. |
Comentarios
Un control de dirección IP, un control similar a un control de edición, permite escribir y manipular una dirección numérica en formato protocolo de Internet (IP).
Este control (y, por tanto, la clase CIPAddressCtrl) solo está disponible para los programas que se ejecutan en Microsoft Internet Explorer 4.0 y versiones posteriores. También estarán disponibles en versiones futuras de Windows y Windows NT.
Para obtener más información general sobre el control de direcciones IP, vea Controles de direcciones IP en Windows SDK.
Jerarquía de herencia
CIPAddressCtrl
Requisitos
Encabezado: afxcmn.h
CIPAddressCtrl::CIPAddressCtrl
Crea un objeto CIPAddressCtrl.
CIPAddressCtrl();
CIPAddressCtrl::ClearAddress
Borra el contenido del control de direcciones IP.
void ClearAddress();
Comentarios
En esta función miembro, se implementa el comportamiento del mensaje IPM_CLEARADDRESS de Win32, tal y como se describe en Windows SDK.
CIPAddressCtrl::Create
Crea un control de dirección IP y lo asocia a un objeto CIPAddressCtrl.
virtual BOOL Create(
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID);
Parámetros
dwStyle
Estilo del control de dirección IP. Especifique una combinación de estilos de ventana. Debe incluir el estilo WS_CHILD porque el control debe ser una ventana secundaria. Consulta CreateWindow en Windows SDK para obtener una lista de estilos de Windows.
rect
Una referencia al tamaño y la posición del control de direcciones IP. Puede ser un objeto CRect o una estructura RECT.
pParentWnd
Un puntero a la ventana primaria del control de direcciones IP. No debe ser NULL.
Nid
ID del control de dirección IP.
Valor devuelto
Es distinto de cero si la inicialización se realiza correctamente; de lo contrario,es 0.
Comentarios
El objeto CIPAddressCtrl se construye en dos pasos.
Llama al constructor, que crea el objeto
CIPAddressCtrl.Llama a
Create, que crea el control de direcciones IP.
Si quiere usar estilos extendidos de Windows con el control, llame a CreateEx en lugar de a Create.
CIPAddressCtrl::CreateEx
Llame a esta función para crear un control (una ventana secundaria) y asociarlo al objeto CIPAddressCtrl.
virtual BOOL CreateEx(
DWORD dwExStyle,
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID);
Parámetros
dwExStyle
El valor de este parámetro se usa para especificar el estilo extendido del control que se va a crear. Para ver una lista de estilos extendidos de Windows, consulte el parámetro dwExStyle para CreateWindowEx en Windows SDK.
dwStyle
Estilo del control de dirección IP. Especifique una combinación de estilos de ventana. Debe incluir el estilo WS_CHILD porque el control debe ser una ventana secundaria. Consulta CreateWindow en Windows SDK para obtener una lista de estilos de Windows.
rect
Referencia a una estructura RECT que describe el tamaño y la posición de la ventana que se va a crear, en coordenadas de cliente de pParentWnd.
pParentWnd
Un puntero a la ventana que constituye el elemento primario del control.
Nid
El identificador de ventana secundaria del control.
Valor devuelto
Si es correcta, su valor es distinto de cero. En caso contrario, es cero.
Comentarios
Use CreateEx en lugar de Create para aplicar estilos extendidos de Windows, especificados por el prefacio de estilo extendido de Windows WS_EX_.
CIPAddressCtrl::GetAddress
Recupera los valores de dirección de los cuatro campos del control de direcciones IP.
int GetAddress(
BYTE& nField0,
BYTE& nField1,
BYTE& nField2,
BYTE& nField3);
int GetAddress(DWORD& dwAddress);
Parámetros
nField0
Referencia al valor del campo 0 de una dirección IP empaquetada.
nField1
Referencia al valor del campo 1 de una dirección IP empaquetada.
nField2
Referencia al valor del campo 2 de una dirección IP empaquetada.
nField3
Referencia al valor del campo 3 de una dirección IP empaquetada.
dwAddress
Referencia a la dirección de un valor DWORD que recibe la dirección IP. Consulta Comentarios de una tabla que muestra cómo se rellena dwAddress.
Valor devuelto
Número de campos que no están en blanco en el control de direcciones IP.
Comentarios
En esta función miembro, se implementa el comportamiento del mensaje IPM_GETADDRESS de Win32, tal y como se describe en Windows SDK. En el primer prototipo anterior, los números de los campos del 0 al 3 del control, leídos de izquierda a derecha respectivamente, rellenan los cuatro parámetros. En el segundo prototipo anterior, dwAddress se rellena de la siguiente manera.
| Campo | Bits que contienen el valor del campo |
|---|---|
| 0 | De 24 a 31 |
| 1 | De 16 a 23 |
| 2 | De 8 a 15 |
| 3 | 0 mediante 7 |
CIPAddressCtrl::IsBlank
Determina si todos los campos del control de direcciones IP están vacíos.
BOOL IsBlank() const;
Valor devuelto
Distinto de cero si todos los campos control de direcciones IP están vacíos; de lo contrario, 0.
Comentarios
En esta función miembro, se implementa el comportamiento del mensaje IPM_ISBLANK de Win32, tal y como se describe en Windows SDK.
CIPAddressCtrl::SetAddress
Establece los valores de dirección de los cuatro campos del control de direcciones IP.
void SetAddress(
BYTE nField0,
BYTE nField1,
BYTE nField2,
BYTE nField3);
void SetAddress(DWORD dwAddress);
Parámetros
nField0
El valor del campo 0 de una dirección IP empaquetada.
nField1
El valor del campo 1 de una dirección IP empaquetada.
nField2
El valor del campo 2 de una dirección IP empaquetada.
nField3
El valor del campo 3 de una dirección IP empaquetada.
dwAddress
Un valor DWORD que contiene la nueva dirección IP. Consulta Comentarios de una tabla que muestra cómo se rellena el valor DWORD.
Comentarios
En esta función miembro, se implementa el comportamiento del mensaje IPM_SETADDRESS de Win32, tal y como se describe en Windows SDK. En el primer prototipo anterior, los números de los campos del 0 al 3 del control, leídos de izquierda a derecha respectivamente, rellenan los cuatro parámetros. En el segundo prototipo anterior, dwAddress se rellena de la siguiente manera.
| Campo | Bits que contienen el valor del campo |
|---|---|
| 0 | De 24 a 31 |
| 1 | De 16 a 23 |
| 2 | De 8 a 15 |
| 3 | 0 mediante 7 |
CIPAddressCtrl::SetFieldFocus
Establece el foco del teclado en el campo especificado en el control de direcciones IP.
void SetFieldFocus(WORD nField);
Parámetros
nField
Índice de campo de base cero en el que se debe establecer el foco. Si este valor es mayor que el número de campos, el foco se establece en el primer campo en blanco. Si todos los campos no están en blanco, el foco se establece en el primer campo.
Comentarios
En esta función miembro, se implementa el comportamiento del mensaje IPM_SETFOCUS de Win32, tal y como se describe en Windows SDK.
CIPAddressCtrl::SetFieldRange
Establece el intervalo del campo especificado en el control de direcciones IP.
void SetFieldRange(
int nField,
BYTE nLower,
BYTE nUpper);
Parámetros
nField
Índice de campo de base cero al que se aplicará el intervalo.
nLower
Referencia a un entero que recibe el límite inferior del campo especificado en este control de direcciones IP.
nUpper
Referencia a un entero que recibe el límite superior del campo especificado en este control de direcciones IP.
Comentarios
Esta función miembro implementa el comportamiento del mensaje IPM_SETRANGE de Win32, tal y como se describe en Windows SDK. Usa los dos parámetros, nLower y nUpper, para indicar los límites inferiores y superiores del campo, en lugar del parámetro wRange usado con el mensaje Win32.