CWnd::DoDataExchange

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

ダイアログデータの交換と有効性チェックのためにフレームワークが呼び出します。

virtual void DoDataExchange(
   CDataExchange* pDX 
);

パラメータ

pDX
CDataExchange オブジェクトへのポインタ。

解説

この関数は直接呼び出さないでください。この関数は UpdateData メンバ関数から呼び出されます。ダイアログボックスのコントロールを初期化する、またはダイアログボックスからデータを取得するには UpdateData を呼び出してください。

CDialog クラスからアプリケーション固有のクラスを派生したとき、この関数をオーバーライドすると、フレームワークの自動的なデータ交換および有効性チェックを利用できます。Add Variable ウィザードは、このメンバ関数のオーバーライドしたバージョンを書き込みます。オーバーライドされたメンバ関数には、DDX (ダイアログデータエクスチェンジ) および DDV (ダイアログデータバリデーション) のグローバル関数呼び出しの "データマップ" が含まれます。

このメンバ関数のオーバーライドバージョンを自動的に生成するためには、まずダイアログエディタを使ってダイアログリソースを作成します。それから、アプリケーション固有のダイアログクラスを派生します。さらに Add Variable ウィザードを使用して、変数、データ、正当性チックの範囲を新しいダイアログボックスの各種コントロールに関連付けます。次に、Add Variable ウィザードは、オーバーライドされた DoDataExchange を書き込みます。DoDataExchange には、データマップが含まれています。Add Variable ウィザードが生成する DDX/DDV のコードブロックの例を次に示します。

void CPenWidthsDlg::DoDataExchange(CDataExchange* pDX)
{
   CDialog::DoDataExchange(pDX);
   DDX_Text(pDX, IDC_THINPENWIDTH, m_nThinWidth);
    DDV_MinMaxInt(pDX, m_nThinWidth, 1, 20);
   DDX_Text(pDX, IDC_THICKPENWIDTH, m_nThickWidth);
   DDV_MinMaxInt(pDX, m_nThickWidth, 1, 20);
}

オーバーライドされた DoDataExchange メンバ関数は、ソースファイルでマクロステートメントよりも先に来る必要があります。

ダイアログデータエクスチェンジおよびダイアログデータバリデーションに関する詳細については、「フォームでのデータの表示と操作」および「ダイアログデータエクスチェンジとダイアログデータバリデーション」を参照してください。Add Variable ウィザードで生成される DDX_ マクロおよび DDV_ マクロの説明については、「テクニカルノート 26: DDX ルーチンおよび DDV ルーチン」を参照してください。