Standardowe procedury walidacji danych okna dialogowego

W tym temacie wymieniono standardowe procedury weryfikacji danych okna dialogowego (DDV) używane dla typowych kontrolek okien dialogowych MFC.

Uwaga

Standardowe procedury wymiany danych okna dialogowego są definiowane w pliku nagłówka afxdd_.h. Jednak aplikacje powinny zawierać afxwin.h.

Funkcje DDV

Nazwa/nazwisko	opis
DDV_MaxChars	Sprawdza, czy liczba znaków w danej wartości kontrolki nie przekracza podanej wartości maksymalnej.
DDV_MinMaxByte	Sprawdza, czy dana wartość kontrolki nie przekracza danego zakresu BYTE .
DDV_MinMaxDateTime	Sprawdza, czy dana wartość kontrolki nie przekracza danego zakresu czasu.
DDV_MinMaxDouble	Sprawdza, czy dana wartość kontrolki nie przekracza danego double zakresu.
DDV_MinMaxDWord	Sprawdza, czy dana wartość kontrolki nie przekracza danego zakresu DWORD .
DDV_MinMaxFloat	Sprawdza, czy dana wartość kontrolki nie przekracza danego float zakresu.
DDV_MinMaxInt	Sprawdza, czy dana wartość kontrolki nie przekracza danego int zakresu.
DDV_MinMaxLong	Sprawdza, czy dana wartość kontrolki nie przekracza danego long zakresu.
DDV_MinMaxLongLong	Sprawdza, czy dana wartość kontrolki nie przekracza danego zakresu LONGLONG .
DDV_MinMaxMonth	Sprawdza, czy dana wartość kontrolki nie przekracza danego zakresu dat.
DDV_MinMaxShort	Sprawdza, czy dana wartość kontrolki nie przekracza danego short zakresu.
DDV_MinMaxSlider	Sprawdza, czy dana wartość kontrolki suwaka mieści się w danym zakresie.
DDV_MinMaxUInt	Sprawdza, czy dana wartość kontrolki nie przekracza danego zakresu UINT .
DDV_MinMaxUnsigned	Sprawdza, czy dana wartość kontrolki mieści się między dwiema określonymi wartościami.
DDV_MinMaxULongLong	Sprawdza, czy dana wartość kontrolki nie przekracza danego zakresu ULONGLONG .

DDV_MaxChars

Wywołaj metodę DDV_MaxChars , aby sprawdzić, czy liczba znaków w kontrolce skojarzonej z wartością nie przekracza nChars.

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

Parametry

pDX
Wskaźnik do CDataExchange obiektu. Struktura dostarcza ten obiekt w celu ustanowienia kontekstu wymiany danych, w tym jego kierunku.

wartość
Odwołanie do zmiennej składowej okna dialogowego, widoku formularza lub obiektu widoku kontrolki, z którym są weryfikowane dane.

nChars
Dozwolona maksymalna liczba znaków.

Uwagi

Aby uzyskać więcej informacji na temat DDV, zobacz Dialog Data Exchange and Validation (Wymiana danych w oknie dialogowym i walidacja).

Wymagania

Nagłówek afxdd_.h

DDV_MinMaxByte

Wywołaj metodę DDV_MinMaxByte , aby sprawdzić, czy wartość w kontrolce skojarzonej z wartością spadnie między wartością minVal i maxVal.

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

Parametry

pDX
Wskaźnik do CDataExchange obiektu. Struktura dostarcza ten obiekt w celu ustanowienia kontekstu wymiany danych, w tym jego kierunku.

wartość
Odwołanie do zmiennej składowej okna dialogowego, widoku formularza lub obiektu widoku kontrolki, z którym są weryfikowane dane.

minVal
Dozwolona wartość minimalna (typu BYTE).

maxVal
Dozwolona wartość maksymalna (typu BYTE).

Uwagi

Aby uzyskać więcej informacji na temat DDV, zobacz Dialog Data Exchange and Validation (Wymiana danych w oknie dialogowym i walidacja).

Wymagania

Nagłówek afxdd_.h

DDV_MinMaxDateTime

Wywołaj metodę DDV_MinMaxDateTime , aby sprawdzić, czy wartość godziny/daty w kontrolce selektora daty i godziny (CDateTimeCtrl) skojarzona z wartością refValue przypada między elementami refMinRange i 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);

Parametry

pDX
Wskaźnik do obiektu CDataExchange . Struktura dostarcza ten obiekt w celu ustanowienia kontekstu wymiany danych, w tym jego kierunku. Nie musisz usuwać tego obiektu.

refValue
Odwołanie do obiektu CTime lub COleDateTime skojarzonego ze zmienną składową okna dialogowego, widoku formularza lub obiektu widoku kontrolki. Ten obiekt zawiera dane do zweryfikowania.

refMinRange
Dozwolona minimalna wartość daty/godziny.

refMaxRange
Dozwolona maksymalna wartość daty/godziny.

Uwagi

Aby uzyskać więcej informacji na temat DDV, zobacz Dialog Data Exchange and Validation (Wymiana danych w oknie dialogowym i walidacja).

Wymagania

Nagłówek afxdd_.h

DDV_MinMaxDouble

Wywołaj metodę DDV_MinMaxDouble , aby sprawdzić, czy wartość w kontrolce skojarzonej z wartością spadnie między wartością minVal i maxVal.

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

Parametry

pDX
Wskaźnik do CDataExchange obiektu. Struktura dostarcza ten obiekt w celu ustanowienia kontekstu wymiany danych, w tym jego kierunku.

wartość
Odwołanie do zmiennej składowej okna dialogowego, widoku formularza lub obiektu widoku kontrolki, z którym są weryfikowane dane.

minVal
Dozwolona wartość minimalna (typu double).

maxVal
Dozwolona wartość maksymalna (typu double).

Uwagi

Aby uzyskać więcej informacji na temat DDV, zobacz Dialog Data Exchange and Validation (Wymiana danych w oknie dialogowym i walidacja).

Wymagania

Nagłówek afxdd_.h

DDV_MinMaxDWord

Wywołaj metodę DDV_MinMaxDWord , aby sprawdzić, czy wartość w kontrolce skojarzonej z wartością spadnie między wartością minVal i maxVal.

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

Parametry

pDX
Wskaźnik do CDataExchange obiektu. Struktura dostarcza ten obiekt w celu ustanowienia kontekstu wymiany danych, w tym jego kierunku.

wartość
Odwołanie do zmiennej składowej okna dialogowego, widoku formularza lub obiektu widoku kontrolki, z którym są weryfikowane dane.

minVal
Dozwolona wartość minimalna (typu DWORD).

maxVal
Dozwolona maksymalna wartość (typu DWORD).

Uwagi

Aby uzyskać więcej informacji na temat DDV, zobacz Dialog Data Exchange and Validation (Wymiana danych w oknie dialogowym i walidacja).

Wymagania

Nagłówek afxdd_.h

DDV_MinMaxFloat

Wywołaj metodę DDV_MinMaxFloat , aby sprawdzić, czy wartość w kontrolce skojarzonej z wartością spadnie między wartością minVal i maxVal.

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

Parametry

pDX
Wskaźnik do CDataExchange obiektu. Struktura dostarcza ten obiekt w celu ustanowienia kontekstu wymiany danych, w tym jego kierunku.

wartość
Odwołanie do zmiennej składowej okna dialogowego, widoku formularza lub obiektu widoku kontrolki, z którym są weryfikowane dane.

minVal
Dozwolona wartość minimalna (typu float).

maxVal
Dozwolona wartość maksymalna (typu float).

Uwagi

Aby uzyskać więcej informacji na temat DDV, zobacz Dialog Data Exchange and Validation (Wymiana danych w oknie dialogowym i walidacja).

Wymagania

Nagłówek afxdd_.h

DDV_MinMaxInt

Wywołaj metodę DDV_MinMaxInt , aby sprawdzić, czy wartość w kontrolce skojarzonej z wartością spadnie między wartością minVal i maxVal.

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

Parametry

pDX
Wskaźnik do CDataExchange obiektu. Struktura dostarcza ten obiekt w celu ustanowienia kontekstu wymiany danych, w tym jego kierunku.

wartość
Odwołanie do zmiennej składowej okna dialogowego, widoku formularza lub obiektu widoku kontrolki, z którym są weryfikowane dane.

minVal
Dozwolona wartość minimalna (typu int).

maxVal
Dozwolona wartość maksymalna (typu int).

Uwagi

Aby uzyskać więcej informacji na temat DDV, zobacz Dialog Data Exchange and Validation (Wymiana danych w oknie dialogowym i walidacja).

Wymagania

Nagłówek afxdd_.h

DDV_MinMaxLong

Wywołaj metodę DDV_MinMaxLong , aby sprawdzić, czy wartość w kontrolce skojarzonej z wartością spadnie między wartością minVal i maxVal.

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

Parametry

pDX
Wskaźnik do CDataExchange obiektu. Struktura dostarcza ten obiekt w celu ustanowienia kontekstu wymiany danych, w tym jego kierunku.

wartość
Odwołanie do zmiennej składowej okna dialogowego, widoku formularza lub obiektu widoku kontrolki, z którym są weryfikowane dane.

minVal
Dozwolona wartość minimalna (typu long).

maxVal
Dozwolona wartość maksymalna (typu long).

Uwagi

Aby uzyskać więcej informacji na temat DDV, zobacz Dialog Data Exchange and Validation (Wymiana danych w oknie dialogowym i walidacja).

Wymagania

Nagłówek afxdd_.h

DDV_MinMaxLongLong

Wywołaj metodę DDV_MinMaxLongLong , aby sprawdzić, czy wartość w kontrolce skojarzonej z wartością spadnie między wartością minVal i maxVal.

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

Parametry

pDX
Wskaźnik do CDataExchange obiektu. Struktura dostarcza ten obiekt w celu ustanowienia kontekstu wymiany danych, w tym jego kierunku.

wartość
Odwołanie do zmiennej składowej okna dialogowego, widoku formularza lub obiektu widoku kontrolki, z którym są weryfikowane dane.

minVal
Dozwolona wartość minimalna (typu LONGLONG).

maxVal
Dozwolona maksymalna wartość (typu LONGLONG).

Uwagi

Aby uzyskać więcej informacji na temat DDV, zobacz Dialog Data Exchange and Validation (Wymiana danych w oknie dialogowym i walidacja).

Wymagania

Nagłówek afxdd_.h

DDV_MinMaxMonth

Wywołaj metodę DDV_MinMaxMonth , aby sprawdzić, czy wartość godziny/daty w kontrolce kalendarza miesiąca (CMonthCalCtrl) skojarzona z wartością refValue mieści się między wartościami refMinRange i 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);

Parametry

pDX
Wskaźnik do obiektu CDataExchange . Struktura dostarcza ten obiekt w celu ustanowienia kontekstu wymiany danych, w tym jego kierunku.

refValue
Odwołanie do obiektu typu CTime lub COleDateTime skojarzonego ze zmienną składową okna dialogowego, widoku formularza lub obiektu widoku kontrolki. Ten obiekt zawiera dane do zweryfikowania. MFC przekazuje to odwołanie, gdy DDV_MinMaxMonth jest wywoływane.

refMinRange
Dozwolona minimalna wartość daty/godziny.

refMaxRange
Dozwolona maksymalna wartość daty/godziny.

Uwagi

Aby uzyskać więcej informacji na temat DDV, zobacz Dialog Data Exchange and Validation (Wymiana danych w oknie dialogowym i walidacja).

Wymagania

Nagłówek afxdd_.h

DDV_MinMaxShort

Wywołaj metodę DDV_MinMaxShort , aby sprawdzić, czy wartość w kontrolce skojarzonej z wartością spadnie między wartością minVal i maxVal.

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

Parametry

pDX
Wskaźnik do CDataExchange obiektu. Struktura dostarcza ten obiekt w celu ustanowienia kontekstu wymiany danych, w tym jego kierunku.

wartość
Odwołanie do zmiennej składowej okna dialogowego, widoku formularza lub obiektu widoku kontrolki, z którym są weryfikowane dane.

minVal
Dozwolona wartość minimalna (typu short).

maxVal
Dozwolona wartość maksymalna (typu short).

Uwagi

Aby uzyskać więcej informacji na temat DDV, zobacz Dialog Data Exchange and Validation (Wymiana danych w oknie dialogowym i walidacja).

Wymagania

Nagłówek afxdd_.h

DDV_MinMaxSlider

Wywołaj metodę DDV_MinMaxSlider , aby sprawdzić, czy wartość w kontrolce skojarzonej z wartością spadnie między wartością minVal i maxVal.

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

Parametry

pDX
Wskaźnik do obiektu CDataExchange . Struktura dostarcza ten obiekt w celu ustanowienia kontekstu wymiany danych, w tym jego kierunku.

wartość
Odwołanie do wartości, która ma zostać zweryfikowana. Ten parametr przechowuje lub ustawia bieżącą pozycję kciuka kontrolki suwaka.

minVal
Dozwolona wartość minimalna.

maxVal
Dozwolona wartość maksymalna.

Uwagi

Aby uzyskać więcej informacji na temat DDV, zobacz Dialog Data Exchange and Validation (Wymiana danych w oknie dialogowym i walidacja). Aby uzyskać informacje na temat kontrolek suwaka, zobacz Using CSliderCtrl (Korzystanie z CSliderCtrl).

Wymagania

Nagłówek afxdd_.h

DDV_MinMaxUInt

Wywołaj metodę DDV_MinMaxUInt , aby sprawdzić, czy wartość w kontrolce skojarzonej z wartością spadnie między wartością minVal i maxVal.

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

Parametry

pDX
Wskaźnik do CDataExchange obiektu. Struktura dostarcza ten obiekt w celu ustanowienia kontekstu wymiany danych, w tym jego kierunku.

wartość
Odwołanie do zmiennej składowej okna dialogowego, widoku formularza lub obiektu widoku kontrolki, z którym są weryfikowane dane.

minVal
Dozwolona wartość minimalna (typu UINT).

maxVal
Dozwolona maksymalna wartość (typu UINT).

Uwagi

Aby uzyskać więcej informacji na temat DDV, zobacz Dialog Data Exchange and Validation (Wymiana danych w oknie dialogowym i walidacja).

Wymagania

Nagłówek afxdd_.h

DDV_MinMaxULongLong

Wywołaj metodę DDV_MinMaxULongLong , aby sprawdzić, czy wartość w kontrolce skojarzonej z wartością spadnie między wartością minVal i maxVal.

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

Parametry

pDX
Wskaźnik do CDataExchange obiektu. Struktura dostarcza ten obiekt w celu ustanowienia kontekstu wymiany danych, w tym jego kierunku.

wartość
Odwołanie do zmiennej składowej okna dialogowego, widoku formularza lub obiektu widoku kontrolki, z którym są weryfikowane dane.

minVal
Dozwolona wartość minimalna (typu ULONGLONG).

maxVal
Dozwolona wartość maksymalna (typu ULONGLONG).

Uwagi

Aby uzyskać więcej informacji na temat DDV, zobacz Dialog Data Exchange and Validation (Wymiana danych w oknie dialogowym i walidacja).

Wymagania

Nagłówek afxdd_.h

DDV_MinMaxUnsigned

Wywołaj metodę DDV_MinMaxUnsigned , aby sprawdzić, czy wartość w kontrolce skojarzonej z wartością spadnie między wartością minVal i maxVal.

Składnia

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

Parametry

pDX
Wskaźnik do CDataExchange obiektu. Struktura dostarcza ten obiekt w celu ustanowienia kontekstu wymiany danych, w tym jego kierunku.

wartość
Odwołanie do zmiennej składowej okna dialogowego, widoku formularza lub obiektu widoku kontrolki, z którym są weryfikowane dane.

minVal
Dozwolona wartość minimalna (typu unsigned ).

maxVal
Dozwolona wartość maksymalna (typu unsigned ).

Uwagi

Aby uzyskać więcej informacji na temat DDV, zobacz Dialog Data Exchange and Validation (Wymiana danych w oknie dialogowym i walidacja).

Wymagania

Nagłówek: afxdd_.h

Zobacz też

Standardowe procedury wymiany danych w oknie dialogowym
Makra i globalne
DDX_Slider
DDX_FieldSlider