DDX_FieldText

Статья
06/10/2015

Функция DDX_FieldText управляет передачей int, short, long, DWORD, CString, плавающее, 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.
значение
Ссылка на элемент поля данных в связанных CRecordset или объекта CDaoRecordset. Тип данных значение зависит от того, какой из перегруженных версий DDX_FieldText используется.
pRecordset
Указатель на объект CRecordset или CDaoRecordset, с которым данные обменян. Этот указатель позволяет DDX_FieldText обнаружения и задать значения NULL.

Заметки

Для объектов CDaoRecordset, DDX_FieldText также управляет передачи значения COleDateTime и COleCurrency. Пустой элемент управления поля ввода отображает значение NULL. Для передачи из набора записей к элементу управления, если поле набора записей NULL, поле ввода имеет пустым. При передаче от элемента управления к набору записей, если элемент управления не пусто, то поле набора записей имеет значение NULL.

Используйте версии с параметрами CRecordset при работе с классами ODBC- зависимости. Используйте версии с параметрами CDaoRecordset при работе с классами DAO- зависимости.

Дополнительные сведения об обмене данными в диалоговых окнах см. в разделе Обмен и проверка данных в диалоговых окнах. Примеры и дополнительные сведения об обмене данными в диалоговых окнах CRecordView и CDaoRecordView для полей см. в статье Представления записей.

Пример

Следующая функция 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);
}