標準的なダイアログ データ検証ルーチン
このトピックでは、一般的な 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
値に関連付けられたコントロール内の文字の量が nChars を超えていないことを確認する呼び出しDDV_MaxChars。
void AFXAPI DDV_MaxChars(
CDataExchange* pDX,
CString const& value,
int nChars);
パラメーター
Pdx
CDataExchange オブジェクトを指すポインターです。 フレームワークは、データ交換のコンテキスト (交換方向を含みます) を確定するためにこのオブジェクトを提供します。
value
データが検証されるダイアログ ボックス、フォーム ビュー、またはコントロール ビュー オブジェクトのメンバー変数への参照。
nChars
使用できる最大文字数。
解説
DDV の詳細については、「ダイアログ データ交換と検証」を参照してください。
必要条件
ヘッダー afxdd_.h
DDV_MinMaxByte
値に関連付けられているコントロールの値が minVal と maxVal の間にあることを確認する呼び出しDDV_MinMaxByte。
void AFXAPI DDV_MinMaxByte(
CDataExchange* pDX,
BYTE value,
BYTE minVal,
BYTE maxVal);
パラメーター
Pdx
CDataExchange オブジェクトを指すポインターです。 フレームワークは、データ交換のコンテキスト (交換方向を含みます) を確定するためにこのオブジェクトを提供します。
value
データが検証されるダイアログ ボックス、フォーム ビュー、またはコントロール ビュー オブジェクトのメンバー変数への参照。
minVal
使用できる最小値 (BYTE 型)。
maxVal
使用できる最大値 (BYTE 型)。
解説
DDV の詳細については、「ダイアログ データ交換と検証」を参照してください。
必要条件
ヘッダー afxdd_.h
DDV_MinMaxDateTime
refValue に関連付けられた日付と時刻の選択コントロール (CDateTimeCtrl) の時刻/日付値が refMinRange と refMaxRange の間にあることを確認する呼び出DDV_MinMaxDateTimeし。
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
値に関連付けられているコントロールの値が minVal と maxVal の間にあることを確認する呼び出しDDV_MinMaxDouble。
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
値に関連付けられているコントロールの値が minVal と maxVal の間にあることを確認する呼び出しDDV_MinMaxDWord。
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
値に関連付けられているコントロールの値が minVal と maxVal の間にあることを確認する呼び出しDDV_MinMaxFloat。
void AFXAPI DDV_MinMaxFloat(
CDataExchange* pDX,
float value,
float minVal,
float maxVal);
パラメーター
Pdx
CDataExchange オブジェクトを指すポインターです。 フレームワークは、データ交換のコンテキスト (交換方向を含みます) を確定するためにこのオブジェクトを提供します。
value
データが検証されるダイアログ ボックス、フォーム ビュー、またはコントロール ビュー オブジェクトのメンバー変数への参照。
minVal
最小値 (型 float) を指定できます。
maxVal
最大値 (型 float) を使用できます。
解説
DDV の詳細については、「ダイアログ データ交換と検証」を参照してください。
必要条件
ヘッダー afxdd_.h
DDV_MinMaxInt
値に関連付けられているコントロールの値が minVal と maxVal の間にあることを確認する呼び出しDDV_MinMaxInt。
void AFXAPI DDV_MinMaxInt(
CDataExchange* pDX,
int value,
int minVal,
int maxVal);
パラメーター
Pdx
CDataExchange オブジェクトを指すポインターです。 フレームワークは、データ交換のコンテキスト (交換方向を含みます) を確定するためにこのオブジェクトを提供します。
value
データが検証されるダイアログ ボックス、フォーム ビュー、またはコントロール ビュー オブジェクトのメンバー変数への参照。
minVal
最小値 (型 int) を指定できます。
maxVal
最大値 (型 int) を使用できます。
解説
DDV の詳細については、「ダイアログ データ交換と検証」を参照してください。
必要条件
ヘッダー afxdd_.h
DDV_MinMaxLong
値に関連付けられているコントロールの値が minVal と maxVal の間にあることを確認する呼び出しDDV_MinMaxLong。
void AFXAPI DDV_MinMaxLong(
CDataExchange* pDX,
long value,
long minVal,
long maxVal);
パラメーター
Pdx
CDataExchange オブジェクトを指すポインターです。 フレームワークは、データ交換のコンテキスト (交換方向を含みます) を確定するためにこのオブジェクトを提供します。
value
データが検証されるダイアログ ボックス、フォーム ビュー、またはコントロール ビュー オブジェクトのメンバー変数への参照。
minVal
最小値 (型 long) を指定できます。
maxVal
最大値 (型 long) を使用できます。
解説
DDV の詳細については、「ダイアログ データ交換と検証」を参照してください。
必要条件
ヘッダー afxdd_.h
DDV_MinMaxLongLong
値に関連付けられているコントロールの値が minVal と maxVal の間にあることを確認する呼び出しDDV_MinMaxLongLong。
void AFXAPI DDV_MinMaxLongLong(
CDataExchange* pDX,
LONGLONG value,
LONGLONG minVal,
LONGLONG maxVal);
パラメーター
Pdx
CDataExchange オブジェクトを指すポインターです。 フレームワークは、データ交換のコンテキスト (交換方向を含みます) を確定するためにこのオブジェクトを提供します。
value
データが検証されるダイアログ ボックス、フォーム ビュー、またはコントロール ビュー オブジェクトのメンバー変数への参照。
minVal
使用できる最小値 (LONGLONG 型)。
maxVal
許可される最大値 (LONGLONG 型)。
解説
DDV の詳細については、「ダイアログ データ交換と検証」を参照してください。
必要条件
ヘッダー afxdd_.h
DDV_MinMaxMonth
refValue に関連付けられた月カレンダー コントロール (CMonthCalCtrl) の時刻/日付値が refMinRange と refMaxRange の間にあることを確認する呼び出DDV_MinMaxMonthし。
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
値に関連付けられているコントロールの値が minVal と maxVal の間にあることを確認する呼び出しDDV_MinMaxShort。
void AFXAPI DDV_MinMaxShort(
CDataExchange* pDX,
short value,
short minVal,
short maxVal);
パラメーター
Pdx
CDataExchange オブジェクトを指すポインターです。 フレームワークは、データ交換のコンテキスト (交換方向を含みます) を確定するためにこのオブジェクトを提供します。
value
データが検証されるダイアログ ボックス、フォーム ビュー、またはコントロール ビュー オブジェクトのメンバー変数への参照。
minVal
最小値 (型 short) を指定できます。
maxVal
最大値 (型 short) を使用できます。
解説
DDV の詳細については、「ダイアログ データ交換と検証」を参照してください。
必要条件
ヘッダー afxdd_.h
DDV_MinMaxSlider
値に関連付けられているコントロールの値が minVal と maxVal の間にあることを確認する呼び出しDDV_MinMaxSlider。
void AFXAPI DDV_MinMaxSlider(
CDataExchange* pDX,
DWORD value,
DWORD minVal,
DWORD maxVal);
パラメーター
Pdx
CDataExchange オブジェクトへのポインター。 フレームワークは、データ交換のコンテキスト (交換方向を含みます) を確定するためにこのオブジェクトを提供します。
value
検証する値への参照。 このパラメーターは、スライダー コントロールの現在のサム位置を保持または設定します。
minVal
最小値を使用できます。
maxVal
許容される最大値。
解説
DDV の詳細については、「ダイアログ データ交換と検証」を参照してください。 スライダー コントロールの詳細については、「CSliderCtrl の使用」を参照してください。
必要条件
ヘッダー afxdd_.h
DDV_MinMaxUInt
値に関連付けられているコントロールの値が minVal と maxVal の間にあることを確認する呼び出しDDV_MinMaxUInt。
void AFXAPI DDV_MinMaxUInt(
CDataExchange* pDX,
UINT value,
UINT minVal,
UINT maxVal);
パラメーター
Pdx
CDataExchange オブジェクトを指すポインターです。 フレームワークは、データ交換のコンテキスト (交換方向を含みます) を確定するためにこのオブジェクトを提供します。
value
データが検証されるダイアログ ボックス、フォーム ビュー、またはコントロール ビュー オブジェクトのメンバー変数への参照。
minVal
使用できる最小値 (UINT 型)。
maxVal
許容される最大値 (UINT 型)。
解説
DDV の詳細については、「ダイアログ データ交換と検証」を参照してください。
必要条件
ヘッダー afxdd_.h
DDV_MinMaxULongLong
値に関連付けられているコントロールの値が minVal と maxVal の間にあることを確認する呼び出しDDV_MinMaxULongLong。
void AFXAPI DDV_MinMaxULongLong(
CDataExchange* pDX,
ULONGLONG value,
ULONGLONG minVal ,
ULONGLONG maxVal);
パラメーター
Pdx
CDataExchange オブジェクトを指すポインターです。 フレームワークは、データ交換のコンテキスト (交換方向を含みます) を確定するためにこのオブジェクトを提供します。
value
データが検証されるダイアログ ボックス、フォーム ビュー、またはコントロール ビュー オブジェクトのメンバー変数への参照。
minVal
最小値 (ULONGLONG 型) を使用できます。
maxVal
許容される最大値 (ULONGLONG 型)。
解説
DDV の詳細については、「ダイアログ データ交換と検証」を参照してください。
必要条件
ヘッダー afxdd_.h
DDV_MinMaxUnsigned
値に関連付けられているコントロールの値が minVal と maxVal の間にあることを確認する呼び出しDDV_MinMaxUnsigned。
構文
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
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示