Rutinas de validación de datos de cuadros de diálogo estándar

  • Artículo

En este tema se enumeran las rutinas de validación de datos de cuadros de diálogo (DDV) estándar que se usan en los controles de cuadros de diálogo MFC comunes.

Nota:

Las rutinas de intercambio de datos de cuadros de diálogo estándar se definen en el archivo de encabezado afxdd_.h. Pero las aplicaciones deben incluir afxwin.h.

Funciones de DDV

Nombre Descripción
DDV_MaxChars Comprueba que el número de caracteres de un valor de control determinado no supera un máximo determinado.
DDV_MinMaxByte Comprueba que un valor de control determinado no supera un rango BYTE determinado.
DDV_MinMaxDateTime Comprueba que un valor de control determinado no supera un intervalo de tiempo determinado.
DDV_MinMaxDouble Comprueba que un valor de control determinado no supera un rango double determinado.
DDV_MinMaxDWord Comprueba que un valor de control determinado no supera un rango DWORD determinado.
DDV_MinMaxFloat Comprueba que un valor de control determinado no supera un rango float determinado.
DDV_MinMaxInt Comprueba que un valor de control determinado no supera un rango int determinado.
DDV_MinMaxLong Comprueba que un valor de control determinado no supera un rango long determinado.
DDV_MinMaxLongLong Comprueba que un valor de control determinado no supera un rango LONGLONG determinado.
DDV_MinMaxMonth Comprueba que un valor de control determinado no supera un intervalo de fechas determinado.
DDV_MinMaxShort Comprueba que un valor de control determinado no supera un rango short determinado.
DDV_MinMaxSlider Comprueba que un valor de control deslizante determinado se encuentra dentro del rango especificado.
DDV_MinMaxUInt Comprueba que un valor de control determinado no supera un rango UINT determinado.
DDV_MinMaxUnsigned Comprueba que un valor de control determinado se encuentra entre dos valores especificados.
DDV_MinMaxULongLong Comprueba que un valor de control determinado no supera un rango ULONGLONG determinado.

DDV_MaxChars

Llame a DDV_MaxChars para comprobar que la cantidad de caracteres del control asociado a value no supera nChars.

void AFXAPI DDV_MaxChars(
    CDataExchange* pDX,
    CString const& value,
    int nChars);

Parámetros

pDX
Puntero a un objeto CDataExchange . El marco de trabajo proporciona este objeto para establecer el contexto del intercambio de datos, incluida su dirección.

value
Referencia a una variable miembro del objeto de cuadro de diálogo, vista de formulario o vista de control con el que se validan los datos.

nChars
Número máximo de caracteres permitidos.

Comentarios

Para obtener más información sobre DDV, vea Intercambio y validación de datos de cuadros de diálogo.

Requisitos

Encabezado afxdd_.h

DDV_MinMaxByte

Llame a DDV_MinMaxByte para comprobar que el valor del control asociado a value se encuentra entre minVal y maxVal.

void AFXAPI DDV_MinMaxByte(
    CDataExchange* pDX,
    BYTE value,
    BYTE minVal,
    BYTE maxVal);

Parámetros

pDX
Puntero a un objeto CDataExchange . El marco de trabajo proporciona este objeto para establecer el contexto del intercambio de datos, incluida su dirección.

value
Referencia a una variable miembro del objeto de cuadro de diálogo, vista de formulario o vista de control con el que se validan los datos.

minVal
Valor mínimo (de tipo BYTE) permitido.

maxVal
Valor máximo (de tipo BYTE) permitido.

Comentarios

Para obtener más información sobre DDV, vea Intercambio y validación de datos de cuadros de diálogo.

Requisitos

Encabezado afxdd_.h

DDV_MinMaxDateTime

Llame a DDV_MinMaxDateTime para comprobar que el valor de fecha y hora del control de selector de fecha y hora (CDateTimeCtrl) asociado a refValue se encuentra entre refMinRange y refMaxRange.

void AFXAPI DDV_MinMaxDateTime(
    CDataExchange* pDX,
    CTime& refValue,
    const CTime* refMinRange,
    const CTime* refMaxRange);

void AFXAPI DDV_MinMaxDateTime(
    CDataExchange* pDX,
    COleDateTime& refValue,
    const COleDateTime* refMinRange,
    const COleDateTime* refMaxRange);

Parámetros

pDX
Puntero a un objeto CDataExchange. El marco de trabajo proporciona este objeto para establecer el contexto del intercambio de datos, incluida su dirección. No es necesario eliminar este objeto.

refValue
Referencia a un objeto CTime o COleDateTime asociado a una variable miembro del objeto de cuadro de diálogo, vista de formulario o vista de control. Este objeto contiene los datos que se van a validar.

refMinRange
Valor mínimo de fecha y hora permitido.

refMaxRange
Valor máximo de fecha y hora permitido.

Comentarios

Para obtener más información sobre DDV, vea Intercambio y validación de datos de cuadros de diálogo.

Requisitos

Encabezado afxdd_.h

DDV_MinMaxDouble

Llame a DDV_MinMaxDouble para comprobar que el valor del control asociado a value se encuentra entre minVal y maxVal.

void AFXAPI DDV_MinMaxDouble(
    CDataExchange* pDX,
    double const& value,
    double minVal,
    double maxVal);

Parámetros

pDX
Puntero a un objeto CDataExchange . El marco de trabajo proporciona este objeto para establecer el contexto del intercambio de datos, incluida su dirección.

value
Referencia a una variable miembro del objeto de cuadro de diálogo, vista de formulario o vista de control con el que se validan los datos.

minVal
Valor mínimo (de tipo double) permitido.

maxVal
Valor máximo (de tipo double) permitido.

Comentarios

Para obtener más información sobre DDV, vea Intercambio y validación de datos de cuadros de diálogo.

Requisitos

Encabezado afxdd_.h

DDV_MinMaxDWord

Llame a DDV_MinMaxDWord para comprobar que el valor del control asociado a value se encuentra entre minVal y maxVal.

void AFXAPI DDV_MinMaxDWord(
    CDataExchange* pDX,
    DWORD const& value,
    DWORD minVal,
    DWORD maxVal);

Parámetros

pDX
Puntero a un objeto CDataExchange . El marco de trabajo proporciona este objeto para establecer el contexto del intercambio de datos, incluida su dirección.

value
Referencia a una variable miembro del objeto de cuadro de diálogo, vista de formulario o vista de control con el que se validan los datos.

minVal
Valor mínimo (de tipo DWORD) permitido.

maxVal
Valor máximo (de tipo DWORD) permitido.

Comentarios

Para obtener más información sobre DDV, vea Intercambio y validación de datos de cuadros de diálogo.

Requisitos

Encabezado afxdd_.h

DDV_MinMaxFloat

Llame a DDV_MinMaxFloat para comprobar que el valor del control asociado a value se encuentra entre minVal y maxVal.

void AFXAPI DDV_MinMaxFloat(
    CDataExchange* pDX,
    float value,
    float minVal,
    float maxVal);

Parámetros

pDX
Puntero a un objeto CDataExchange . El marco de trabajo proporciona este objeto para establecer el contexto del intercambio de datos, incluida su dirección.

value
Referencia a una variable miembro del objeto de cuadro de diálogo, vista de formulario o vista de control con el que se validan los datos.

minVal
Valor mínimo (de tipo float) permitido.

maxVal
Valor máximo (de tipo float) permitido.

Comentarios

Para obtener más información sobre DDV, vea Intercambio y validación de datos de cuadros de diálogo.

Requisitos

Encabezado afxdd_.h

DDV_MinMaxInt

Llame a DDV_MinMaxInt para comprobar que el valor del control asociado a value se encuentra entre minVal y maxVal.

void AFXAPI DDV_MinMaxInt(
    CDataExchange* pDX,
    int value,
    int minVal,
    int maxVal);

Parámetros

pDX
Puntero a un objeto CDataExchange . El marco de trabajo proporciona este objeto para establecer el contexto del intercambio de datos, incluida su dirección.

value
Referencia a una variable miembro del objeto de cuadro de diálogo, vista de formulario o vista de control con el que se validan los datos.

minVal
Valor mínimo (de tipo int) permitido.

maxVal
Valor máximo (de tipo int) permitido.

Comentarios

Para obtener más información sobre DDV, vea Intercambio y validación de datos de cuadros de diálogo.

Requisitos

Encabezado afxdd_.h

DDV_MinMaxLong

Llame a DDV_MinMaxLong para comprobar que el valor del control asociado a value se encuentra entre minVal y maxVal.

void AFXAPI DDV_MinMaxLong(
    CDataExchange* pDX,
    long value,
    long minVal,
    long maxVal);

Parámetros

pDX
Puntero a un objeto CDataExchange . El marco de trabajo proporciona este objeto para establecer el contexto del intercambio de datos, incluida su dirección.

value
Referencia a una variable miembro del objeto de cuadro de diálogo, vista de formulario o vista de control con el que se validan los datos.

minVal
Valor mínimo (de tipo long) permitido.

maxVal
Valor máximo (de tipo long) permitido.

Comentarios

Para obtener más información sobre DDV, vea Intercambio y validación de datos de cuadros de diálogo.

Requisitos

Encabezado afxdd_.h

DDV_MinMaxLongLong

Llame a DDV_MinMaxLongLong para comprobar que el valor del control asociado a value se encuentra entre minVal y maxVal.

void AFXAPI DDV_MinMaxLongLong(
    CDataExchange* pDX,
    LONGLONG value,
    LONGLONG minVal,
    LONGLONG maxVal);

Parámetros

pDX
Puntero a un objeto CDataExchange . El marco de trabajo proporciona este objeto para establecer el contexto del intercambio de datos, incluida su dirección.

value
Referencia a una variable miembro del objeto de cuadro de diálogo, vista de formulario o vista de control con el que se validan los datos.

minVal
Valor mínimo (de tipo LONGLONG) permitido.

maxVal
Valor máximo (de tipo LONGLONG) permitido.

Comentarios

Para obtener más información sobre DDV, vea Intercambio y validación de datos de cuadros de diálogo.

Requisitos

Encabezado afxdd_.h

DDV_MinMaxMonth

Llame a DDV_MinMaxMonth para comprobar que el valor de fecha y hora del control de calendario mensual (CMonthCalCtrl) asociado a refValue se encuentra entre refMinRange y refMaxRange.

void AFXAPI DDV_MinMaxMonth(
    CDataExchange* pDX,
    CTime& refValue,
    const CTime* refMinRange,
    const CTime* refMaxRange);

void AFXAPI DDV_MinMaxMonth(
    CDataExchange* pDX,
    COleDateTime& refValue,
    const COleDateTime* refMinRange,
    const COleDateTime* refMaxRange);

Parámetros

pDX
Puntero a un objeto CDataExchange. El marco de trabajo proporciona este objeto para establecer el contexto del intercambio de datos, incluida su dirección.

refValue
Referencia a un objeto de tipo CTime o COleDateTime asociado a una variable miembro del objeto de cuadro de diálogo, vista de formulario o vista de control. Este objeto contiene los datos que se van a validar. MFC pasa esta referencia cuando se llama a DDV_MinMaxMonth.

refMinRange
Valor mínimo de fecha y hora permitido.

refMaxRange
Valor máximo de fecha y hora permitido.

Comentarios

Para obtener más información sobre DDV, vea Intercambio y validación de datos de cuadros de diálogo.

Requisitos

Encabezado afxdd_.h

DDV_MinMaxShort

Llame a DDV_MinMaxShort para comprobar que el valor del control asociado a value se encuentra entre minVal y maxVal.

void AFXAPI DDV_MinMaxShort(
    CDataExchange* pDX,
    short value,
    short minVal,
    short maxVal);

Parámetros

pDX
Puntero a un objeto CDataExchange . El marco de trabajo proporciona este objeto para establecer el contexto del intercambio de datos, incluida su dirección.

value
Referencia a una variable miembro del objeto de cuadro de diálogo, vista de formulario o vista de control con el que se validan los datos.

minVal
Valor mínimo (de tipo short) permitido.

maxVal
Valor máximo (de tipo short) permitido.

Comentarios

Para obtener más información sobre DDV, vea Intercambio y validación de datos de cuadros de diálogo.

Requisitos

Encabezado afxdd_.h

DDV_MinMaxSlider

Llame a DDV_MinMaxSlider para comprobar que el valor del control asociado a value se encuentra entre minVal y maxVal.

void AFXAPI DDV_MinMaxSlider(
    CDataExchange* pDX,
    DWORD value,
    DWORD minVal,
    DWORD maxVal);

Parámetros

pDX
Puntero a un objeto CDataExchange. El marco de trabajo proporciona este objeto para establecer el contexto del intercambio de datos, incluida su dirección.

value
Referencia al valor que se va a validar. Este parámetro contiene o establece la posición actual del control deslizante.

minVal
Valor mínimo permitido.

maxVal
Valor máximo permitido.

Comentarios

Para obtener más información sobre DDV, vea Intercambio y validación de datos de cuadros de diálogo. Para obtener información sobre los controles deslizantes, vea Usar CSliderCtrl.

Requisitos

Encabezado afxdd_.h

DDV_MinMaxUInt

Llame a DDV_MinMaxUInt para comprobar que el valor del control asociado a value se encuentra entre minVal y maxVal.

void AFXAPI DDV_MinMaxUInt(
    CDataExchange* pDX,
    UINT value,
    UINT minVal,
    UINT maxVal);

Parámetros

pDX
Puntero a un objeto CDataExchange . El marco de trabajo proporciona este objeto para establecer el contexto del intercambio de datos, incluida su dirección.

value
Referencia a una variable miembro del objeto de cuadro de diálogo, vista de formulario o vista de control con el que se validan los datos.

minVal
Valor mínimo (de tipo UINT) permitido.

maxVal
Valor máximo (de tipo UINT) permitido.

Comentarios

Para obtener más información sobre DDV, vea Intercambio y validación de datos de cuadros de diálogo.

Requisitos

Encabezado afxdd_.h

DDV_MinMaxULongLong

Llame a DDV_MinMaxULongLong para comprobar que el valor del control asociado a value se encuentra entre minVal y maxVal.

void AFXAPI DDV_MinMaxULongLong(
    CDataExchange* pDX,
    ULONGLONG value,
    ULONGLONG  minVal ,
    ULONGLONG  maxVal);

Parámetros

pDX
Puntero a un objeto CDataExchange . El marco de trabajo proporciona este objeto para establecer el contexto del intercambio de datos, incluida su dirección.

value
Referencia a una variable miembro del objeto de cuadro de diálogo, vista de formulario o vista de control con el que se validan los datos.

minVal
Valor mínimo (de tipo ULONGLONG) permitido.

maxVal
Valor máximo (de tipo ULONGLONG) permitido.

Comentarios

Para obtener más información sobre DDV, vea Intercambio y validación de datos de cuadros de diálogo.

Requisitos

Encabezado afxdd_.h

DDV_MinMaxUnsigned

Llame a DDV_MinMaxUnsigned para comprobar que el valor del control asociado a value se encuentra entre minVal y maxVal.

Sintaxis

   void AFXAPI DDV_MinMaxUnsigned(
       CDataExchange* pDX,
       unsigned value,
       unsigned minVal,
       unsigned maxVal );

Parámetros

pDX
Puntero a un objeto CDataExchange . El marco de trabajo proporciona este objeto para establecer el contexto del intercambio de datos, incluida su dirección.

value
Referencia a una variable miembro del objeto de cuadro de diálogo, vista de formulario o vista de control con el que se validan los datos.

minVal
Valor mínimo (de tipo unsigned) permitido.

maxVal
Valor máximo (de tipo unsigned) permitido.

Comentarios

Para obtener más información sobre DDV, vea Intercambio y validación de datos de cuadros de diálogo.

Requisitos

Encabezado: afxdd_.h

Consulte también

Rutinas de intercambio de datos de cuadros de diálogo estándar
Macros y globales
DDX_Slider
DDX_FieldSlider