Condividi tramite

Routine di convalida dei dati della finestra di dialogo standard

  • Articolo

In questo argomento vengono elencate le routine DDV (Dialog Data Validation) standard usate per i controlli comuni delle finestre di dialogo MFC.

Nota

Le routine di scambio dei dati del dialogo standard vengono definite nel file di intestazione afxdd_.h. Tuttavia, le applicazioni devono includere afxwin.h.

Funzioni DDV

Nome Descrizione
DDV_MaxChars Verifica il numero di caratteri in un determinato valore di controllo non supera un determinato valore massimo.
DDV_MinMaxByte Verifica che un determinato valore di controllo non superi un determinato intervallo BYTE .
DDV_MinMaxDateTime Verifica che un determinato valore di controllo non superi un determinato intervallo di tempo.
DDV_MinMaxDouble Verifica che un determinato valore di controllo non superi un determinato double intervallo.
DDV_MinMaxDWord Verifica che un determinato valore di controllo non superi un determinato intervallo DWORD .
DDV_MinMaxFloat Verifica che un determinato valore di controllo non superi un determinato float intervallo.
DDV_MinMaxInt Verifica che un determinato valore di controllo non superi un determinato int intervallo.
DDV_MinMaxLong Verifica che un determinato valore di controllo non superi un determinato long intervallo.
DDV_MinMaxLongLong Verifica che un determinato valore di controllo non superi un determinato intervallo LONGLONG .
DDV_MinMaxMonth Verifica che un determinato valore di controllo non superi un determinato intervallo di date.
DDV_MinMaxShort Verifica che un determinato valore di controllo non superi un determinato short intervallo.
DDV_MinMaxSlider Verifica che un determinato valore del controllo dispositivo di scorrimento sia compreso nell'intervallo specificato.
DDV_MinMaxUInt Verifica che un determinato valore di controllo non superi un determinato intervallo UINT .
DDV_MinMaxUnsigned Verifica che un determinato valore di controllo sia compreso tra due valori specificati.
DDV_MinMaxULongLong Verifica che un determinato valore di controllo non superi un determinato intervallo di ULONGLONG .

DDV_MaxChars

Chiamare DDV_MaxChars per verificare che la quantità di caratteri nel controllo associato al valore non superi nChars.

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

Parametri

pDX
Puntatore a un oggetto CDataExchange. Il framework fornisce questo oggetto per stabilire il contesto dello scambio dei dati, inclusa la relativa direzione.

value
Riferimento a una variabile membro della finestra di dialogo, della visualizzazione maschera o dell'oggetto visualizzazione controllo con cui vengono convalidati i dati.

nChars
Numero massimo di caratteri consentiti.

Osservazioni:

Per altre informazioni su DDV, vedere Scambio di dati e convalida della finestra di dialogo.

Requisiti

Intestazione afxdd_.h

DDV_MinMaxByte

Chiamare DDV_MinMaxByte per verificare che il valore nel controllo associato al valore sia compreso tra minVal e maxVal.

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

Parametri

pDX
Puntatore a un oggetto CDataExchange. Il framework fornisce questo oggetto per stabilire il contesto dello scambio dei dati, inclusa la relativa direzione.

value
Riferimento a una variabile membro della finestra di dialogo, della visualizzazione maschera o dell'oggetto visualizzazione controllo con cui vengono convalidati i dati.

minVal
Valore minimo (di tipo BYTE) consentito.

maxVal
Valore massimo (di tipo BYTE) consentito.

Osservazioni:

Per altre informazioni su DDV, vedere Scambio di dati e convalida della finestra di dialogo.

Requisiti

Intestazione afxdd_.h

DDV_MinMaxDateTime

Chiamare DDV_MinMaxDateTime per verificare che il valore di ora/data nel controllo selezione data e ora ( CDateTimeCtrl) associato a refValue sia compreso tra refMinRange e 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);

Parametri

pDX
Puntatore a un oggetto CDataExchange . Il framework fornisce questo oggetto per stabilire il contesto dello scambio dei dati, inclusa la relativa direzione. Non è necessario eliminare questo oggetto.

refValue
Riferimento a un oggetto CTime o COleDateTime associato a una variabile membro della finestra di dialogo, della visualizzazione maschera o dell'oggetto visualizzazione controlli. Questo oggetto contiene i dati da convalidare.

refMinRange
Valore di data/ora minimo consentito.

refMaxRange
Valore massimo di data/ora consentito.

Osservazioni:

Per altre informazioni su DDV, vedere Scambio di dati e convalida della finestra di dialogo.

Requisiti

Intestazione afxdd_.h

DDV_MinMaxDouble

Chiamare DDV_MinMaxDouble per verificare che il valore nel controllo associato al valore sia compreso tra minVal e maxVal.

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

Parametri

pDX
Puntatore a un oggetto CDataExchange. Il framework fornisce questo oggetto per stabilire il contesto dello scambio dei dati, inclusa la relativa direzione.

value
Riferimento a una variabile membro della finestra di dialogo, della visualizzazione maschera o dell'oggetto visualizzazione controllo con cui vengono convalidati i dati.

minVal
Valore minimo (di tipo double) consentito.

maxVal
Valore massimo (di tipo double) consentito.

Osservazioni:

Per altre informazioni su DDV, vedere Scambio di dati e convalida della finestra di dialogo.

Requisiti

Intestazione afxdd_.h

DDV_MinMaxDWord

Chiamare DDV_MinMaxDWord per verificare che il valore nel controllo associato al valore sia compreso tra minVal e maxVal.

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

Parametri

pDX
Puntatore a un oggetto CDataExchange. Il framework fornisce questo oggetto per stabilire il contesto dello scambio dei dati, inclusa la relativa direzione.

value
Riferimento a una variabile membro della finestra di dialogo, della visualizzazione maschera o dell'oggetto visualizzazione controllo con cui vengono convalidati i dati.

minVal
Valore minimo (di tipo DWORD) consentito.

maxVal
Valore massimo (di tipo DWORD) consentito.

Osservazioni:

Per altre informazioni su DDV, vedere Scambio di dati e convalida della finestra di dialogo.

Requisiti

Intestazione afxdd_.h

DDV_MinMaxFloat

Chiamare DDV_MinMaxFloat per verificare che il valore nel controllo associato al valore sia compreso tra minVal e maxVal.

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

Parametri

pDX
Puntatore a un oggetto CDataExchange. Il framework fornisce questo oggetto per stabilire il contesto dello scambio dei dati, inclusa la relativa direzione.

value
Riferimento a una variabile membro della finestra di dialogo, della visualizzazione maschera o dell'oggetto visualizzazione controllo con cui vengono convalidati i dati.

minVal
Valore minimo (di tipo float) consentito.

maxVal
Valore massimo (di tipo float) consentito.

Osservazioni:

Per altre informazioni su DDV, vedere Scambio di dati e convalida della finestra di dialogo.

Requisiti

Intestazione afxdd_.h

DDV_MinMaxInt

Chiamare DDV_MinMaxInt per verificare che il valore nel controllo associato al valore sia compreso tra minVal e maxVal.

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

Parametri

pDX
Puntatore a un oggetto CDataExchange. Il framework fornisce questo oggetto per stabilire il contesto dello scambio dei dati, inclusa la relativa direzione.

value
Riferimento a una variabile membro della finestra di dialogo, della visualizzazione maschera o dell'oggetto visualizzazione controllo con cui vengono convalidati i dati.

minVal
Valore minimo (di tipo int) consentito.

maxVal
Valore massimo (di tipo int) consentito.

Osservazioni:

Per altre informazioni su DDV, vedere Scambio di dati e convalida della finestra di dialogo.

Requisiti

Intestazione afxdd_.h

DDV_MinMaxLong

Chiamare DDV_MinMaxLong per verificare che il valore nel controllo associato al valore sia compreso tra minVal e maxVal.

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

Parametri

pDX
Puntatore a un oggetto CDataExchange. Il framework fornisce questo oggetto per stabilire il contesto dello scambio dei dati, inclusa la relativa direzione.

value
Riferimento a una variabile membro della finestra di dialogo, della visualizzazione maschera o dell'oggetto visualizzazione controllo con cui vengono convalidati i dati.

minVal
Valore minimo (di tipo long) consentito.

maxVal
Valore massimo (di tipo long) consentito.

Osservazioni:

Per altre informazioni su DDV, vedere Scambio di dati e convalida della finestra di dialogo.

Requisiti

Intestazione afxdd_.h

DDV_MinMaxLongLong

Chiamare DDV_MinMaxLongLong per verificare che il valore nel controllo associato al valore sia compreso tra minVal e maxVal.

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

Parametri

pDX
Puntatore a un oggetto CDataExchange. Il framework fornisce questo oggetto per stabilire il contesto dello scambio dei dati, inclusa la relativa direzione.

value
Riferimento a una variabile membro della finestra di dialogo, della visualizzazione maschera o dell'oggetto visualizzazione controllo con cui vengono convalidati i dati.

minVal
Valore minimo (di tipo LONGLONG) consentito.

maxVal
Valore massimo (di tipo LONGLONG) consentito.

Osservazioni:

Per altre informazioni su DDV, vedere Scambio di dati e convalida della finestra di dialogo.

Requisiti

Intestazione afxdd_.h

DDV_MinMaxMonth

Chiamare DDV_MinMaxMonth per verificare che il valore di ora/data nel controllo calendario del mese ( CMonthCalCtrl) associato a refValue sia compreso tra refMinRange e 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);

Parametri

pDX
Puntatore a un oggetto CDataExchange . Il framework fornisce questo oggetto per stabilire il contesto dello scambio dei dati, inclusa la relativa direzione.

refValue
Riferimento a un oggetto di tipo CTime o COleDateTime associato a una variabile membro della finestra di dialogo, della visualizzazione maschera o dell'oggetto visualizzazione controlli. Questo oggetto contiene i dati da convalidare. MFC passa questo riferimento quando DDV_MinMaxMonth viene chiamato.

refMinRange
Valore di data/ora minimo consentito.

refMaxRange
Valore massimo di data/ora consentito.

Osservazioni:

Per altre informazioni su DDV, vedere Scambio di dati e convalida della finestra di dialogo.

Requisiti

Intestazione afxdd_.h

DDV_MinMaxShort

Chiamare DDV_MinMaxShort per verificare che il valore nel controllo associato al valore sia compreso tra minVal e maxVal.

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

Parametri

pDX
Puntatore a un oggetto CDataExchange. Il framework fornisce questo oggetto per stabilire il contesto dello scambio dei dati, inclusa la relativa direzione.

value
Riferimento a una variabile membro della finestra di dialogo, della visualizzazione maschera o dell'oggetto visualizzazione controllo con cui vengono convalidati i dati.

minVal
Valore minimo (di tipo short) consentito.

maxVal
Valore massimo (di tipo short) consentito.

Osservazioni:

Per altre informazioni su DDV, vedere Scambio di dati e convalida della finestra di dialogo.

Requisiti

Intestazione afxdd_.h

DDV_MinMaxSlider

Chiamare DDV_MinMaxSlider per verificare che il valore nel controllo associato al valore sia compreso tra minVal e maxVal.

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

Parametri

pDX
Puntatore a un oggetto CDataExchange . Il framework fornisce questo oggetto per stabilire il contesto dello scambio dei dati, inclusa la relativa direzione.

value
Riferimento al valore da convalidare. Questo parametro contiene o imposta la posizione corrente del controllo dispositivo di scorrimento.

minVal
Valore minimo consentito.

maxVal
Valore massimo consentito.

Osservazioni:

Per altre informazioni su DDV, vedere Scambio di dati e convalida della finestra di dialogo. Per informazioni sui controlli dispositivo di scorrimento, vedere Uso di CSliderCtrl.

Requisiti

Intestazione afxdd_.h

DDV_MinMaxUInt

Chiamare DDV_MinMaxUInt per verificare che il valore nel controllo associato al valore sia compreso tra minVal e maxVal.

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

Parametri

pDX
Puntatore a un oggetto CDataExchange. Il framework fornisce questo oggetto per stabilire il contesto dello scambio dei dati, inclusa la relativa direzione.

value
Riferimento a una variabile membro della finestra di dialogo, della visualizzazione maschera o dell'oggetto visualizzazione controllo con cui vengono convalidati i dati.

minVal
Valore minimo (di tipo UINT) consentito.

maxVal
Valore massimo (di tipo UINT) consentito.

Osservazioni:

Per altre informazioni su DDV, vedere Scambio di dati e convalida della finestra di dialogo.

Requisiti

Intestazione afxdd_.h

DDV_MinMaxULongLong

Chiamare DDV_MinMaxULongLong per verificare che il valore nel controllo associato al valore sia compreso tra minVal e maxVal.

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

Parametri

pDX
Puntatore a un oggetto CDataExchange. Il framework fornisce questo oggetto per stabilire il contesto dello scambio dei dati, inclusa la relativa direzione.

value
Riferimento a una variabile membro della finestra di dialogo, della visualizzazione maschera o dell'oggetto visualizzazione controllo con cui vengono convalidati i dati.

minVal
Valore minimo (di tipo ULONGLONG) consentito.

maxVal
Valore massimo (di tipo ULONGLONG) consentito.

Osservazioni:

Per altre informazioni su DDV, vedere Scambio di dati e convalida della finestra di dialogo.

Requisiti

Intestazione afxdd_.h

DDV_MinMaxUnsigned

Chiamare DDV_MinMaxUnsigned per verificare che il valore nel controllo associato al valore sia compreso tra minVal e maxVal.

Sintassi

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

Parametri

pDX
Puntatore a un oggetto CDataExchange. Il framework fornisce questo oggetto per stabilire il contesto dello scambio dei dati, inclusa la relativa direzione.

value
Riferimento a una variabile membro della finestra di dialogo, della visualizzazione maschera o dell'oggetto visualizzazione controllo con cui vengono convalidati i dati.

minVal
Valore minimo (di tipo unsigned ) consentito.

maxVal
Valore massimo (di tipo unsigned ) consentito.

Osservazioni:

Per altre informazioni su DDV, vedere Scambio di dati e convalida della finestra di dialogo.

Requisiti

Intestazione: afxdd_.h

Vedi anche

Routine DDX (Dialog Data Exchange) standard
Macro e globali
DDX_Slider
DDX_FieldSlider