共用方式為

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

  • 發行項

本主題列出用於一般 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