Compartir por

CIPAddressCtrl Class

  • Artigo

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

CObject

CCmdTarget

CWnd

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.

  1. Llama al constructor, que crea el objeto CIPAddressCtrl.

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

Consulte también

CWnd (clase)
Gráfico de jerarquías