Routines de validation des données de boîte de dialogue standard

Cette rubrique répertorie les routines de validation des données de dialogue standard (VDD) 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 d’en-tête afxdd_.h. Toutefois, les applications doivent inclure afxwin.h.

fonctions VDD

Nom	Description
VDD_MaxChars	Vérifie le nombre de caractères dans une valeur de contrôle donnée ne dépasse pas un maximum donné.
VDD_MinMaxByte	Vérifie qu’une valeur de contrôle donnée ne dépasse pas une plage BYTE donnée.
VDD_MinMaxDateTime	Vérifie qu’une valeur de contrôle donnée ne dépasse pas un intervalle de temps donné.
VDD_MinMaxDouble	Vérifie qu’une valeur de contrôle donnée ne dépasse pas une plage donnée double .
VDD_MinMaxDWord	Vérifie qu’une valeur de contrôle donnée ne dépasse pas une plage DWORD donnée.
VDD_MinMaxFloat	Vérifie qu’une valeur de contrôle donnée ne dépasse pas une plage donnée float .
VDD_MinMaxInt	Vérifie qu’une valeur de contrôle donnée ne dépasse pas une plage donnée int .
VDD_MinMaxLong	Vérifie qu’une valeur de contrôle donnée ne dépasse pas une plage donnée long .
VDD_MinMaxLongLong	Vérifie qu’une valeur de contrôle donnée ne dépasse pas une plage LONGLONG donnée.
VDD_MinMaxMonth	Vérifie qu’une valeur de contrôle donnée ne dépasse pas une plage de dates donnée.
VDD_MinMaxShort	Vérifie qu’une valeur de contrôle donnée ne dépasse pas une plage donnée short .
VDD_MinMaxSlider	Vérifie qu’une valeur de contrôle de curseur donnée se trouve dans la plage donnée.
VDD_MinMaxUInt	Vérifie qu’une valeur de contrôle donnée ne dépasse pas une plage UINT donnée.
VDD_MinMaxUnsigned	Vérifie qu’une valeur de contrôle donnée se situe entre deux valeurs spécifiées.
VDD_MinMaxULongLong	Vérifie qu’une valeur de contrôle donnée ne dépasse pas une plage ULONGLONG donnée.

VDD_MaxChars

Appelez DDV_MaxChars pour vérifier que la quantité de caractères dans le contrôle associé à la valeur ne dépasse pas nChars.

void AFXAPI DDV_MaxChars(
    CDataExchange* pDX,
    CString const& value,
    int nChars);

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.

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

nChars
Nombre maximal de caractères autorisés.

Notes

Pour plus d’informations sur VDD, consultez Boîte de dialogue Échange de données et Validation.

Spécifications

En-tête afxdd_.h

VDD_MinMaxByte

Appelez DDV_MinMaxByte pour vérifier que la valeur dans le contrôle associé à la valeur se situe entre minVal et maxVal.

void AFXAPI DDV_MinMaxByte(
    CDataExchange* pDX,
    BYTE value,
    BYTE minVal,
    BYTE maxVal);

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.

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

minVal
Valeur minimale (de type BYTE) autorisée.

maxVal
Valeur maximale (de type BYTE) autorisée.

Notes

Pour plus d’informations sur VDD, consultez Boîte de dialogue Échange de données et Validation.

Spécifications

En-tête afxdd_.h

VDD_MinMaxDateTime

Appelez DDV_MinMaxDateTime pour vérifier que la valeur d’heure/date dans le contrôle du sélecteur de date et d’heure ( CDateTimeCtrl) associé à refValue se situe entre refMinRange et refMaxRange.

void AFXAPI DDV_MinMaxDateTime(
    CDataExchange* pDX,
    CTime& refValue,
    const CTime* refMinRange,
    const CTime* refMaxRange);

void AFXAPI DDV_MinMaxDateTime(
    CDataExchange* pDX,
    COleDateTime& refValue,
    const COleDateTime* refMinRange,
    const COleDateTime* refMaxRange);

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.

refValue
Référence à un objet CTime ou COleDateTime associé à une variable membre de la boîte de dialogue, de la vue formulaire ou de l’objet de vue contrôle. Cet objet contient les données à valider.

refMinRange
Valeur de date/heure minimale autorisée.

refMaxRange
Valeur de date/heure maximale autorisée.

Notes

Pour plus d’informations sur VDD, consultez Boîte de dialogue Échange de données et Validation.

Spécifications

En-tête afxdd_.h

VDD_MinMaxDouble

Appelez DDV_MinMaxDouble pour vérifier que la valeur dans le contrôle associé à la valeur se situe entre minVal et maxVal.

void AFXAPI DDV_MinMaxDouble(
    CDataExchange* pDX,
    double const& value,
    double minVal,
    double maxVal);

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.

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

minVal
Valeur minimale (de type double) autorisée.

maxVal
Valeur maximale (de type double) autorisée.

Notes

Pour plus d’informations sur VDD, consultez Boîte de dialogue Échange de données et Validation.

Spécifications

En-tête afxdd_.h

VDD_MinMaxDWord

Appelez DDV_MinMaxDWord pour vérifier que la valeur dans le contrôle associé à la valeur se situe entre minVal et maxVal.

void AFXAPI DDV_MinMaxDWord(
    CDataExchange* pDX,
    DWORD const& value,
    DWORD minVal,
    DWORD maxVal);

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.

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

minVal
Valeur minimale (de type DWORD) autorisée.

maxVal
Valeur maximale (de type DWORD) autorisée.

Notes

Pour plus d’informations sur VDD, consultez Boîte de dialogue Échange de données et Validation.

Spécifications

En-tête afxdd_.h

VDD_MinMaxFloat

Appelez DDV_MinMaxFloat pour vérifier que la valeur dans le contrôle associé à la valeur se situe entre minVal et maxVal.

void AFXAPI DDV_MinMaxFloat(
    CDataExchange* pDX,
    float value,
    float minVal,
    float maxVal);

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.

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

minVal
Valeur minimale (de type float) autorisée.

maxVal
Valeur maximale (de type float) autorisée.

Notes

Pour plus d’informations sur VDD, consultez Boîte de dialogue Échange de données et Validation.

Spécifications

En-tête afxdd_.h

VDD_MinMaxInt

Appelez DDV_MinMaxInt pour vérifier que la valeur dans le contrôle associé à la valeur se situe entre minVal et maxVal.

void AFXAPI DDV_MinMaxInt(
    CDataExchange* pDX,
    int value,
    int minVal,
    int maxVal);

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.

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

minVal
Valeur minimale (de type int) autorisée.

maxVal
Valeur maximale (de type int) autorisée.

Notes

Pour plus d’informations sur VDD, consultez Boîte de dialogue Échange de données et Validation.

Spécifications

En-tête afxdd_.h

VDD_MinMaxLong

Appelez DDV_MinMaxLong pour vérifier que la valeur dans le contrôle associé à la valeur se situe entre minVal et maxVal.

void AFXAPI DDV_MinMaxLong(
    CDataExchange* pDX,
    long value,
    long minVal,
    long maxVal);

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.

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

minVal
Valeur minimale (de type long) autorisée.

maxVal
Valeur maximale (de type long) autorisée.

Notes

Pour plus d’informations sur VDD, consultez Boîte de dialogue Échange de données et Validation.

Spécifications

En-tête afxdd_.h

VDD_MinMaxLongLong

Appelez DDV_MinMaxLongLong pour vérifier que la valeur dans le contrôle associé à la valeur se situe entre minVal et maxVal.

void AFXAPI DDV_MinMaxLongLong(
    CDataExchange* pDX,
    LONGLONG value,
    LONGLONG minVal,
    LONGLONG maxVal);

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.

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

minVal
Valeur minimale (de type LONGLONG) autorisée.

maxVal
Valeur maximale (de type LONGLONG) autorisée.

Notes

Pour plus d’informations sur VDD, consultez Boîte de dialogue Échange de données et Validation.

Spécifications

En-tête afxdd_.h

VDD_MinMaxMonth

Appelez DDV_MinMaxMonth pour vérifier que la valeur d’heure/date dans le contrôle calendrier mois ( CMonthCalCtrl) associée à refValue se situe entre refMinRange et refMaxRange.

void AFXAPI DDV_MinMaxMonth(
    CDataExchange* pDX,
    CTime& refValue,
    const CTime* refMinRange,
    const CTime* refMaxRange);

void AFXAPI DDV_MinMaxMonth(
    CDataExchange* pDX,
    COleDateTime& refValue,
    const COleDateTime* refMinRange,
    const COleDateTime* refMaxRange);

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.

refValue
Référence à un objet de type CTime ou COleDateTime associé à une variable membre de la boîte de dialogue, de la vue formulaire ou de l’objet d’affichage de contrôle. Cet objet contient les données à valider. MFC transmet cette référence lorsqu’elle DDV_MinMaxMonth est appelée.

refMinRange
Valeur de date/heure minimale autorisée.

refMaxRange
Valeur de date/heure maximale autorisée.

Notes

Pour plus d’informations sur VDD, consultez Boîte de dialogue Échange de données et Validation.

Spécifications

En-tête afxdd_.h

VDD_MinMaxShort

Appelez DDV_MinMaxShort pour vérifier que la valeur dans le contrôle associé à la valeur se situe entre minVal et maxVal.

void AFXAPI DDV_MinMaxShort(
    CDataExchange* pDX,
    short value,
    short minVal,
    short maxVal);

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.

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

minVal
Valeur minimale (de type short) autorisée.

maxVal
Valeur maximale (de type short) autorisée.

Notes

Pour plus d’informations sur VDD, consultez Boîte de dialogue Échange de données et Validation.

Spécifications

En-tête afxdd_.h

VDD_MinMaxSlider

Appelez DDV_MinMaxSlider pour vérifier que la valeur dans le contrôle associé à la valeur se situe entre minVal et maxVal.

void AFXAPI DDV_MinMaxSlider(
    CDataExchange* pDX,
    DWORD value,
    DWORD minVal,
    DWORD maxVal);

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.

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

minVal
Valeur minimale autorisée.

maxVal
Valeur maximale autorisée.

Notes

Pour plus d’informations sur VDD, consultez Boîte de dialogue Échange de données et Validation. Pour plus d’informations sur les contrôles de curseur, consultez Utilisation de CSliderCtrl.

Spécifications

En-tête afxdd_.h

VDD_MinMaxUInt

Appelez DDV_MinMaxUInt pour vérifier que la valeur dans le contrôle associé à la valeur se situe entre minVal et maxVal.

void AFXAPI DDV_MinMaxUInt(
    CDataExchange* pDX,
    UINT value,
    UINT minVal,
    UINT maxVal);

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.

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

minVal
Valeur minimale (de type UINT) autorisée.

maxVal
Valeur maximale (de type UINT) autorisée.

Notes

Pour plus d’informations sur VDD, consultez Boîte de dialogue Échange de données et Validation.

Spécifications

En-tête afxdd_.h

VDD_MinMaxULongLong

Appelez DDV_MinMaxULongLong pour vérifier que la valeur dans le contrôle associé à la valeur se situe entre minVal et maxVal.

void AFXAPI DDV_MinMaxULongLong(
    CDataExchange* pDX,
    ULONGLONG value,
    ULONGLONG  minVal ,
    ULONGLONG  maxVal);

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.

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

minVal
Valeur minimale (de type ULONGLONG) autorisée.

maxVal
Valeur maximale (de type ULONGLONG) autorisée.

Notes

Pour plus d’informations sur VDD, consultez Boîte de dialogue Échange de données et Validation.

Spécifications

En-tête afxdd_.h

DDV_MinMaxUnsigned

Appelez DDV_MinMaxUnsigned pour vérifier que la valeur dans le contrôle associé à la valeur se situe entre minVal et maxVal.

Syntaxe

   void AFXAPI DDV_MinMaxUnsigned(
       CDataExchange* pDX,
       unsigned value,
       unsigned minVal,
       unsigned maxVal );

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.

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

minVal
Valeur minimale (de type unsigned ) autorisée.

maxVal
Valeur maximale (de type unsigned ) autorisée.

Notes

Pour plus d’informations sur VDD, consultez Boîte de dialogue Échange de données et Validation.

Spécifications

En-tête : afxdd_.h

Voir aussi

Routines d’échange de données de boîte de dialogue standard
Macros et globals
DDX_Slider
DDX_FieldSlider