共用方式為


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

本主題列出用於一般 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
類型 CTimeCOleDateTime 與對話框、窗體檢視或控件檢視物件之成員變數相關聯的對象參考。 這個物件包含要驗證的數據。 呼叫 時 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