DDX_FieldLBIndex

2011-08-09

DDX_FieldLBIndex 関数は、レコードビューのリストボックスコントロールで現在選択されているアイテムのインデックスと、レコードビューに関連付けられているレコードセットの int 型のフィールドデータメンバーの同期をとります。

void AFXAPI DDX_FieldLBIndex(
   CDataExchange* pDX,
   int nIDC,
   int& index,
   CRecordset* pRecordset 
);
void AFXAPI DDX_FieldLBIndex(
   CDataExchange* pDX,
   int nIDC,
   int& index,
   CDaoRecordset* pRecordset 
);

パラメーター

pDX
CDataExchange オブジェクトへのポインター。フレームワークは、データ交換のコンテキストと交換方向を確定するためにこのオブジェクトを設定します。
nIDC
CRecordView オブジェクトまたは CDaoRecordView オブジェクト内のコントロールの ID。
index
関連する CRecordset オブジェクトまたは CDaoRecordset オブジェクトのフィールドデータメンバーへの参照。
pRecordset
データの交換相手になる CRecordset オブジェクトまたは CDaoRecordset オブジェクトへのポインター。

解説

レコードセットからコントロールにデータを移動するとき、この関数は index で指定された値を基にコントロールの選択を設定します。レコードセットからコントロールへの転送時にレコードセットフィールドが NULL の場合、MFC はインデックスの値に 0 を設定します。コントロールからレコードセットへの転送時にコントロールが空の場合、レコードセットフィールドには 0 が設定されます。

ODBC ベースのクラスを使って作業しているときは、最初の形式を使います。 DAO ベースのクラスを使って作業しているときは、2 番目の形式を使います。

DDX の詳細については、「ダイアログデータエクスチェンジとダイアログデータバリデーション」を参照してください。 CRecordView と CDaoRecordView のフィールドでの DDX の例や詳細については、「レコードビュー」を参照してください。