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

  • [アーティクル]

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

注意

標準ダイアログ データ交換ルーチンは、ヘッダー ファイル afxdd_.hで定義されます。 ただし、アプリケーションには次のものが含まれている afxwin.h必要があります。

DDX 関数

名前 説明
DDX_CBIndex コンボ ボックス コントロールの現在の選択範囲のインデックスを初期化または取得します。
DDX_CBString コンボ ボックス コントロールの編集フィールドの現在の内容を初期化または取得します。
DDX_CBStringExact コンボ ボックス コントロールの編集フィールドの現在の内容を初期化または取得します。
DDX_Check チェック ボックス コントロールの現在の状態を初期化または取得します。
DDX_Control ダイアログ ボックス内の特定のコントロールをサブクラス化します。
DDX_DateTimeCtrl 日付と時刻の選択コントロールの日付と時刻のデータを初期化または取得します。
DDX_IPAddress IP アドレス コントロールの現在の値を初期化または取得します。
DDX_LBIndex リスト ボックス コントロールの現在の選択範囲のインデックスを初期化または取得します。
DDX_LBString リスト ボックス コントロール内の現在の選択範囲を初期化または取得します。
DDX_LBStringExact リスト ボックス コントロール内の現在の選択範囲を初期化または取得します。
DDX_ManagedControl コントロールのリソース ID に一致する .NET コントロールを作成します。
DDX_MonthCalCtrl 月の予定表コントロールの現在の値を初期化または取得します。
DDX_Radio 無線コントロール グループ内で現在チェックされている無線コントロールの 0 から始まるインデックスを初期化または取得します。
DDX_Scroll スクロール コントロールのサムの現在位置を初期化または取得します。
DDX_Slider スライダー コントロールのサムの現在位置を初期化または取得します。
DDX_Text 編集コントロールの現在の値を初期化または取得します。

DDX_CBIndex

この関数は DDX_CBIndex 、ダイアログ ボックス、フォーム ビュー、またはコントロール ビュー オブジェクト内の int コンボ ボックス コントロールと int 、ダイアログ ボックス、フォーム ビュー、またはコントロール ビュー オブジェクトのデータ メンバー間のデータの転送を管理します。

void AFXAPI DDX_CBIndex(
    CDataExchange* pDX,
    int nIDC,
    int& index);

パラメーター

pDX
CDataExchange オブジェクトを指すポインターです。 フレームワークは、データ交換のコンテキスト (交換方向を含みます) を確定するためにこのオブジェクトを提供します。

nIDC
コントロール プロパティに関連付けられているコンボ ボックス コントロールのリソース ID。

index
データを交換するダイアログ ボックス、フォーム ビュー、またはコントロール ビュー オブジェクトのメンバー変数への参照。

注釈

呼び出されると DDX_CBIndex 、 index 現在のコンボ ボックスの選択範囲のインデックスに設定されます。 項目が選択されていない場合は、 index 0 に設定されます。

DDX の詳細については、「 ダイアログ データ エクスチェンジとダイアログ データ バリデーション」を参照してください。

要件

ヘッダーafxdd_.h

DDX_CBString

この関数は DDX_CBString 、ダイアログ ボックス、 CString フォーム ビュー、またはコントロール ビュー オブジェクトのコンボ ボックス コントロールの編集コントロールと CString 、ダイアログ ボックス、フォーム ビュー、またはコントロール ビュー オブジェクトのデータ メンバー間のデータの転送を管理します。

void AFXAPI DDX_CBString(
    CDataExchange* pDX,
    int nIDC,
    CString& value);

パラメーター

pDX
CDataExchange オブジェクトを指すポインターです。 フレームワークは、データ交換のコンテキスト (交換方向を含みます) を確定するためにこのオブジェクトを提供します。

nIDC
コントロール プロパティに関連付けられているコンボ ボックス コントロールのリソース ID。

value
データを交換するダイアログ ボックス、フォーム ビュー、またはコントロール ビュー オブジェクトのメンバー変数への参照。

注釈

呼び出されると DDX_CBString 、 value 現在のコンボ ボックスの選択に設定されます。 項目が選択されていない場合は、 value 長さが 0 の文字列に設定されます。

注意

コンボ ボックスがドロップダウン リスト ボックスの場合、交換される値は 255 文字に制限されます。

DDX の詳細については、「 ダイアログ データ エクスチェンジとダイアログ データ バリデーション」を参照してください。

要件

ヘッダーafxdd_.h

DDX_CBStringExact

この関数は DDX_CBStringExact 、ダイアログ ボックス、 CString フォーム ビュー、またはコントロール ビュー オブジェクトのコンボ ボックス コントロールの編集コントロールと CString 、ダイアログ ボックス、フォーム ビュー、またはコントロール ビュー オブジェクトのデータ メンバー間のデータの転送を管理します。

void AFXAPI DDX_CBStringExact(
    CDataExchange* pDX,
    int nIDC,
    CString& value);

パラメーター

pDX
CDataExchange オブジェクトを指すポインターです。 フレームワークは、データ交換のコンテキスト (交換方向を含みます) を確定するためにこのオブジェクトを提供します。

nIDC
コントロール プロパティに関連付けられているコンボ ボックス コントロールのリソース ID。

value
データを交換するダイアログ ボックス、フォーム ビュー、またはコントロール ビュー オブジェクトのメンバー変数への参照。

注釈

呼び出されると DDX_CBStringExact 、 value 現在のコンボ ボックスの選択に設定されます。 項目が選択されていない場合は、 value 長さが 0 の文字列に設定されます。

注意

コンボ ボックスがドロップダウン リスト ボックスの場合、交換される値は 255 文字に制限されます。

DDX の詳細については、「 ダイアログ データ エクスチェンジとダイアログ データ バリデーション」を参照してください。

要件

ヘッダーafxdd_.h

DDX_Check

この関数は DDX_Check 、ダイアログ ボックス、 int フォーム ビュー、コントロール ビュー オブジェクトのチェック ボックス コントロールと int 、ダイアログ ボックス、フォーム ビュー、またはコントロール ビュー オブジェクトのデータ メンバー間のデータの転送を管理します。

void AFXAPI DDX_Check(
    CDataExchange* pDX,
    int nIDC,
    int& value);

パラメーター

pDX
CDataExchange オブジェクトを指すポインターです。 フレームワークは、データ交換のコンテキスト (交換方向を含みます) を確定するためにこのオブジェクトを提供します。

nIDC
コントロール プロパティに関連付けられているチェック ボックス コントロールのリソース ID。

value
データを交換するダイアログ ボックス、フォーム ビュー、またはコントロール ビュー オブジェクトのメンバー変数への参照。

注釈

呼び出されると DDX_Check 、 value チェック ボックス コントロールの現在の状態に設定されます。 使用可能な状態値の一覧については、Windows SDK を参照してくださいBM_GETCHECK。

DDX の詳細については、「 ダイアログ データ エクスチェンジとダイアログ データ バリデーション」を参照してください。

要件

ヘッダーafxdd_.h

DDX_Control

この関数は DDX_Control 、ダイアログ ボックス、フォーム ビュー、またはコントロール ビュー オブジェクトで指定された nIDCコントロールをサブクラス化します。

void AFXAPI DDX_Control(
    CDataExchange* pDX,
    int nIDC,
    CWnd& rControl);

パラメーター

pDX
CDataExchange オブジェクトを指すポインターです。

nIDC
サブクラス化するコントロールのリソース ID。

rControl
指定したコントロールに関連するダイアログ ボックス、フォーム ビュー、またはコントロール ビュー オブジェクトのメンバー変数への参照。

注釈

オブジェクトは pDX 、関数が呼び出されたときに DoDataExchange フレームワークによって提供されます。 したがって、 DDX_Control オーバーライド内 DoDataExchangeでのみ呼び出す必要があります。

DDX の詳細については、「 ダイアログ データ エクスチェンジとダイアログ データ バリデーション」を参照してください。

要件

ヘッダーafxdd_.h

DDX_DateTimeCtrl

この関数はDDX_DateTimeCtrl、ダイアログ ボックスまたはフォーム ビュー オブジェクト内の日付と時刻の選択コントロール ( CDateTimeCtrl) と、ダイアログ ボックスまたはフォーム ビュー オブジェクトCTimeCOleDateTimeのデータ メンバーとの間で、日付と時刻のデータの転送を管理します。

void AFXAPI DDX_DateTimeCtrl(
    CDataExchange* pDX,
    int nIDC,
    CTime& value);

void AFXAPI DDX_DateTimeCtrl(
    CDataExchange* pDX,
    int nIDC,
    COleDateTime& value);

void AFXAPI DDX_DateTimeCtrl(
    CDataExchange* pDX,
    int nIDC,
    CString& value);

パラメーター

pDX
CDataExchange オブジェクトを指すポインターです。 フレームワークは、データ交換のコンテキスト (交換方向を含みます) を確定するためにこのオブジェクトを提供します。 このオブジェクトを削除する必要はありません。

nIDC
メンバー変数に関連付けられている日付と時刻の選択コントロールのリソース ID。

value
最初の 2 つのバージョンでは、データを交換する a CTime または COleDateTime メンバー変数、ダイアログ ボックス、フォーム ビュー、またはコントロール ビュー オブジェクトへの参照。 3 番目のバージョンでは、データ メンバー コントロール ビュー オブジェクトへの CString 参照。

注釈

いつ DDX_DateTimeCtrl 呼び出されるか、 value 日付と時刻の選択コントロールの現在の状態に設定されるか、またはコントロールが 、交換の方向に応じて 、に設定 valueされます。

上記の 3 番目のバージョンでは、DDX_DateTimeCtrl日付時刻コントロールとCStringコントロール ビュー オブジェクトのCStringデータ メンバー間のデータの転送を管理します。 文字列は、日付と時刻を書式設定するための現在のロケールの規則を使用して書式設定されます。

DDX の詳細については、「 ダイアログ データ エクスチェンジとダイアログ データ バリデーション」を参照してください。

要件

ヘッダーafxdd_.h

DDX_ManagedControl

コントロールのリソース ID に一致する .NET コントロールを作成します。

構文

template <typename T>
void DDX_ManagedControl(
   CDataExchange* pDX,
   int nIDC,
   CWinFormsControl<T>& control );

パラメーター

pDX
クラス オブジェクトへのCDataExchangeポインター。 フレームワークは、データ交換のコンテキスト (交換方向を含みます) を確定するためにこのオブジェクトを提供します。

nIDC
コントロール プロパティに関連付けられているコントロールのリソース ID。

control
Class オブジェクトへのCWinFormsControl参照。

注釈

DDX_ManagedControl リソース コントロール ID と一致するコントロールを作成するための呼び出し CWinFormsControl::CreateManagedControl 。 でリソース ID からコントロールを作成するために使用 DDX_ManagedControl します CDialog::OnInitDialog。 データ交換の場合、Windows フォームコントロールで DDX/DDV 関数を使用する必要はありません。

詳細については、「方法: Windows フォームを使用して DDX/DDV データ バインディングを実行する」を参照してください。

要件

ヘッダー:afxwinforms.h

DDX_IPAddress

この関数は DDX_IPAddress 、IP アドレス コントロールとコントロール ビュー オブジェクトのデータ メンバー間のデータ転送を管理します。

void AFXAPI DDX_IPAddress(
    CDataExchange* pDX,
    int nIDC,
    DWORD& value);

パラメーター

pDX
CDataExchange オブジェクトを指すポインターです。 フレームワークは、データ交換のコンテキスト (交換方向を含みます) を確定するためにこのオブジェクトを提供します。

nIDC
コントロール プロパティに関連付けられている IP アドレス コントロールのリソース ID。

value
IP アドレス コントロールの DWORD 4 フィールド値を含む参照。 フィールドは、次のように入力または読み取られます。

フィールド フィールド値を含むビット
3 0 から 7
2 8 ~ 15
1 16 から 23
0 24 から 31

Win32 IPM_GETADDRESS を使用して値を読み取るか、値を入力するために使用 IPM_SETADDRESS します。 これらのメッセージについては、Windows SDK で説明します。

注釈

呼び出されると DDX_IPAddress 、 value IP アドレス コントロールから読み取るか、または value 交換の方向に応じてコントロールに書き込まれます。

DDX の詳細については、「 ダイアログ データ エクスチェンジとダイアログ データ バリデーション」を参照してください。

要件

ヘッダーafxdd_.h

DDX_LBIndex

この関数は DDX_LBIndex 、ダイアログ ボックス、フォーム ビュー、またはコントロール ビュー オブジェクト内の int リスト ボックス コントロールと int 、ダイアログ ボックス、フォーム ビュー、またはコントロール ビュー オブジェクトのデータ メンバー間のデータの転送を管理します。

void AFXAPI DDX_LBIndex(
    CDataExchange* pDX,
    int nIDC,
    int& index);

パラメーター

pDX
CDataExchange オブジェクトを指すポインターです。 フレームワークは、データ交換のコンテキスト (交換方向を含みます) を確定するためにこのオブジェクトを提供します。

nIDC
コントロール プロパティに関連付けられているリスト ボックス コントロールのリソース ID。

index
データを交換するダイアログ ボックス、フォーム ビュー、またはコントロール ビュー オブジェクトのメンバー変数への参照。

注釈

呼び出されると DDX_LBIndex 、 index 現在のリスト ボックス選択のインデックスに設定されます。 項目が選択されていない場合は、 index -1 に設定されます。

DDX の詳細については、「 ダイアログ データ エクスチェンジとダイアログ データ バリデーション」を参照してください。

要件

ヘッダーafxdd_.h

DDX_LBString

この関数は DDX_LBString 、ダイアログ ボックス、 CString フォーム ビュー、またはコントロール ビュー オブジェクトのリスト ボックス コントロールと CString 、ダイアログ ボックス、フォーム ビュー、またはコントロール ビュー オブジェクトのデータ メンバー間のデータの転送を管理します。

void AFXAPI DDX_LBString(
    CDataExchange* pDX,
    int nIDC,
    CString& value);

パラメーター

pDX
CDataExchange オブジェクトを指すポインターです。 フレームワークは、データ交換のコンテキスト (交換方向を含みます) を確定するためにこのオブジェクトを提供します。

nIDC
コントロール プロパティに関連付けられているリスト ボックス コントロールのリソース ID。

value
データを交換するダイアログ ボックス、フォーム ビュー、またはコントロール ビュー オブジェクトのメンバー変数への参照。

注釈

リスト ボックス コントロールにデータを転送するために呼び出されると DDX_LBString 、最初に一致するコントロール内の最初の value 項目が選択されます。 (単なるプレフィックスではなく項目全体に一致するには、.) を使用 DDX_LBStringExactします。一致するものがない場合、項目は選択されません。 照合では、大文字と小文字は区別されません。

DDX_LBStringリスト ボックス コントロールからデータを転送するために呼び出されると、value現在のリスト ボックスの選択に設定されます。 項目が選択されていない場合は、 value 長さが 0 の文字列に設定されます。

注意

リスト ボックスがドロップダウン リスト ボックスの場合、交換される値は 255 文字に制限されます。

DDX の詳細については、「 ダイアログ データ エクスチェンジとダイアログ データ バリデーション」を参照してください。

要件

ヘッダーafxdd_.h

DDX_LBStringExact

この関数は DDX_CBStringExact 、ダイアログ ボックス、 CString フォーム ビュー、またはコントロール ビュー オブジェクトのリスト ボックス コントロールの編集コントロールと CString 、ダイアログ ボックス、フォーム ビュー、またはコントロール ビュー オブジェクトのデータ メンバー間のデータの転送を管理します。

void AFXAPI DDX_LBStringExact(
    CDataExchange* pDX,
    int nIDC,
    CString& value);

パラメーター

pDX
CDataExchange オブジェクトを指すポインターです。 フレームワークは、データ交換のコンテキスト (交換方向を含みます) を確定するためにこのオブジェクトを提供します。

nIDC
コントロール プロパティに関連付けられているリスト ボックス コントロールのリソース ID。

value
データを交換するダイアログ ボックス、フォーム ビュー、またはコントロール ビュー オブジェクトのメンバー変数への参照。

注釈

リスト ボックス コントロールにデータを転送するために呼び出されると DDX_LBStringExact 、一致するコントロールの最初の value 項目が選択されます。 (項目全体ではなくプレフィックスのみに一致するには、.) を使用 DDX_LBStringします。一致するものがない場合、項目は選択されません。 照合では、大文字と小文字は区別されません。

DDX_CBStringExactリスト ボックス コントロールからデータを転送するために呼び出されると、value現在のリスト ボックスの選択に設定されます。 項目が選択されていない場合は、 value 長さが 0 の文字列に設定されます。

注意

リスト ボックスがドロップダウン リスト ボックスの場合、交換される値は 255 文字に制限されます。

DDX の詳細については、「 ダイアログ データ エクスチェンジとダイアログ データ バリデーション」を参照してください。

要件

ヘッダーafxdd_.h

DDX_MonthCalCtrl

この関数はDDX_MonthCalCtrl、ダイアログ ボックス、フォーム ビュー、またはコントロール ビュー オブジェクト内の月の予定表コントロール ( CMonthCalCtrl) とCTimeCOleDateTime、ダイアログ ボックス、フォーム ビュー、またはコントロール ビュー オブジェクトのデータ メンバー間の日付データの転送を管理します。

void AFXAPI DDX_MonthCalCtrl(
    CDataExchange* pDX,
    int nIDC,
    CTime& value);

void AFXAPI DDX_MonthCalCtrl(
    CDataExchange* pDX,
    int nIDC,
    COleDateTime& value);

パラメーター

pDX
CDataExchange オブジェクトを指すポインターです。 フレームワークは、データ交換のコンテキスト (交換方向を含みます) を確定するためにこのオブジェクトを提供します。 このオブジェクトを削除する必要はありません。

nIDC
メンバー変数に関連付けられている月の予定表コントロールのリソース ID。

value
データを交換するCTimeCOleDateTimeダイアログ ボックス、フォーム ビュー、またはコントロール ビュー オブジェクトのメンバー変数への参照。

注釈

注意

コントロールは日付値のみを管理します。 時刻オブジェクト内の時刻フィールドは、コントロール ウィンドウの作成時刻、またはコントロールで CMonthCalCtrl::SetCurSel設定された時刻を反映するように設定されます。

呼 DDX_MonthCalCtrl び出されると、 value 月カレンダー コントロールの現在の状態に設定されます。

DDX の詳細については、「 ダイアログ データ エクスチェンジとダイアログ データ バリデーション」を参照してください。

要件

ヘッダーafxdd_.h

DDX_Radio

この関数は DDX_Radio 、ダイアログ ボックス、フォーム ビュー、またはコントロール ビュー オブジェクト内の int 無線コントロール グループと int 、ダイアログ ボックス、フォーム ビュー、またはコントロール ビュー オブジェクトのデータ メンバー間のデータ転送を管理します。 データ メンバーの int 値は、グループ内のどのラジオ ボタンが選択されているかに応じて決定されます。

void AFXAPI DDX_Radio(
    CDataExchange* pDX,
    int nIDC,
    int& value);

パラメーター

pDX
CDataExchange オブジェクトを指すポインターです。 フレームワークは、データ交換のコンテキスト (交換方向を含みます) を確定するためにこのオブジェクトを提供します。

nIDC
グループ内の最初の無線コントロールのリソース ID。

value
データを交換するダイアログ ボックス、フォーム ビュー、またはコントロール ビュー オブジェクトのメンバー変数への参照。

注釈

呼び出されると DDX_Radio 、 value 無線制御グループの現在の状態に設定されます。 この値は、現在チェックされている無線コントロールの 0 から始まるインデックスとして設定され、無線コントロールがチェックされていない場合は -1 に設定されます。

たとえば、グループ内の最初のラジオ ボタン (WS_GROUP スタイルのボタン) がオンになっている場合、メンバーの int 値は 0 などになります。

DDX の詳細については、「 ダイアログ データ エクスチェンジとダイアログ データ バリデーション」を参照してください。

要件

ヘッダーafxdd_.h

DDX_Scroll

この関数は DDX_Scroll 、ダイアログ ボックス、フォーム ビュー、またはコントロール ビュー オブジェクト内の int スクロール バー コントロールと int 、ダイアログ ボックス、フォーム ビュー、またはコントロール ビュー オブジェクトのデータ メンバー間のデータの転送を管理します。

void AFXAPI DDX_Scroll(
    CDataExchange* pDX,
    int nIDC,
    int& value);

パラメーター

pDX
CDataExchange オブジェクトを指すポインターです。 フレームワークは、データ交換のコンテキスト (交換方向を含みます) を確定するためにこのオブジェクトを提供します。

nIDC
コントロール プロパティに関連付けられているスクロール バー コントロールのリソース ID。

value
データの交換相手になるダイアログ ボックス、フォーム ビュー、またはコントロール ビュー オブジェクトのメンバー変数への参照。

注釈

呼び出されると DDX_Scroll 、 value コントロールのサムの現在位置に設定されます。 コントロールのサムの現在の位置に関連付けられている値の詳細については、Windows SDK を参照してくださいGetScrollPos。

DDX の詳細については、「 ダイアログ データ エクスチェンジとダイアログ データ バリデーション」を参照してください。

要件

ヘッダーafxdd_.h

DDX_Slider

この関数は DDX_Slider 、ダイアログ ボックスまたはフォーム ビューの int スライダー コントロールと int 、ダイアログ ボックスまたはフォーム ビュー オブジェクトのデータ メンバー間のデータの転送を管理します。

void AFXAPI DDX_Slider(
    CDataExchange* pDX,
    int nIDC,
    int& value);

パラメーター

pDX
CDataExchange オブジェクトを指すポインターです。 フレームワークは、データ交換のコンテキスト (交換方向を含みます) を確定するためにこのオブジェクトを提供します。

nIDC
スライダー コントロールのリソース ID。

value
交換する値への参照。 このパラメーターは、スライダー コントロールの現在の位置を保持または設定します。

注釈

呼び出されると DDX_Slider 、 value コントロールのサムの現在の位置に設定されるか、交換の方向に応じて値が位置を受け取ります。

DDX の詳細については、「 ダイアログ データ エクスチェンジとダイアログ データ バリデーション」を参照してください。 スライダー コントロールの詳細については、「 使用 CSliderCtrl」を参照してください。

要件

ヘッダーafxdd_.h

DDX_Text

この関数はDDX_Text、UINTDWORDlongダイアログ ボックス、フォーム ビュー、CStringfloatまたはdoubleコントロール ビュー内のint編集コントロールとCString、ダイアログ ボックス、フォーム ビュー、またはコントロール ビュー オブジェクトのデータ メンバーとの間で、データの転送 、、を管理します。

void AFXAPI DDX_Text(
    CDataExchange* pDX,
    int nIDC,
    BYTE& value);

void AFXAPI DDX_Text(
    CDataExchange* pDX,
    int nIDC,
    short& value);

void AFXAPI DDX_Text(
    CDataExchange* pDX,
    int nIDC,
    int& value);

void AFXAPI DDX_Text(
    CDataExchange* pDX,
    int nIDC,
    UINT& value);

void AFXAPI DDX_Text(
    CDataExchange* pDX,
    int nIDC,
    long& value);

void AFXAPI DDX_Text(
    CDataExchange* pDX,
    int nIDC,
    DWORD& value);

void AFXAPI DDX_Text(
    CDataExchange* pDX,
    int nIDC,
    CString& value);

void AFXAPI DDX_Text(
    CDataExchange* pDX,
    int nIDC,
    float& value);

void AFXAPI DDX_Text(
    CDataExchange* pDX,
    int nIDC,
    double& value);

void AFXAPI DDX_Text(
    CDataExchange* pDX,
    int nIDC,
    COleCurrency& value);

void AFXAPI DDX_Text(
    CDataExchange* pDX,
    int nIDC,
    COleDateTime& value);

パラメーター

pDX
CDataExchange オブジェクトを指すポインターです。 フレームワークは、データ交換のコンテキスト (交換方向を含みます) を確定するためにこのオブジェクトを提供します。

nIDC
ダイアログ ボックス、フォーム ビュー、またはコントロール ビュー オブジェクトの編集コントロールの ID。

value
ダイアログ ボックス、フォーム ビュー、またはコントロール ビュー オブジェクト内のデータ メンバーへの参照。 データ型 value は、使用するオーバーロードされたバージョン DDX_Text によって異なります。

注釈

DDX の詳細については、「 ダイアログ データ エクスチェンジとダイアログ データ バリデーション」を参照してください。

要件

ヘッダーafxdd_.h

関連項目

標準ダイアログ データ検証ルーチン
マクロとグローバル
CWinFormsControl::CreateManagedControl
CDialog::OnInitDialog