標準對話方塊資料驗證常式

本主題列出用於一般 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 以確認與值相關聯之控件中的字元數量不會超過 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 與對話框、窗體檢視或控件檢視物件之成員變數相關聯的對象參考。 這個物件包含要驗證的數據。 呼叫 時 DDV_MinMaxMonth ，MFC 會傳遞此參考。

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
要驗證之值的參考。 此參數會保留或設定滑桿控件的目前拇指位置。

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