標準的なダイアログ データ検証ルーチン

このトピックでは、一般的な MFC ダイアログ コントロールに使用される標準ダイアログ データ検証 (DDV) ルーチンの一覧を示します。

Note

標準ダイアログ・データ交換ルーチンは、ヘッダー・ファイル 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	指定されたコントロール値が、指定した 2 つの値の間にあるかどうかを確認します。
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 の詳細については、「 Dialog データ交換と検証を参照してください。

要件

Header 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 の詳細については、「 Dialog データ交換と検証を参照してください。

要件

Header 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 の詳細については、「 Dialog データ交換と検証を参照してください。

要件

Header 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 の詳細については、「 Dialog データ交換と検証を参照してください。

要件

Header 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 の詳細については、「 Dialog データ交換と検証を参照してください。

要件

Header 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 の詳細については、「 Dialog データ交換と検証を参照してください。

要件

Header 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 の詳細については、「 Dialog データ交換と検証を参照してください。

要件

Header 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 の詳細については、「 Dialog データ交換と検証を参照してください。

要件

Header 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 の詳細については、「 Dialog データ交換と検証を参照してください。

要件

Header 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 の詳細については、「 Dialog データ交換と検証を参照してください。

要件

Header 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 の詳細については、「 Dialog データ交換と検証を参照してください。

要件

Header 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 の詳細については、「 Dialog データ交換と検証を参照してください。 スライダー コントロールの詳細については、「 CsliderCtrl の使用」を参照してください。

要件

Header 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 の詳細については、「 Dialog データ交換と検証を参照してください。

要件

Header 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 の詳細については、「 Dialog データ交換と検証を参照してください。

要件

Header 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 の詳細については、「 Dialog データ交換と検証を参照してください。

要件

Header: afxdd_.h

関連項目

標準的なダイアログ データ エクスチェンジ ルーチン
マクロとグローバル
DDX_Slider
DDX_FieldSlider