DDX_FieldText

Article
03/04/2013

La fonction d' DDX_FieldText gère la migration d' int, de short, de long, d' DWORD, de CString, de float, de double, les données de BOOL, ou de BYTE entre un contrôle de zone d'édition et les données membres de champ d'un recordset.

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

Paramètres

pDX
Un pointeur vers un objet de CDataExchange .L'infrastructure fournit cet objet pour générer le contexte de l'échange de données, y compris sa direction.
nIDC
L'ID d'un contrôle dans l'objet de CRecordView ou de CDaoRecordView .
correspondante
Une référence à des données membres de champ dans CRecordset ou l'objet associé d' CDaoRecordset .Le type de données valeur dépend de laquelle des versions surchargées d' DDX_FieldText vous utilisez.
pRecordset
Pointeur vers l'objet de CRecordset ou de CDaoRecordset avec lequel les données sont échangées.Ce pointeur permet à DDX_FieldText pour détecter et définir des valeurs NULL.

Notes

Pour les objets de CDaoRecordset , DDX_FieldText gère également transférer COleDateTime, et les valeurs de COleCurrency .Un contrôle vide de la zone d'édition indique une valeur NULL.Sur un transfert du recordset au contrôle, si le champ de recordset est null, la zone d'édition est définie pour purger.Sur un transfert de contrôle au recordset, si le contrôle est vide, le champ de recordset a la valeur null.

Utilisez les versions avec les paramètres de CRecordset si vous utilisez les classes ODBC.Utilisez les versions avec les paramètres de CDaoRecordset si vous utilisez les classes DAO.

Pour plus d'informations sur DDX, consultez Échange et validation de données de boîtes de dialogue.Pour obtenir des exemples et des informations sur le mécanisme DDX des champs de CRecordView et de CDaoRecordView , consultez l'article vues des enregistrements.

Exemple

La fonction suivante d' DoDataExchange pour CRecordView contient des appels de fonction d' DDX_FieldText pour trois types de données : IDC_COURSELIST est une zone de liste déroulante ; les deux autres contrôles sont des zones d'édition.Pour DAO programmation, le paramètre de m_pSet est un pointeur vers 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);
}