Valideringsrutiner för standarddialogdata

Anmärkning

Biblioteket För Microsoft Foundation-klasser (MFC) stöds fortfarande. Vi lägger dock inte längre till funktioner eller uppdaterar dokumentationen.

Det här avsnittet innehåller de standardrutiner för validering av dialogdata (DDV) som används för vanliga MFC-dialogkontroller.

Anmärkning

Standardrutinerna för dialogdatautbyte definieras i huvudfilen afxdd_.h. Program bör dock innehålla afxwin.h.

DDV-funktioner

Namn Description
DDV_MaxChars Verifierar att antalet tecken i ett givet kontrollvärde inte överskrider ett angivet maxvärde.
DDV_MinMaxByte Verifierar att ett givet kontrollvärde inte överskrider ett angivet BYTE-intervall .
DDV_MinMaxDateTime Verifierar att ett givet kontrollvärde inte överskrider ett angivet tidsintervall.
DDV_MinMaxDouble Verifierar att ett givet kontrollvärde inte överskrider ett angivet double intervall.
DDV_MinMaxDWord Verifierar att ett givet kontrollvärde inte överskrider ett angivet DWORD-intervall .
DDV_MinMaxFloat Verifierar att ett givet kontrollvärde inte överskrider ett angivet float intervall.
DDV_MinMaxInt Verifierar att ett givet kontrollvärde inte överskrider ett angivet int intervall.
DDV_MinMaxLong Verifierar att ett givet kontrollvärde inte överskrider ett angivet long intervall.
DDV_MinMaxLongLong Verifierar att ett givet kontrollvärde inte överskrider ett angivet LONGLONG-intervall .
DDV_MinMaxMonth Verifierar att ett givet kontrollvärde inte överskrider ett angivet datumintervall.
DDV_MinMaxShort Verifierar att ett givet kontrollvärde inte överskrider ett angivet short intervall.
DDV_MinMaxSlider Verifierar att ett givet skjutreglagekontrollvärde ligger inom det angivna intervallet.
DDV_MinMaxUInt Verifierar att ett givet kontrollvärde inte överskrider ett angivet UINT-intervall .
DDV_MinMaxUnsigned Verifierar att ett givet kontrollvärde ligger mellan två angivna värden.
DDV_MinMaxULongLong Verifierar att ett givet kontrollvärde inte överskrider ett angivet ULONGLONG-intervall .

DDV_MaxChars

Anropa DDV_MaxChars för att kontrollera att mängden tecken i kontrollen som är associerad med värdet inte överskrider nChars.

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

Parameterar

Pdx
En pekare till ett CDataExchange objekt. Ramverket tillhandahåller det här objektet för att fastställa kontexten för datautbytet, inklusive dess riktning.

värde
En referens till en medlemsvariabel i dialogrutan, formulärvyn eller kontrollvyobjektet som data verifieras med.

nChars
Maximalt antal tecken som tillåts.

Anmärkningar

Mer information om DDV finns i Dialog datautbyte och validering.

Kravspecifikation

Rubrik afxdd_.h

DDV_MinMaxByte

Anropa DDV_MinMaxByte för att kontrollera att värdet i kontrollen som är associerad med värdet faller mellan minVal och maxVal.

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

Parameterar

Pdx
En pekare till ett CDataExchange objekt. Ramverket tillhandahåller det här objektet för att fastställa kontexten för datautbytet, inklusive dess riktning.

värde
En referens till en medlemsvariabel i dialogrutan, formulärvyn eller kontrollvyobjektet som data verifieras med.

minVal
Lägsta tillåtna värde (av typen BYTE).

maxVal
Högsta tillåtna värde (av typen BYTE).

Anmärkningar

Mer information om DDV finns i Dialog datautbyte och validering.

Kravspecifikation

Rubrik afxdd_.h

DDV_MinMaxDateTime

Anropa DDV_MinMaxDateTime för att kontrollera att tid/datum-värdet i kontrollen för datum- och tidsväljare ( CDateTimeCtrl) som är associerad med refValue faller mellan refMinRange och 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);

Parameterar

Pdx
En pekare till ett CDataExchange-objekt . Ramverket tillhandahåller det här objektet för att fastställa kontexten för datautbytet, inklusive dess riktning. Du behöver inte ta bort det här objektet.

refValue
En referens till ett CTime - eller COleDateTime-objekt som är associerat med en medlemsvariabel i dialogrutan, formulärvyn eller kontrollvyobjektet. Det här objektet innehåller de data som ska verifieras.

refMinRange
Minsta tillåtna datum-/tidsvärde.

refMaxRange
Högsta tillåtna datum-/tidsvärde.

Anmärkningar

Mer information om DDV finns i Dialog datautbyte och validering.

Kravspecifikation

Rubrik afxdd_.h

DDV_MinMaxDouble

Anropa DDV_MinMaxDouble för att kontrollera att värdet i kontrollen som är associerad med värdet faller mellan minVal och maxVal.

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

Parameterar

Pdx
En pekare till ett CDataExchange objekt. Ramverket tillhandahåller det här objektet för att fastställa kontexten för datautbytet, inklusive dess riktning.

värde
En referens till en medlemsvariabel i dialogrutan, formulärvyn eller kontrollvyobjektet som data verifieras med.

minVal
Minsta tillåtna värde (av typen double) .

maxVal
Maximalt värde (av typen double) tillåts.

Anmärkningar

Mer information om DDV finns i Dialog datautbyte och validering.

Kravspecifikation

Rubrik afxdd_.h

DDV_MinMaxDWord

Anropa DDV_MinMaxDWord för att kontrollera att värdet i kontrollen som är associerad med värdet faller mellan minVal och maxVal.

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

Parameterar

Pdx
En pekare till ett CDataExchange objekt. Ramverket tillhandahåller det här objektet för att fastställa kontexten för datautbytet, inklusive dess riktning.

värde
En referens till en medlemsvariabel i dialogrutan, formulärvyn eller kontrollvyobjektet som data verifieras med.

minVal
Lägsta tillåtna värde (av typen DWORD).

maxVal
Maximalt värde (av typen DWORD) tillåts.

Anmärkningar

Mer information om DDV finns i Dialog datautbyte och validering.

Kravspecifikation

Rubrik afxdd_.h

DDV_MinMaxFloat

Anropa DDV_MinMaxFloat för att kontrollera att värdet i kontrollen som är associerad med värdet faller mellan minVal och maxVal.

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

Parameterar

Pdx
En pekare till ett CDataExchange objekt. Ramverket tillhandahåller det här objektet för att fastställa kontexten för datautbytet, inklusive dess riktning.

värde
En referens till en medlemsvariabel i dialogrutan, formulärvyn eller kontrollvyobjektet som data verifieras med.

minVal
Minsta tillåtna värde (av typen float) .

maxVal
Maximalt värde (av typen float) tillåts.

Anmärkningar

Mer information om DDV finns i Dialog datautbyte och validering.

Kravspecifikation

Rubrik afxdd_.h

DDV_MinMaxInt

Anropa DDV_MinMaxInt för att kontrollera att värdet i kontrollen som är associerad med värdet faller mellan minVal och maxVal.

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

Parameterar

Pdx
En pekare till ett CDataExchange objekt. Ramverket tillhandahåller det här objektet för att fastställa kontexten för datautbytet, inklusive dess riktning.

värde
En referens till en medlemsvariabel i dialogrutan, formulärvyn eller kontrollvyobjektet som data verifieras med.

minVal
Minsta tillåtna värde (av typen int) .

maxVal
Maximalt värde (av typen int) tillåts.

Anmärkningar

Mer information om DDV finns i Dialog datautbyte och validering.

Kravspecifikation

Rubrik afxdd_.h

DDV_MinMaxLong

Anropa DDV_MinMaxLong för att kontrollera att värdet i kontrollen som är associerad med värdet faller mellan minVal och maxVal.

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

Parameterar

Pdx
En pekare till ett CDataExchange objekt. Ramverket tillhandahåller det här objektet för att fastställa kontexten för datautbytet, inklusive dess riktning.

värde
En referens till en medlemsvariabel i dialogrutan, formulärvyn eller kontrollvyobjektet som data verifieras med.

minVal
Minsta tillåtna värde (av typen long) .

maxVal
Maximalt värde (av typen long) tillåts.

Anmärkningar

Mer information om DDV finns i Dialog datautbyte och validering.

Kravspecifikation

Rubrik afxdd_.h

DDV_MinMaxLongLong

Anropa DDV_MinMaxLongLong för att kontrollera att värdet i kontrollen som är associerad med värdet faller mellan minVal och maxVal.

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

Parameterar

Pdx
En pekare till ett CDataExchange objekt. Ramverket tillhandahåller det här objektet för att fastställa kontexten för datautbytet, inklusive dess riktning.

värde
En referens till en medlemsvariabel i dialogrutan, formulärvyn eller kontrollvyobjektet som data verifieras med.

minVal
Lägsta tillåtna värde (av typen LONGLONG).

maxVal
Högsta tillåtna värde (av typen LONGLONG).

Anmärkningar

Mer information om DDV finns i Dialog datautbyte och validering.

Kravspecifikation

Rubrik afxdd_.h

DDV_MinMaxMonth

Anropa DDV_MinMaxMonth för att kontrollera att tids-/datumvärdet i månadskalenderkontrollen ( CMonthCalCtrl) som är associerad med refValue faller mellan refMinRange och 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);

Parameterar

Pdx
En pekare till ett CDataExchange-objekt . Ramverket tillhandahåller det här objektet för att fastställa kontexten för datautbytet, inklusive dess riktning.

refValue
En referens till ett objekt av typen CTime eller COleDateTime associerat med en medlemsvariabel i dialogrutan, formulärvyn eller kontrollvyobjektet. Det här objektet innehåller de data som ska verifieras. MFC skickar den här referensen när DDV_MinMaxMonth anropas.

refMinRange
Minsta tillåtna datum-/tidsvärde.

refMaxRange
Högsta tillåtna datum-/tidsvärde.

Anmärkningar

Mer information om DDV finns i Dialog datautbyte och validering.

Kravspecifikation

Rubrik afxdd_.h

DDV_MinMaxShort

Anropa DDV_MinMaxShort för att kontrollera att värdet i kontrollen som är associerad med värdet faller mellan minVal och maxVal.

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

Parameterar

Pdx
En pekare till ett CDataExchange objekt. Ramverket tillhandahåller det här objektet för att fastställa kontexten för datautbytet, inklusive dess riktning.

värde
En referens till en medlemsvariabel i dialogrutan, formulärvyn eller kontrollvyobjektet som data verifieras med.

minVal
Minsta tillåtna värde (av typen short) .

maxVal
Maximalt värde (av typen short) tillåts.

Anmärkningar

Mer information om DDV finns i Dialog datautbyte och validering.

Kravspecifikation

Rubrik afxdd_.h

DDV_MinMaxSlider

Anropa DDV_MinMaxSlider för att kontrollera att värdet i kontrollen som är associerad med värdet faller mellan minVal och maxVal.

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

Parameterar

Pdx
En pekare till ett CDataExchange-objekt . Ramverket tillhandahåller det här objektet för att fastställa kontexten för datautbytet, inklusive dess riktning.

värde
En referens till det värde som ska verifieras. Den här parametern innehåller eller anger skjutreglagets aktuella tumposition.

minVal
Minsta tillåtna värde.

maxVal
Högsta tillåtna värde.

Anmärkningar

Mer information om DDV finns i Dialog datautbyte och validering. Information om skjutreglagekontroller finns i Använda CSliderCtrl.

Kravspecifikation

Rubrik afxdd_.h

DDV_MinMaxUInt

Anropa DDV_MinMaxUInt för att kontrollera att värdet i kontrollen som är associerad med värdet faller mellan minVal och maxVal.

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

Parameterar

Pdx
En pekare till ett CDataExchange objekt. Ramverket tillhandahåller det här objektet för att fastställa kontexten för datautbytet, inklusive dess riktning.

värde
En referens till en medlemsvariabel i dialogrutan, formulärvyn eller kontrollvyobjektet som data verifieras med.

minVal
Lägsta tillåtna värde (av typen UINT).

maxVal
Högsta tillåtna värde (av typen UINT).

Anmärkningar

Mer information om DDV finns i Dialog datautbyte och validering.

Kravspecifikation

Rubrik afxdd_.h

DDV_MinMaxULongLong

Anropa DDV_MinMaxULongLong för att kontrollera att värdet i kontrollen som är associerad med värdet faller mellan minVal och maxVal.

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

Parameterar

Pdx
En pekare till ett CDataExchange objekt. Ramverket tillhandahåller det här objektet för att fastställa kontexten för datautbytet, inklusive dess riktning.

värde
En referens till en medlemsvariabel i dialogrutan, formulärvyn eller kontrollvyobjektet som data verifieras med.

minVal
Lägsta tillåtna värde (av typen ULONGLONG).

maxVal
Högsta tillåtna värde (av typen ULONGLONG).

Anmärkningar

Mer information om DDV finns i Dialog datautbyte och validering.

Kravspecifikation

Rubrik afxdd_.h

DDV_MinMaxUnsigned

Anropa DDV_MinMaxUnsigned för att kontrollera att värdet i kontrollen som är associerad med värdet faller mellan minVal och maxVal.

Syntax

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

Parameterar

Pdx
En pekare till ett CDataExchange objekt. Ramverket tillhandahåller det här objektet för att fastställa kontexten för datautbytet, inklusive dess riktning.

värde
En referens till en medlemsvariabel i dialogrutan, formulärvyn eller kontrollvyobjektet som data verifieras med.

minVal
Minsta tillåtna värde (av typen unsigned ) .

maxVal
Maximalt värde (av typen unsigned ) tillåts.

Anmärkningar

Mer information om DDV finns i Dialog datautbyte och validering.

Kravspecifikation

Rubrik: afxdd_.h

Se även

Standard Dialog Data Exchange-rutiner
Makro och globala variabler
DDX_Slider
DDX_FieldSlider

  • Last updated on