DDX_FieldText

2011-08-09

DDX_FieldText 関数は、エディットボックスコントロールとレコードセットフィールドデータメンバーとの間での、int、short、long、DWORD、CString、float、double、BOOL、BYTE の各型のデータ転送を管理します。

void AFXAPI DDX_FieldText(
   CDataExchange* pDX,
   int nIDC,
   BYTE& value,
   CRecordset* pRecordset 
);
void AFXAPI DDX_FieldText(
   CDataExchange* pDX,
   int nIDC,
   int& value,
   CRecordset* pRecordset 
);
void AFXAPI DDX_FieldText(
   CDataExchange* pDX,
   int nIDC,
   UINT& value,
   CRecordset* pRecordset 
);
void AFXAPI DDX_FieldText(
   CDataExchange* pDX,
   int nIDC,
   long& value,
   CRecordset* pRecordset 
);
void AFXAPI DDX_FieldText(
   CDataExchange* pDX,
   int nIDC,
   DWORD& value,
   CRecordset* pRecordset 
);
void AFXAPI DDX_FieldText(
   CDataExchange* pDX,
   int nIDC,
   CString& value,
   CRecordset* pRecordset 
);
void AFXAPI DDX_FieldText(
   CDataExchange* pDX,
   int nIDC,
   float& value,
   CRecordset* pRecordset 
);
void AFXAPI DDX_FieldText(
   CDataExchange* pDX,
   int nIDC,
   double& value,
   CRecordset* pRecordset 
);
void AFXAPI DDX_FieldText(
   CDataExchange* pDX,
   int nIDC,
   short& value,
   CDaoRecordset* pRecordset 
);
void AFXAPI DDX_FieldText(
   CDataExchange* pDX,
   int nIDC,
   BOOL& value,
   CDaoRecordset* pRecordset 
);
void AFXAPI DDX_FieldText(
   CDataExchange* pDX,
   int nIDC,
   BYTE& value,
   CDaoRecordset* pRecordset 
);
void AFXAPI DDX_FieldText(
   CDataExchange* pDX,
   int nIDC,
   long& value,
   CDaoRecordset* pRecordset 
);
void AFXAPI DDX_FieldText(
   CDataExchange* pDX,
   int nIDC,
   DWORD& value,
   CDaoRecordset* pRecordset 
);
void AFXAPI DDX_FieldText(
   CDataExchange* pDX,
   int nIDC,
   CString& value,
   CDaoRecordset* pRecordset 
);
void AFXAPI DDX_FieldText(
   CDataExchange* pDX,
   int nIDC,
   float& value,
   CDaoRecordset* pRecordset 
);
void AFXAPI DDX_FieldText(
   CDataExchange* pDX,
   int nIDC,
   double& value,
   CDaoRecordset* pRecordset 
);
void AFXAPI DDX_FieldText(
   CDataExchange* pDX,
   int nIDC,
   COleDateTime& value,
   CDaoRecordset* pRecordset 
);
void AFXAPI DDX_FieldText(
   CDataExchange* pDX,
   int nIDC,
   COleCurrency& value,
   CDaoRecordset* pRecordset 
);

パラメーター

pDX
CDataExchange オブジェクトへのポインターを返します。フレームワークは、データ交換のコンテキストと交換方向を確定するためにこのオブジェクトを設定します。
nIDC
CRecordView オブジェクトまたは CDaoRecordView オブジェクト内のコントロールの ID。
値
関連する CRecordset オブジェクトまたは CDaoRecordset オブジェクトのフィールドデータメンバーへの参照。 value のデータ型は、使用するオーバーロードされた DDX_FieldText の型に依存します。
pRecordset
データの交換相手になる CRecordset オブジェクトまたは CDaoRecordset オブジェクトへのポインター。 DDX_FieldText は、このポインターを使って NULL 値を検出することも設定することもできます。

解説

CDaoRecordset オブジェクトのために、DDX_FieldText も COleDateTime と COleCurrency の値の転送を管理します。空のエディットボックスコントロールは NULL 値を示します。レコードセットからコントロールへの転送時にレコードセットフィールドが NULL であった場合、エディットボックスを空に設定します。コントロールからレコードセットへの転送時にコントロールが空であった場合は、レコードセットのフィールドに NULL を設定します。

ODBC ベースのクラスを使って作業しているときは、パラメーターに CRecordset を持つ形式を使います。 DAO ベースのクラスを使って作業しているときは、パラメーターに CDaoRecordset を持つ形式を使います。

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

使用例

次DoDataExchangeの機能をCRecordViewが含まれていますDDX_FieldText関数を呼び出して 3 つのデータ型の場合。IDC_COURSELISTコンボボックスである; 他の 2 つのコントロールは、編集ボックスです。 DAO のプログラムでは、パラメーター m_pSet が CRecordset または CDaoRecordset へのポインターになります。

void CMyDaoRecordView::DoDataExchange(CDataExchange* pDX)
{
   CDaoRecordView::DoDataExchange(pDX);
   DDX_FieldCBString(pDX, IDC_LASTNAME, m_pSet->m_LastName, m_pSet);
   DDX_FieldText(pDX, IDC_ID, m_pSet->m_EmployeeID, m_pSet);
   DDX_FieldText(pDX, IDC_AGE, m_pSet->m_Age, m_pSet);
}