Routines d'échange de données de boîte de dialogue standard

Cette rubrique répertorie les routines d’échange de données de dialogue standard (DDX) utilisées pour les contrôles de dialogue MFC courants.

Remarque

Les routines d’échange de données de boîte de dialogue standard sont définies dans le fichier afxdd_.hd’en-tête. Toutefois, les applications doivent inclure afxwin.h.

Fonctions DDX

Nom	Description
DDX_CBIndex	Initialise ou récupère l’index de la sélection actuelle d’un contrôle de zone de liste modifiable.
DDX_CBString	Initialise ou récupère le contenu actuel du champ d’édition d’un contrôle de zone de liste modifiable.
DDX_CBStringExact	Initialise ou récupère le contenu actuel du champ d’édition d’un contrôle de zone de liste modifiable.
DDX_Check	Initialise ou récupère l’état actuel d’un contrôle de case à cocher.
DDX_Control	Sous-classe un contrôle donné dans une boîte de dialogue.
DDX_DateTimeCtrl	Initialise ou récupère les données de date et/ou d’heure d’un contrôle de sélecteur de date et d’heure.
DDX_IPAddress	Initialise ou récupère la valeur actuelle d’un contrôle d’adresse IP.
DDX_LBIndex	Initialise ou récupère l’index de la sélection actuelle d’un contrôle de zone de liste.
DDX_LBString	Initialise ou récupère la sélection actuelle dans un contrôle de zone de liste.
DDX_LBStringExact	Initialise ou récupère la sélection actuelle dans un contrôle de zone de liste.
DDX_ManagedControl	Crée un contrôle .NET correspondant à l’ID de ressource du contrôle.
DDX_MonthCalCtrl	Initialise ou récupère la valeur actuelle d’un contrôle calendrier mensuel.
DDX_Radio	Initialise ou récupère l’index basé sur 0 du contrôle radio actuellement vérifié dans un groupe de contrôles radio.
DDX_Scroll	Initialise ou récupère la position actuelle du pouce d’un contrôle de défilement.
DDX_Slider	Initialise ou récupère la position actuelle du pouce d’un contrôle de curseur.
DDX_Text	Initialise ou récupère la valeur actuelle d’un contrôle d’édition.

DDX_CBIndex

La DDX_CBIndex fonction gère le transfert de int données entre un contrôle de zone de liste modifiable dans une boîte de dialogue, un affichage formulaire ou un objet d’affichage de contrôle et un int membre de données de la boîte de dialogue, d’un affichage de formulaire ou d’un objet d’affichage de contrôle.

void AFXAPI DDX_CBIndex(
    CDataExchange* pDX,
    int nIDC,
    int& index);

Paramètres

pDX
Pointeur vers un objet CDataExchange. L’infrastructure fournit cet objet pour établir le contexte de l’échange de données, notamment sa direction.

nIDC
ID de ressource du contrôle de zone de liste modifiable associé à la propriété de contrôle.

index
Référence à une variable membre de la boîte de dialogue, de la vue formulaire ou de l’objet de vue de contrôle avec lequel les données sont échangées.

Notes

Quand DDX_CBIndex elle est appelée, index est définie sur l’index de la sélection de la zone de liste modifiable actuelle. Si aucun élément n’est sélectionné, index est défini sur 0.

Pour plus d'informations sur DDX, consultez Échange et validation de données de boîtes de dialogue.

Spécifications

En-tête afxdd_.h

DDX_CBString

La DDX_CBString fonction gère le transfert de CString données entre le contrôle d’édition d’un contrôle de zone de liste modifiable dans une boîte de dialogue, un affichage de formulaire ou un objet d’affichage de contrôle et un CString membre de données de la boîte de dialogue, de la vue formulaire ou de l’objet d’affichage de contrôle.

void AFXAPI DDX_CBString(
    CDataExchange* pDX,
    int nIDC,
    CString& value);

Paramètres

pDX
Pointeur vers un objet CDataExchange. L’infrastructure fournit cet objet pour établir le contexte de l’échange de données, notamment sa direction.

nIDC
ID de ressource du contrôle de zone de liste modifiable associé à la propriété de contrôle.

value
Référence à une variable membre de la boîte de dialogue, de la vue formulaire ou de l’objet de vue de contrôle avec lequel les données sont échangées.

Notes

Quand DDX_CBString elle est appelée, value est définie sur la sélection de la zone de liste déroulante actuelle. Si aucun élément n’est sélectionné, value est défini sur une chaîne de longueur nulle.

Remarque

Si la zone de liste déroulante est une zone de liste déroulante, la valeur échangée est limitée à 255 caractères.

Pour plus d'informations sur DDX, consultez Échange et validation de données de boîtes de dialogue.

Spécifications

En-tête afxdd_.h

DDX_CBStringExact

La DDX_CBStringExact fonction gère le transfert de CString données entre le contrôle d’édition d’un contrôle de zone de liste modifiable dans une boîte de dialogue, un affichage de formulaire ou un objet d’affichage de contrôle et un CString membre de données de la boîte de dialogue, de la vue formulaire ou de l’objet d’affichage de contrôle.

void AFXAPI DDX_CBStringExact(
    CDataExchange* pDX,
    int nIDC,
    CString& value);

Paramètres

pDX
Pointeur vers un objet CDataExchange. L’infrastructure fournit cet objet pour établir le contexte de l’échange de données, notamment sa direction.

nIDC
ID de ressource du contrôle de zone de liste modifiable associé à la propriété de contrôle.

value
Référence à une variable membre de la boîte de dialogue, de la vue formulaire ou de l’objet de vue de contrôle avec lequel les données sont échangées.

Notes

Quand DDX_CBStringExact elle est appelée, value est définie sur la sélection de la zone de liste déroulante actuelle. Si aucun élément n’est sélectionné, value est défini sur une chaîne de longueur nulle.

Remarque

Si la zone de liste déroulante est une zone de liste déroulante, la valeur échangée est limitée à 255 caractères.

Pour plus d'informations sur DDX, consultez Échange et validation de données de boîtes de dialogue.

Spécifications

En-tête afxdd_.h

DDX_Check

La DDX_Check fonction gère le transfert de int données entre un contrôle de case à cocher dans une boîte de dialogue, une vue de formulaire ou un objet d’affichage de contrôle et un membre de données de la boîte de dialogue, d’une vue de formulaire ou d’un int objet d’affichage de contrôle.

void AFXAPI DDX_Check(
    CDataExchange* pDX,
    int nIDC,
    int& value);

Paramètres

pDX
Pointeur vers un objet CDataExchange. L’infrastructure fournit cet objet pour établir le contexte de l’échange de données, notamment sa direction.

nIDC
ID de ressource du contrôle de case à cocher associé à la propriété de contrôle.

value
Référence à une variable membre de la boîte de dialogue, de la vue formulaire ou de l’objet de vue de contrôle avec lequel les données sont échangées.

Notes

Quand DDX_Check elle est appelée, value est définie sur l’état actuel du contrôle de case à cocher. Pour obtenir la liste des valeurs d’état possibles, consultez BM_GETCHECK le Kit de développement logiciel (SDK) Windows.

Pour plus d'informations sur DDX, consultez Échange et validation de données de boîtes de dialogue.

Spécifications

En-tête afxdd_.h

DDX_Control

La DDX_Control fonction sous-classe le contrôle, spécifié par nIDC, de la boîte de dialogue, de l’affichage formulaire ou de l’objet d’affichage de contrôle.

void AFXAPI DDX_Control(
    CDataExchange* pDX,
    int nIDC,
    CWnd& rControl);

Paramètres

pDX
Pointeur vers un objet CDataExchange.

nIDC
ID de ressource du contrôle à sous-classe.

rControl
Référence à une variable membre de la boîte de dialogue, de la vue formulaire ou de l’objet d’affichage de contrôle associé au contrôle spécifié.

Notes

L’objet pDX est fourni par l’infrastructure lorsque la DoDataExchange fonction est appelée. Par conséquent, DDX_Control ne doit être appelé que dans votre remplacement de DoDataExchange.

Pour plus d'informations sur DDX, consultez Échange et validation de données de boîtes de dialogue.

Spécifications

En-tête afxdd_.h

DDX_DateTimeCtrl

La DDX_DateTimeCtrl fonction gère le transfert des données de date et/ou d’heure entre un contrôle de sélecteur de date et d’heure ( CDateTimeCtrl) dans une boîte de dialogue ou un objet d’affichage de formulaire et un ou un CTime COleDateTime membre de données de la boîte de dialogue ou de l’objet d’affichage de formulaire.

void AFXAPI DDX_DateTimeCtrl(
    CDataExchange* pDX,
    int nIDC,
    CTime& value);

void AFXAPI DDX_DateTimeCtrl(
    CDataExchange* pDX,
    int nIDC,
    COleDateTime& value);

void AFXAPI DDX_DateTimeCtrl(
    CDataExchange* pDX,
    int nIDC,
    CString& value);

Paramètres

pDX
Pointeur vers un objet CDataExchange. L’infrastructure fournit cet objet pour établir le contexte de l’échange de données, notamment sa direction. Vous n’avez pas besoin de supprimer cet objet.

nIDC
ID de ressource du contrôle sélecteur de date et d’heure associé à la variable membre.

value
Dans les deux premières versions, une référence à une variable ou COleDateTime membre, une boîte de dialogue, une CTime vue de formulaire ou un objet de vue de contrôle avec lequel les données sont échangées. Dans la troisième version, référence à un CString objet de vue de contrôle membre de données.

Notes

Lorsqu’il DDX_DateTimeCtrl est appelé, value est défini sur l’état actuel du contrôle sélecteur de date et d’heure, ou le contrôle est défini valuesur , selon la direction de l’échange.

Dans la troisième version ci-dessus, DDX_DateTimeCtrl gère le transfert de données entre un contrôle d’heure de CString date et un CString membre de données de l’objet de vue de contrôle. La chaîne est mise en forme à l’aide des règles des paramètres régionaux actuels pour mettre en forme les dates et les heures.

Pour plus d'informations sur DDX, consultez Échange et validation de données de boîtes de dialogue.

Spécifications

En-tête afxdd_.h

DDX_ManagedControl

Crée un contrôle .NET correspondant à l’ID de ressource du contrôle.

Syntaxe

template <typename T>
void DDX_ManagedControl(
   CDataExchange* pDX,
   int nIDC,
   CWinFormsControl<T>& control );

Paramètres

pDX
Pointeur vers un CDataExchange objet Class . L’infrastructure fournit cet objet pour établir le contexte de l’échange de données, notamment sa direction.

nIDC
ID de ressource du contrôle associé à la propriété de contrôle.

control
Référence à un CWinFormsControl objet Class .

Notes

DDX_ManagedControl appels CWinFormsControl::CreateManagedControl pour créer un contrôle correspondant à l’ID de contrôle de ressource. Permet DDX_ManagedControl de créer des contrôles à partir d’ID de ressource dans CDialog::OnInitDialog. Pour l’échange de données, vous n’avez pas besoin d’utiliser les fonctions DDX/DDV avec des contrôles Windows Forms.

Pour plus d’informations, consultez Guide pratique pour effectuer une liaison de données DDX/DDV avec Windows Forms.

Spécifications

En-tête: afxwinforms.h

DDX_IPAddress

La DDX_IPAddress fonction gère le transfert de données entre un contrôle d’adresse IP et un membre de données de l’objet de vue de contrôle.

void AFXAPI DDX_IPAddress(
    CDataExchange* pDX,
    int nIDC,
    DWORD& value);

Paramètres

pDX
Pointeur vers un objet CDataExchange. L’infrastructure fournit cet objet pour établir le contexte de l’échange de données, notamment sa direction.

nIDC
ID de ressource du contrôle d’adresse IP associé à la propriété de contrôle.

value
Référence à la DWORD valeur de quatre champs du contrôle d’adresse IP. Les champs sont remplis ou lus comme suit.

Champ	Bits contenant la valeur du champ
3	0 à 7
2	8 à 15
1	16 à 23
0	24 à 31

Utilisez Win32 IPM_GETADDRESS pour lire la valeur ou pour IPM_SETADDRESS remplir la valeur. Ces messages sont décrits dans le Kit de développement logiciel (SDK) Windows.

Notes

Quand DDX_IPAddress elle est appelée, value est lue à partir du contrôle d’adresse IP ou value est écrite dans le contrôle, en fonction de la direction de l’échange.

Pour plus d'informations sur DDX, consultez Échange et validation de données de boîtes de dialogue.

Spécifications

En-tête afxdd_.h

DDX_LBIndex

La DDX_LBIndex fonction gère le transfert de données entre un contrôle de zone de int liste dans une boîte de dialogue, un affichage formulaire ou un objet d’affichage de contrôle et un int membre de données de la boîte de dialogue, de la vue de formulaire ou de l’objet d’affichage de contrôle.

void AFXAPI DDX_LBIndex(
    CDataExchange* pDX,
    int nIDC,
    int& index);

Paramètres

pDX
Pointeur vers un objet CDataExchange. L’infrastructure fournit cet objet pour établir le contexte de l’échange de données, notamment sa direction.

nIDC
ID de ressource du contrôle de zone de liste associé à la propriété de contrôle.

index
Référence à une variable membre de la boîte de dialogue, de la vue formulaire ou de l’objet de vue de contrôle avec lequel les données sont échangées.

Notes

Quand DDX_LBIndex elle est appelée, index est définie sur l’index de la sélection de la zone de liste active. Si aucun élément n’est sélectionné, index est défini sur -1.

Pour plus d'informations sur DDX, consultez Échange et validation de données de boîtes de dialogue.

Spécifications

En-tête afxdd_.h

DDX_LBString

La DDX_LBString fonction gère le transfert de données entre un contrôle de zone de CString liste dans une boîte de dialogue, une vue de formulaire ou un objet d’affichage de contrôle et un CString membre de données de la boîte de dialogue, de la vue formulaire ou de l’objet d’affichage de contrôle.

void AFXAPI DDX_LBString(
    CDataExchange* pDX,
    int nIDC,
    CString& value);

Paramètres

pDX
Pointeur vers un objet CDataExchange. L’infrastructure fournit cet objet pour établir le contexte de l’échange de données, notamment sa direction.

nIDC
ID de ressource du contrôle de zone de liste associé à la propriété de contrôle.

value
Référence à une variable membre de la boîte de dialogue, de la vue formulaire ou de l’objet de vue de contrôle avec lequel les données sont échangées.

Notes

Lorsqu’il DDX_LBString est appelé pour transférer des données vers un contrôle de zone de liste, le premier élément du contrôle dont les correspondances value de début sont sélectionnées. (Pour faire correspondre l’élément entier au lieu d’un préfixe, utilisez DDX_LBStringExact.) S’il n’y a aucune correspondance, aucun élément n’est sélectionné. La correspondance n'est pas sensible à la casse.

Lorsqu’elle DDX_LBString est appelée pour transférer des données à partir d’un contrôle zone de liste, value elle est définie sur la sélection de la zone de liste actuelle. Si aucun élément n’est sélectionné, value est défini sur une chaîne de longueur nulle.

Remarque

Si la zone de liste est une zone de liste déroulante, la valeur échangée est limitée à 255 caractères.

Pour plus d'informations sur DDX, consultez Échange et validation de données de boîtes de dialogue.

Spécifications

En-tête afxdd_.h

DDX_LBStringExact

La DDX_CBStringExact fonction gère le transfert de CString données entre le contrôle d’édition d’un contrôle de zone de liste dans une boîte de dialogue, un affichage de formulaire ou un objet d’affichage de contrôle et un CString membre de données de la boîte de dialogue, de la vue formulaire ou de l’objet d’affichage de contrôle.

void AFXAPI DDX_LBStringExact(
    CDataExchange* pDX,
    int nIDC,
    CString& value);

Paramètres

pDX
Pointeur vers un objet CDataExchange. L’infrastructure fournit cet objet pour établir le contexte de l’échange de données, notamment sa direction.

nIDC
ID de ressource du contrôle de zone de liste associé à la propriété de contrôle.

value
Référence à une variable membre de la boîte de dialogue, de la vue formulaire ou de l’objet de vue de contrôle avec lequel les données sont échangées.

Notes

Lorsqu’il DDX_LBStringExact est appelé pour transférer des données vers un contrôle de zone de liste, le premier élément du contrôle qui correspond value est sélectionné. (Pour correspondre à un préfixe plutôt qu’à l’élément entier, utilisez DDX_LBString.) S’il n’y a aucune correspondance, aucun élément n’est sélectionné. La correspondance n'est pas sensible à la casse.

Lorsqu’elle DDX_CBStringExact est appelée pour transférer des données à partir d’un contrôle zone de liste, value elle est définie sur la sélection de la zone de liste actuelle. Si aucun élément n’est sélectionné, value est défini sur une chaîne de longueur nulle.

Remarque

Si la zone de liste est une zone de liste déroulante, la valeur échangée est limitée à 255 caractères.

Pour plus d'informations sur DDX, consultez Échange et validation de données de boîtes de dialogue.

Spécifications

En-tête afxdd_.h

DDX_MonthCalCtrl

La DDX_MonthCalCtrl fonction gère le transfert de données de date entre un contrôle calendrier mensuel ( CMonthCalCtrl) dans une boîte de dialogue, un affichage formulaire ou un objet d’affichage de contrôle et un ou un CTime COleDateTime membre de données de la boîte de dialogue, de la vue formulaire ou de l’objet d’affichage de contrôle.

void AFXAPI DDX_MonthCalCtrl(
    CDataExchange* pDX,
    int nIDC,
    CTime& value);

void AFXAPI DDX_MonthCalCtrl(
    CDataExchange* pDX,
    int nIDC,
    COleDateTime& value);

Paramètres

pDX
Pointeur vers un objet CDataExchange. L’infrastructure fournit cet objet pour établir le contexte de l’échange de données, notamment sa direction. Vous n’avez pas besoin de supprimer cet objet.

nIDC
ID de ressource du contrôle calendrier mois associé à la variable membre.

value
Référence à une CTime variable ou COleDateTime membre de la boîte de dialogue, de la vue formulaire ou de l’objet de vue de contrôle avec lequel les données sont échangées.

Notes

Remarque

Le contrôle gère uniquement une valeur de date. Les champs d’heure de l’objet de temps sont définis pour refléter l’heure de création de la fenêtre de contrôle, ou quelle que soit l’heure définie dans le contrôle avec un appel à CMonthCalCtrl::SetCurSel.

Lorsqu’il DDX_MonthCalCtrl est appelé, value est défini sur l’état actuel du contrôle calendrier du mois.

Pour plus d'informations sur DDX, consultez Échange et validation de données de boîtes de dialogue.

Spécifications

En-tête afxdd_.h

DDX_Radio

La DDX_Radio fonction gère le transfert de int données entre un groupe de contrôles radio dans une boîte de dialogue, une vue de formulaire ou un objet d’affichage de contrôle et un membre de données de la boîte de dialogue, d’un affichage de formulaire ou d’un int objet d’affichage de contrôle. La valeur du membre de données est déterminée en fonction de int la case d’option dans le groupe sélectionnée.

void AFXAPI DDX_Radio(
    CDataExchange* pDX,
    int nIDC,
    int& value);

Paramètres

pDX
Pointeur vers un objet CDataExchange. L’infrastructure fournit cet objet pour établir le contexte de l’échange de données, notamment sa direction.

nIDC
ID de ressource du premier contrôle radio dans le groupe.

value
Référence à une variable membre de la boîte de dialogue, de la vue formulaire ou de l’objet de vue de contrôle avec lequel les données sont échangées.

Notes

Quand DDX_Radio elle est appelée, value est définie sur l’état actuel du groupe de contrôles radio. La valeur est définie en tant qu’index basé sur 0 du contrôle radio actuellement activé, ou -1 si aucun contrôle radio n’est activé.

Par exemple, si la première case d’option du groupe est cochée (le bouton avec WS_GROUP style) la valeur du int membre est 0, et ainsi de suite.

Pour plus d'informations sur DDX, consultez Échange et validation de données de boîtes de dialogue.

Spécifications

En-tête afxdd_.h

DDX_Scroll

La DDX_Scroll fonction gère le transfert de données entre un contrôle de barre de int défilement dans une boîte de dialogue, une vue de formulaire ou un objet d’affichage de contrôle et un membre de données de la boîte de dialogue, d’une vue de formulaire ou d’un int objet d’affichage de contrôle.

void AFXAPI DDX_Scroll(
    CDataExchange* pDX,
    int nIDC,
    int& value);

Paramètres

pDX
Pointeur vers un objet CDataExchange. L’infrastructure fournit cet objet pour établir le contexte de l’échange de données, notamment sa direction.

nIDC
ID de ressource du contrôle de barre de défilement associé à la propriété de contrôle.

value
Référence à une variable membre de l’objet boîte de dialogue, vue de formulaire ou vue de contrôle avec lequel les données sont échangées.

Notes

Lorsqu’il DDX_Scroll est appelé, value est défini sur la position actuelle du pouce du contrôle. Pour plus d’informations sur les valeurs associées à la position actuelle du pouce du contrôle, consultez GetScrollPos le Kit de développement logiciel (SDK) Windows.

Pour plus d'informations sur DDX, consultez Échange et validation de données de boîtes de dialogue.

Spécifications

En-tête afxdd_.h

DDX_Slider

La DDX_Slider fonction gère le transfert de int données entre un contrôle de curseur dans une boîte de dialogue ou une vue de formulaire et un int membre de données de la boîte de dialogue ou de l’objet d’affichage de formulaire.

void AFXAPI DDX_Slider(
    CDataExchange* pDX,
    int nIDC,
    int& value);

Paramètres

pDX
Pointeur vers un objet CDataExchange. L’infrastructure fournit cet objet pour établir le contexte de l’échange de données, notamment sa direction.

nIDC
ID de ressource du contrôle curseur.

value
Référence à la valeur à échanger. Ce paramètre contient ou définit la position actuelle du contrôle de curseur.

Notes

Lorsqu’elle DDX_Slider est appelée, value est définie sur la position actuelle du pouce du contrôle, ou la valeur reçoit la position, selon la direction de l’échange.

Pour plus d'informations sur DDX, consultez Échange et validation de données de boîtes de dialogue. Pour plus d’informations sur les contrôles de curseur, consultez Utilisation CSliderCtrl.

Spécifications

En-tête afxdd_.h

DDX_Text

La DDX_Text fonction gère le transfert de données UINTCStringdouble floatlongDWORDentre intun contrôle d’édition dans une boîte de dialogue, un affichage formulaire ou un contrôle et un CString membre de données de la boîte de dialogue, de la vue formulaire ou de l’objet d’affichage de contrôle.

void AFXAPI DDX_Text(
    CDataExchange* pDX,
    int nIDC,
    BYTE& value);

void AFXAPI DDX_Text(
    CDataExchange* pDX,
    int nIDC,
    short& value);

void AFXAPI DDX_Text(
    CDataExchange* pDX,
    int nIDC,
    int& value);

void AFXAPI DDX_Text(
    CDataExchange* pDX,
    int nIDC,
    UINT& value);

void AFXAPI DDX_Text(
    CDataExchange* pDX,
    int nIDC,
    long& value);

void AFXAPI DDX_Text(
    CDataExchange* pDX,
    int nIDC,
    DWORD& value);

void AFXAPI DDX_Text(
    CDataExchange* pDX,
    int nIDC,
    CString& value);

void AFXAPI DDX_Text(
    CDataExchange* pDX,
    int nIDC,
    float& value);

void AFXAPI DDX_Text(
    CDataExchange* pDX,
    int nIDC,
    double& value);

void AFXAPI DDX_Text(
    CDataExchange* pDX,
    int nIDC,
    COleCurrency& value);

void AFXAPI DDX_Text(
    CDataExchange* pDX,
    int nIDC,
    COleDateTime& value);

Paramètres

pDX
Pointeur vers un objet CDataExchange. L’infrastructure fournit cet objet pour établir le contexte de l’échange de données, notamment sa direction.

nIDC
ID d’un contrôle d’édition dans la boîte de dialogue, l’affichage formulaire ou l’objet d’affichage de contrôle.

value
Référence à un membre de données dans la boîte de dialogue, l’affichage formulaire ou l’objet d’affichage de contrôle. Le type de données dépend value des versions surchargées que DDX_Text vous utilisez.

Notes

Pour plus d'informations sur DDX, consultez Échange et validation de données de boîtes de dialogue.

Spécifications

En-tête afxdd_.h

Voir aussi

Routines de validation des données de boîte de dialogue standard
Macros et globals
CWinFormsControl::CreateManagedControl
CDialog::OnInitDialog