标准对话框数据验证例程

  • 项目

本主题列出了用于常见 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

另请参阅

标准对话框数据交换例程
宏和全局函数
DDX_Slider
DDX_FieldSlider