DDX_FieldText

Artigo
02/25/2013

O DDX_FieldText função gerencia a transferência de int, curto, longo, DWORD, CString, float, double, BOOL, ou bytes dados entre um controle de caixa de edição e os membros de um conjunto de registros de dados do campo.

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 CDataExchange objeto.A estrutura fornece esse objeto para estabelecer o contexto da troca de dados, incluindo sua direção.
nIDC
A ID de um controle na CRecordView ou CDaoRecordView objeto.
valor
Uma referência a um membro de dados de campo no associado CRecordset ou CDaoRecordset objeto.O tipo de dados de valor depende de qual das versões sobrecarregadas do DDX_FieldText você usar.
pRecordset
Um ponteiro para o CRecordset ou CDaoRecordset objeto com o qual os dados são trocados.Esse ponteiro permite DDX_FieldText para detectar e definir valores nulos.

Comentários

Para CDaoRecordset objetos, DDX_FieldText também gerencia a transferência de COleDateTime, e COleCurrency valores.Um controle de caixa de edição vazia indica um valor nulo.Em uma transferência de conjunto de registros para o controle, se o campo de conjunto de registros for Null, a caixa de edição é definida como empty.Em uma transferência de controle de conjunto de registros, se o controle estiver vazio, o campo de conjunto de registros é definido como Null.

Use as versões com CRecordset parâmetros se você estiver trabalhando com as classes de ODBC.Use as versões com CDaoRecordset parâmetros se você estiver trabalhando com as classes de DAO.

Para obter mais informações sobre DDX, consulte caixa de diálogo dados Exchange e validação.Para obter exemplos e obter mais informações sobre DDX para CRecordView e CDaoRecordView campos, consulte o artigo Modos de exibição do registro.

Exemplo

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