DDX_FieldText

Artigo
08/25/2010

The DDX_FieldText função gerencia a transferência de int, curto, longo, DWORD, CString, float, duplo, BOOL, ou BYTE dados entre um controle de 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 CDataExchange objeto.A estrutura fornece esse objeto para estabelecer o contexto de troca de dados, inclusive sua direção.
nIDC
A ID de um controle no CRecordView or CDaoRecordView objeto.
Valor
Uma referência a um membro de dados do campo no associado CRecordset ou CDaoRecordset objeto. O tipo de dados do valor depende de qual das versões sobrecarregadas do DDX_FieldText use.
pRecordset
Um ponteiro para o CRecordset or CDaoRecordset objeto com o qual os dados são trocados. Permite que esse ponteiroDDX_FieldText para detectar e conjunto valores nulo.

Comentários

For CDaoRecordset objects, DDX_FieldText também gerencia a transferência COleDateTime, and COleCurrency valores.Um controle de caixa de edição vazia indica um valor nulo.Em uma transferência do conjunto de registros para o controle, se o campo de conjunto de registros for nulo, a caixa de edição será definida para vazia.Em uma transferência de controle de conjunto de registros, se o controle estiver vazio, o campo de conjunto de registros é definido como nulo.

Usar as versões com CRecordset parâmetros se você estiver trabalhando com as classes de ODBC.Usar 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 mais informações sobre DDX para e exemplosCRecordView and CDaoRecordView campos, consulte o artigo Modos de exibição do registro.

Exemplo

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