Standard Dialog Data Validation Routines
The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.
The latest version of this topic can be found at Standard Dialog Data Validation Routines.
This topic lists the standard dialog data validation (DDV) routines used for common MFC dialog controls.
Note
The standard dialog data exchange routines are defined in the header file afxdd_.h. However, applications should include afxwin.h.
DDV Functions
| DDV_MaxChars | Verifies the number of characters in a given control value does not exceed a given maximum. |
| DDV_MinMaxByte | Verifies a given control value does not exceed a given BYTE range. |
| DDV_MinMaxDateTime | Verifies a given control value does not exceed a given time range. |
| DDV_MinMaxDouble | Verifies a given control value does not exceed a given double range. |
| DDV_MinMaxDWord | Verifies a given control value does not exceed a given DWORD range. |
| DDV_MinMaxFloat | Verifies a given control value does not exceed a given float range. |
| DDV_MinMaxInt | Verifies a given control value does not exceed a given int range. |
| DDV_MinMaxLong | Verifies a given control value does not exceed a given long range. |
| DDV_MinMaxLongLong | Verifies a given control value does not exceed a given LONGLONG range. |
| DDV_MinMaxMonth | Verifies a given control value does not exceed a given date range. |
| DDV_MinMaxShort | Verifies a given control value does not exceed a given short range. |
| DDV_MinMaxSlider | Verifies a given slider control value falls within the given range. |
| DDV_MinMaxUInt | Verifies a given control value does not exceed a given UINT range. |
| DDV_MinMaxULongLong | Verifies a given control value does not exceed a given ULONGLONG range. |
DDV_MaxChars
Call DDV_MaxChars to verify that the amount of characters in the control associated with value does not exceed nChars.
void AFXAPI DDV_MaxChars(
CDataExchange* pDX,
CString const& value,
int nChars);
Parameters
pDX
A pointer to a CDataExchange object. The framework supplies this object to establish the context of the data exchange, including its direction.
value
A reference to a member variable of the dialog box, form view, or control view object with which data is validated.
nChars
Maximum number of characters allowed.
Remarks
For more information about DDV, see Dialog Data Exchange and Validation.
DDV_MinMaxByte
Call DDV_MinMaxByte to verify that the value in the control associated with value falls between minVal and maxVal.
void AFXAPI DDV_MinMaxByte(
CDataExchange* pDX,
BYTE value,
BYTE minVal,
BYTE maxVal);
Parameters
pDX
A pointer to a CDataExchange object. The framework supplies this object to establish the context of the data exchange, including its direction.
value
A reference to a member variable of the dialog box, form view, or control view object with which data is validated.
minVal
Minimum value (of type BYTE) allowed.
maxVal
Maximum value (of type BYTE) allowed.
Remarks
For more information about DDV, see Dialog Data Exchange and Validation.
DDV_MinMaxDateTime
Call DDV_MinMaxDateTime to verify that the time/date value in the date and time picker control ( CDateTimeCtrl) associated with refValue falls between refMinRange and 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);
Parameters
pDX
A pointer to a CDataExchange object. The framework supplies this object to establish the context of the data exchange, including its direction. You don't need to delete this object.
refValue
A reference to a CTime or COleDateTime object associated with a member variable of the dialog box, form view, or control view object. This object contains the data to be validated.
refMinRange
Minimum date/time value allowed.
refMaxRange
Maximum date/time value allowed.
Remarks
For more information about DDV, see Dialog Data Exchange and Validation.
DDV_MinMaxDouble
Call DDV_MinMaxDouble to verify that the value in the control associated with value falls between minVal and maxVal.
void AFXAPI DDV_MinMaxDouble(
CDataExchange* pDX,
double const& value,
double minVal,
double maxVal);
Parameters
pDX
A pointer to a CDataExchange object. The framework supplies this object to establish the context of the data exchange, including its direction.
value
A reference to a member variable of the dialog box, form view, or control view object with which data is validated.
minVal
Minimum value (of type double) allowed.
maxVal
Maximum value (of type double) allowed.
Remarks
For more information about DDV, see Dialog Data Exchange and Validation.
DDV_MinMaxDWord
Call DDV_MinMaxDWord to verify that the value in the control associated with value falls between minVal and maxVal.
void AFXAPI DDV_MinMaxDWord(
CDataExchange* pDX,
DWORD const& value,
DWORD minVal,
DWORD maxVal);
Parameters
pDX
A pointer to a CDataExchange object. The framework supplies this object to establish the context of the data exchange, including its direction.
value
A reference to a member variable of the dialog box, form view, or control view object with which data is validated.
minVal
Minimum value (of type DWORD) allowed.
maxVal
Maximum value (of type DWORD) allowed.
Remarks
For more information about DDV, see Dialog Data Exchange and Validation.
DDV_MinMaxFloat
Call DDV_MinMaxFloat to verify that the value in the control associated with value falls between minVal and maxVal.
void AFXAPI DDV_MinMaxFloat(
CDataExchange* pDX,
float value,
float minVal,
float maxVal);
Parameters
pDX
A pointer to a CDataExchange object. The framework supplies this object to establish the context of the data exchange, including its direction.
value
A reference to a member variable of the dialog box, form view, or control view object with which data is validated.
minVal
Minimum value (of type float) allowed.
maxVal
Maximum value (of type float) allowed.
Remarks
For more information about DDV, see Dialog Data Exchange and Validation.
DDV_MinMaxInt
Call DDV_MinMaxInt to verify that the value in the control associated with value falls between minVal and maxVal.
void AFXAPI DDV_MinMaxInt(
CDataExchange* pDX,
int value,
int minVal,
int maxVal);
Parameters
pDX
A pointer to a CDataExchange object. The framework supplies this object to establish the context of the data exchange, including its direction.
value
A reference to a member variable of the dialog box, form view, or control view object with which data is validated.
minVal
Minimum value (of type int) allowed.
maxVal
Maximum value (of type int) allowed.
Remarks
For more information about DDV, see Dialog Data Exchange and Validation.
DDV_MinMaxLong
Call DDV_MinMaxLong to verify that the value in the control associated with value falls between minVal and maxVal.
void AFXAPI DDV_MinMaxLong(
CDataExchange* pDX,
long value,
long minVal,
long maxVal);
Parameters
pDX
A pointer to a CDataExchange object. The framework supplies this object to establish the context of the data exchange, including its direction.
value
A reference to a member variable of the dialog box, form view, or control view object with which data is validated.
minVal
Minimum value (of type long) allowed.
maxVal
Maximum value (of type long) allowed.
Remarks
For more information about DDV, see Dialog Data Exchange and Validation.
DDV_MinMaxLongLong
Call DDV_MinMaxLongLong to verify that the value in the control associated with value falls between minVal and maxVal.
void AFXAPI DDV_MinMaxLongLong(
CDataExchange* pDX,
LONGLONG value,
LONGLONG minVal,
LONGLONG maxVal);
Parameters
pDX
A pointer to a CDataExchange object. The framework supplies this object to establish the context of the data exchange, including its direction.
value
A reference to a member variable of the dialog box, form view, or control view object with which data is validated.
minVal
Minimum value (of type LONGLONG) allowed.
maxVal
Maximum value (of type LONGLONG) allowed.
Remarks
For more information about DDV, see Dialog Data Exchange and Validation.
DDV_MinMaxMonth
Call DDV_MinMaxMonth to verify that the time/date value in the month calendar control ( CMonthCalCtrl) associated with refValue falls between refMinRange and 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);
Parameters
pDX
A pointer to a CDataExchange object. The framework supplies this object to establish the context of the data exchange, including its direction.
refValue
A reference to an object of type CTime or COleDateTime associated with a member variable of the dialog box, form view, or control view object. This object contains the data to be validated. MFC passes this reference when DDV_MinMaxMonth is called.
refMinRange
Minimum date/time value allowed.
refMaxRange
Maximum date/time value allowed.
Remarks
For more information about DDV, see Dialog Data Exchange and Validation.
DDV_MinMaxShort
Call DDV_MinMaxShort to verify that the value in the control associated with value falls between minVal and maxVal.
void AFXAPI DDV_MinMaxShort(
CDataExchange* pDX,
short value,
short minVal,
short maxVal);
Parameters
pDX
A pointer to a CDataExchange object. The framework supplies this object to establish the context of the data exchange, including its direction.
value
A reference to a member variable of the dialog box, form view, or control view object with which data is validated.
minVal
Minimum value (of type short) allowed.
maxVal
Maximum value (of type short) allowed.
Remarks
For more information about DDV, see Dialog Data Exchange and Validation.
DDV_MinMaxSlider
Call DDV_MinMaxSlider to verify that the value in the control associated with value falls between minVal and maxVal.
void AFXAPI DDV_MinMaxSlider(
CDataExchange* pDX,
DWORD value,
DWORD minVal,
DWORD maxVal);
Parameters
pDX
A pointer to a CDataExchange object. The framework supplies this object to establish the context of the data exchange, including its direction.
value
A reference to the value to be validated. This parameter holds or sets the slider control's current thumb position.
minVal
Minimum value allowed.
maxVal
Maximum value allowed.
Remarks
For more information about DDV, see Dialog Data Exchange and Validation. For information about slider controls, see Using CSliderCtrl.
DDV_MinMaxUInt
Call DDV_MinMaxUInt to verify that the value in the control associated with value falls between minVal and maxVal.
void AFXAPI DDV_MinMaxUInt(
CDataExchange* pDX,
UINT value,
UINT minVal,
UINT maxVal);
Parameters
pDX
A pointer to a CDataExchange object. The framework supplies this object to establish the context of the data exchange, including its direction.
value
A reference to a member variable of the dialog box, form view, or control view object with which data is validated.
minVal
Minimum value (of type UINT) allowed.
maxVal
Maximum value (of type UINT) allowed.
Remarks
For more information about DDV, see Dialog Data Exchange and Validation.
DDV_MinMaxULongLong
Call DDV_MinMaxULongLong to verify that the value in the control associated with value falls between minVal and maxVal.
void AFXAPI DDV_MinMaxULongLong(
CDataExchange* pDX,
ULONGLONG value,
ULONGLONG minVal ,
ULONGLONG maxVal);
Parameters
pDX
A pointer to a CDataExchange object. The framework supplies this object to establish the context of the data exchange, including its direction.
value
A reference to a member variable of the dialog box, form view, or control view object with which data is validated.
minVal
Minimum value (of type ULONGLONG) allowed.
maxVal
Maximum value (of type ULONGLONG) allowed.
Remarks
For more information about DDV, see Dialog Data Exchange and Validation.