DDX_LBString

2011-08-09

ダイアログボックス、フォームビュー、コントロールビューの各オブジェクトのチェックボックスコントロールと、これらのオブジェクトの CString 型データメンバーの間の CString 型データ転送を管理します。

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

パラメーター

pDX
CDataExchange オブジェクトへのポインター。フレームワークは、データ交換のコンテキストと交換方向を確定するためにこのオブジェクトを設定します。
nIDC
コントロールプロパティに関連付けられたリストボックスコントロールのリソース ID。
値
データの交換相手になるダイアログボックス、フォームビュー、コントロールビューの各オブジェクトのメンバー変数への参照。

解説

リストボックスコントロールへのデータ転送で DDX_LBString が呼び出されると、コントロール内で先頭が value に一致する最初のアイテムが選択されます。先頭だけでなくアイテム全体を一致させるには、DDX_LBStringExact を使用します。一致しない場合は、アイテムは選択されません。一致では、大文字と小文字は区別されません。

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

注意

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

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