标准对话框数据验证例程
本主题列出了用于常见 MFC 对话框控件的标准对话框数据验证 (DDV) 例程。
注意
标准对话数据交换例程在头文件 afxdd_.h 中定义。 但是，应用程序应包括 afxwin.h。
DDV 函数
| 名称 | 描述 |
|---|---|
| DDV_MaxChars | 验证给定控件值中的字符数是否不超过给定最大值。 |
| DDV_MinMaxByte | 验证给定控件值是否不超过给定的 BYTE 范围。 |
| DDV_MinMaxDateTime | 验证给定控件值是否不超过给定的时间范围。 |
| DDV_MinMaxDouble | 验证给定控件值是否不超过给定的 double 范围。 |
| DDV_MinMaxDWord | 验证给定控件值是否不超过给定的 DWORD 范围。 |
| DDV_MinMaxFloat | 验证给定控件值是否不超过给定的 float 范围。 |
| DDV_MinMaxInt | 验证给定控件值是否不超过给定的 int 范围。 |
| DDV_MinMaxLong | 验证给定控件值是否不超过给定的 long 范围。 |
| DDV_MinMaxLongLong | 验证给定控件值是否不超过给定的 LONGLONG 范围。 |
| DDV_MinMaxMonth | 验证给定控件值是否不超过给定的日期范围。 |
| DDV_MinMaxShort | 验证给定控件值是否不超过给定的 short 范围。 |
| DDV_MinMaxSlider | 验证给定滑块控件值是否处于给定范围内。 |
| DDV_MinMaxUInt | 验证给定控件值是否不超过给定的 UINT 范围。 |
| DDV_MinMaxUnsigned | 验证给定控件值是否介于两个指定值之间。 |
| DDV_MinMaxULongLong | 验证给定控件值是否不超过给定的 ULONGLONG 范围。 |
DDV_MaxChars
调用 DDV_MaxChars 以验证与 value 关联的控件中的字符数不超过 nChars。
void AFXAPI DDV_MaxChars(
CDataExchange* pDX,
CString const& value,
int nChars);
参数
pDX
一个指向 CDataExchange 对象的指针。 框架提供了此对象以建立数据交换的上下文，包括其方向。
value
对相关对话框、窗体视图或控件视图对象（通过其验证数据）的成员变量的引用。
nChars
允许的最大字符数。
备注
有关 DDV 的更多信息，请参阅对话框数据交换和验证。
要求
标头 afxdd_.h
DDV_MinMaxByte
调用 DDV_MinMaxByte 以验证与 value 关联的控件中的值是否介于 minVal 和 maxVal 之间。
void AFXAPI DDV_MinMaxByte(
CDataExchange* pDX,
BYTE value,
BYTE minVal,
BYTE maxVal);
参数
pDX
一个指向 CDataExchange 对象的指针。 框架提供了此对象以建立数据交换的上下文，包括其方向。
value
对相关对话框、窗体视图或控件视图对象（通过其验证数据）的成员变量的引用。
minVal
允许的最小值（BYTE 类型）。
maxVal
允许的最大值（BYTE 类型）。
备注
有关 DDV 的更多信息，请参阅对话框数据交换和验证。
要求
标头 afxdd_.h
DDV_MinMaxDateTime
调用 DDV_MinMaxDateTime，验证与 refValue 关联的日期和时间选择器控件 (CDateTimeCtrl) 中的时间/日期值是否介于 refMinRange 和 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);
参数
pDX
指向 CDataExchange 对象的指针。 框架提供了此对象以建立数据交换的上下文，包括其方向。 无需删除此对象。
refValue
对 CTime 或 COleDateTime 对象（与对话框、表单视图或控件视图对象的成员变量关联）的引用。 此对象包含要验证的数据。
refMinRange
允许的最小日期/时间值。
refMaxRange
允许的最大日期/时间值。
备注
有关 DDV 的更多信息，请参阅对话框数据交换和验证。
要求
标头 afxdd_.h
DDV_MinMaxDouble
调用 DDV_MinMaxDouble 以验证与 value 关联的控件中的值是否介于 minVal 和 maxVal 之间。
void AFXAPI DDV_MinMaxDouble(
CDataExchange* pDX,
double const& value,
double minVal,
double maxVal);
参数
pDX
一个指向 CDataExchange 对象的指针。 框架提供了此对象以建立数据交换的上下文，包括其方向。
value
对相关对话框、窗体视图或控件视图对象（通过其验证数据）的成员变量的引用。
minVal
允许的最小值（double 类型）。
maxVal
允许的最大值（double 类型）。
注解
有关 DDV 的更多信息，请参阅对话框数据交换和验证。
要求
标头 afxdd_.h
DDV_MinMaxDWord
调用 DDV_MinMaxDWord 以验证与 value 关联的控件中的值是否介于 minVal 和 maxVal 之间。
void AFXAPI DDV_MinMaxDWord(
CDataExchange* pDX,
DWORD const& value,
DWORD minVal,
DWORD maxVal);
参数
pDX
一个指向 CDataExchange 对象的指针。 框架提供了此对象以建立数据交换的上下文，包括其方向。
value
对相关对话框、窗体视图或控件视图对象（通过其验证数据）的成员变量的引用。
minVal
允许的最大值（DWORD 类型）。
maxVal
允许的最大值（DWORD 类型）。
注解
有关 DDV 的更多信息，请参阅对话框数据交换和验证。
要求
标头 afxdd_.h
DDV_MinMaxFloat
调用 DDV_MinMaxFloat 以验证与 value 关联的控件中的值是否介于 minVal 和 maxVal 之间。
void AFXAPI DDV_MinMaxFloat(
CDataExchange* pDX,
float value,
float minVal,
float maxVal);
参数
pDX
一个指向 CDataExchange 对象的指针。 框架提供了此对象以建立数据交换的上下文，包括其方向。
value
对相关对话框、窗体视图或控件视图对象（通过其验证数据）的成员变量的引用。
minVal
允许的最小值（float 类型）。
maxVal
允许的最大值（float 类型）。
注解
有关 DDV 的更多信息，请参阅对话框数据交换和验证。
要求
标头 afxdd_.h
DDV_MinMaxInt
调用 DDV_MinMaxInt 以验证与 value 关联的控件中的值是否介于 minVal 和 maxVal 之间。
void AFXAPI DDV_MinMaxInt(
CDataExchange* pDX,
int value,
int minVal,
int maxVal);
参数
pDX
一个指向 CDataExchange 对象的指针。 框架提供了此对象以建立数据交换的上下文，包括其方向。
value
对相关对话框、窗体视图或控件视图对象（通过其验证数据）的成员变量的引用。
minVal
允许的最小值（int 类型）。
maxVal
允许的最大值（int 类型）。
注解
有关 DDV 的更多信息，请参阅对话框数据交换和验证。
要求
标头 afxdd_.h
DDV_MinMaxLong
调用 DDV_MinMaxLong 以验证与 value 关联的控件中的值是否介于 minVal 和 maxVal 之间。
void AFXAPI DDV_MinMaxLong(
CDataExchange* pDX,
long value,
long minVal,
long maxVal);
参数
pDX
一个指向 CDataExchange 对象的指针。 框架提供了此对象以建立数据交换的上下文，包括其方向。
value
对相关对话框、窗体视图或控件视图对象（通过其验证数据）的成员变量的引用。
minVal
允许的最小值（long 类型）。
maxVal
允许的最大值（long 类型）。
注解
有关 DDV 的更多信息，请参阅对话框数据交换和验证。
要求
标头 afxdd_.h
DDV_MinMaxLongLong
调用 DDV_MinMaxLongLong 以验证与 value 关联的控件中的值是否介于 minVal 和 maxVal 之间。
void AFXAPI DDV_MinMaxLongLong(
CDataExchange* pDX,
LONGLONG value,
LONGLONG minVal,
LONGLONG maxVal);
参数
pDX
一个指向 CDataExchange 对象的指针。 框架提供了此对象以建立数据交换的上下文，包括其方向。
value
对相关对话框、窗体视图或控件视图对象（通过其验证数据）的成员变量的引用。
minVal
允许的最小值（LONGLONG 类型）。
maxVal
允许的最大值（LONGLONG 类型）。
备注
有关 DDV 的更多信息，请参阅对话框数据交换和验证。
要求
标头 afxdd_.h
DDV_MinMaxMonth
调用 DDV_MinMaxMonth，验证与 refValue 关联的日历控件 (CMonthCalCtrl) 中的时间/日期值是否介于 refMinRange 和 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);
参数
pDX
指向 CDataExchange 对象的指针。 框架提供了此对象以建立数据交换的上下文，包括其方向。
refValue
对类型为 CTime 或 COleDateTime 的对象（与对话框、表单视图或控件视图对象的成员变量关联）的引用。 此对象包含要验证的数据。 MFC 在调用 DDV_MinMaxMonth 时传递此引用。
refMinRange
允许的最小日期/时间值。
refMaxRange
允许的最大日期/时间值。
备注
有关 DDV 的更多信息，请参阅对话框数据交换和验证。
要求
标头 afxdd_.h
DDV_MinMaxShort
调用 DDV_MinMaxShort 以验证与 value 关联的控件中的值是否介于 minVal 和 maxVal 之间。
void AFXAPI DDV_MinMaxShort(
CDataExchange* pDX,
short value,
short minVal,
short maxVal);
参数
pDX
一个指向 CDataExchange 对象的指针。 框架提供了此对象以建立数据交换的上下文，包括其方向。
value
对相关对话框、窗体视图或控件视图对象（通过其验证数据）的成员变量的引用。
minVal
允许的最小值（short 类型）。
maxVal
允许的最大值（short 类型）。
注解
有关 DDV 的更多信息，请参阅对话框数据交换和验证。
要求
标头 afxdd_.h
DDV_MinMaxSlider
调用 DDV_MinMaxSlider 以验证与 value 关联的控件中的值是否介于 minVal 和 maxVal 之间。
void AFXAPI DDV_MinMaxSlider(
CDataExchange* pDX,
DWORD value,
DWORD minVal,
DWORD maxVal);
参数
pDX
指向 CDataExchange 对象的指针。 框架提供了此对象以建立数据交换的上下文，包括其方向。
value
对要验证的值的引用。 此参数保留或设置滑块控件的当前 Thumb 位置。
minVal
允许的最小值。
maxVal
允许的最大值。
注解
有关 DDV 的更多信息，请参阅对话框数据交换和验证。 有关滑块控件的信息，请参阅使用 CSliderCtrl。
要求
标头 afxdd_.h
DDV_MinMaxUInt
调用 DDV_MinMaxUInt 以验证与 value 关联的控件中的值是否介于 minVal 和 maxVal 之间。
void AFXAPI DDV_MinMaxUInt(
CDataExchange* pDX,
UINT value,
UINT minVal,
UINT maxVal);
参数
pDX
一个指向 CDataExchange 对象的指针。 框架提供了此对象以建立数据交换的上下文，包括其方向。
value
对相关对话框、窗体视图或控件视图对象（通过其验证数据）的成员变量的引用。
minVal
允许的最小值（UINT 类型）。
maxVal
允许的最大值（UINT 类型）。
备注
有关 DDV 的更多信息，请参阅对话框数据交换和验证。
要求
标头 afxdd_.h
DDV_MinMaxULongLong
调用 DDV_MinMaxULongLong 以验证与 value 关联的控件中的值是否介于 minVal 和 maxVal 之间。
void AFXAPI DDV_MinMaxULongLong(
CDataExchange* pDX,
ULONGLONG value,
ULONGLONG minVal ,
ULONGLONG maxVal);
参数
pDX
一个指向 CDataExchange 对象的指针。 框架提供了此对象以建立数据交换的上下文，包括其方向。
value
对相关对话框、窗体视图或控件视图对象（通过其验证数据）的成员变量的引用。
minVal
允许的最小值（ULONGLONG 类型）。
maxVal
允许的最大值（ULONGLONG 类型）。
备注
有关 DDV 的更多信息，请参阅对话框数据交换和验证。
要求
标头 afxdd_.h
DDV_MinMaxUnsigned
调用 DDV_MinMaxUnsigned 以验证与 value 关联的控件中的值是否介于 minVal 和 maxVal 之间。
语法
void AFXAPI DDV_MinMaxUnsigned(
CDataExchange* pDX,
unsigned value,
unsigned minVal,
unsigned maxVal );
参数
pDX
一个指向 CDataExchange 对象的指针。 框架提供了此对象以建立数据交换的上下文，包括其方向。
value
对相关对话框、窗体视图或控件视图对象（通过其验证数据）的成员变量的引用。
minVal
允许的最小值（unsigned 类型）。
maxVal
允许的最大值（unsigned 类型）。
注解
有关 DDV 的更多信息，请参阅对话框数据交换和验证。
要求
标头：afxdd_.h