DDX_FieldText

Artigo
06/10/2015

A função de DDX_FieldText gerencia a transferência de int, de short, de long, de DWORD, de CString, de float, de double, de BOOL, ou de dados de BYTE entre um controle da caixa de edição e os membros de dados do campo de um conjunto de registros.

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  
);

Parâmetros

pDX
Um ponteiro para um objeto de CDataExchange . A estrutura fornece esse objeto para estabelecer o contexto de troca de dados, inclusive sua direção.
nIDC
A ID de um controle no objeto de CRecordView ou de CDaoRecordView .
valor
Uma referência a um membro de dados do campo em CRecordset ou objeto associado de CDaoRecordset . O tipo de dados de valor depende de qual das versões sobrecarregadas de DDX_FieldText você usa.
pRecordset
Um ponteiro para o objeto de CRecordset ou de CDaoRecordset com que os dados são trocados. Esse ponteiro habilita DDX_FieldText para detectar e definir valores nulos.

Comentários

Para objetos de CDaoRecordset , DDX_FieldText também gerencia transferir COleDateTime, e os valores de COleCurrency . Um controle vazia da caixa de edição indica um valor nulo. Em uma transferência do conjunto de registros ao controle, se o campo do conjunto de registros for nulo, a caixa de edição é definida para esvaziar. Em uma transferência de controle ao conjunto de registros, se o controle está vazia, o campo do conjunto de registros é definido como nulo.

Use as versões com parâmetros de CRecordset se você estiver trabalhando com as classes com base em log. Use as versões com parâmetros de CDaoRecordset se você estiver trabalhando com as classes baseadas DAO-.

Para obter mais informações sobre como DDX, consulte Caixa de diálogo troca de dados e validação. Para obter exemplos e mais informações sobre DDX para CRecordView e campos de CDaoRecordView , consulte o artigo Exibições do registro.

Exemplo

A seguinte função de DoDataExchange para CRecordView contém as chamadas de função de DDX_FieldText para três tipos de dados: IDC_COURSELIST é uma caixa de combinação; outros dois controles são caixas de edição. Para programação de DAO, o parâmetro de m_pSet é um ponteiro para CRecordset ou a 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);
}