Partager via

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

  • Article

Cette rubrique répertorie les routines de validation des données de dialogue standard (DDV) 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 DDV

Nom Description
DDV_MaxChars Vérifie le nombre de caractères dans une valeur de contrôle donnée ne dépasse pas un maximum donné.
DDV_MinMaxByte Vérifie qu’une valeur de contrôle donnée ne dépasse pas une plage BYTE donnée.
DDV_MinMaxDateTime Vérifie qu’une valeur de contrôle donnée ne dépasse pas un intervalle de temps donné.
DDV_MinMaxDouble Vérifie qu’une valeur de contrôle donnée ne dépasse pas une plage donnée double .
DDV_MinMaxDWord Vérifie qu’une valeur de contrôle donnée ne dépasse pas une plage DWORD donnée.
DDV_MinMaxFloat Vérifie qu’une valeur de contrôle donnée ne dépasse pas une plage donnée float .
DDV_MinMaxInt Vérifie qu’une valeur de contrôle donnée ne dépasse pas une plage donnée int .
DDV_MinMaxLong Vérifie qu’une valeur de contrôle donnée ne dépasse pas une plage donnée long .
DDV_MinMaxLongLong Vérifie qu’une valeur de contrôle donnée ne dépasse pas une plage LONGLONG donnée.
DDV_MinMaxMonth Vérifie qu’une valeur de contrôle donnée ne dépasse pas une plage de dates donnée.
DDV_MinMaxShort Vérifie qu’une valeur de contrôle donnée ne dépasse pas une plage donnée short .
DDV_MinMaxSlider Vérifie qu’une valeur de contrôle de curseur donnée se trouve dans la plage donnée.
DDV_MinMaxUInt Vérifie qu’une valeur de contrôle donnée ne dépasse pas une plage UINT donnée.
DDV_MinMaxUnsigned Vérifie qu’une valeur de contrôle donnée se situe entre deux valeurs spécifiées.
DDV_MinMaxULongLong Vérifie qu’une valeur de contrôle donnée ne dépasse pas une plage ULONGLONG donnée.

DDV_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.

valeur
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 DDV, consultez Boîte de dialogue Échange de données et Validation.

Spécifications

En-tête afxdd_.h

DDV_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.

valeur
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 DDV, consultez Boîte de dialogue Échange de données et Validation.

Spécifications

En-tête afxdd_.h

DDV_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 DDV, consultez Boîte de dialogue Échange de données et Validation.

Spécifications

En-tête afxdd_.h

DDV_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.

valeur
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 DDV, consultez Boîte de dialogue Échange de données et Validation.

Spécifications

En-tête afxdd_.h

DDV_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.

valeur
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 DDV, consultez Boîte de dialogue Échange de données et Validation.

Spécifications

En-tête afxdd_.h

DDV_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.

valeur
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 DDV, consultez Boîte de dialogue Échange de données et Validation.

Spécifications

En-tête afxdd_.h

DDV_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.

valeur
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 DDV, consultez Boîte de dialogue Échange de données et Validation.

Spécifications

En-tête afxdd_.h

DDV_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.

valeur
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 DDV, consultez Boîte de dialogue Échange de données et Validation.

Spécifications

En-tête afxdd_.h

DDV_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.

valeur
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 DDV, consultez Boîte de dialogue Échange de données et Validation.

Spécifications

En-tête afxdd_.h

DDV_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 DDV, consultez Boîte de dialogue Échange de données et Validation.

Spécifications

En-tête afxdd_.h

DDV_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.

valeur
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 DDV, consultez Boîte de dialogue Échange de données et Validation.

Spécifications

En-tête afxdd_.h

DDV_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.

valeur
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 DDV, 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

DDV_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.

valeur
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 DDV, consultez Boîte de dialogue Échange de données et Validation.

Spécifications

En-tête afxdd_.h

DDV_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.

valeur
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 DDV, 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.

valeur
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 DDV, 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