Sdílet prostřednictvím

Rutiny ověřování dat standardního dialogového okna

  • Článek

Toto téma uvádí standardní rutiny ověřování dat dialogového okna (DDV) používané pro běžné ovládací prvky dialogového okna MFC.

Poznámka:

Standardní rutiny výměny dat dialogového okna jsou definovány v souboru hlaviček afxdd_.h. Aplikace by ale měly obsahovat afxwin.h.

Funkce DDV

Název Popis
DDV_MaxChars Ověří počet znaků v dané hodnotě ovládacího prvku, který nepřekračuje dané maximum.
DDV_MinMaxByte Ověří, že daná hodnota ovládacího prvku nepřekračuje daný rozsah BYTE .
DDV_MinMaxDateTime Ověří, že daná hodnota ovládacího prvku nepřekračuje daný časový rozsah.
DDV_MinMaxDouble Ověří, že daná hodnota ovládacího prvku nepřekračuje daný double rozsah.
DDV_MinMaxDWord Ověří, že daná hodnota ovládacího prvku nepřekračuje daný rozsah DWORD .
DDV_MinMaxFloat Ověří, že daná hodnota ovládacího prvku nepřekračuje daný float rozsah.
DDV_MinMaxInt Ověří, že daná hodnota ovládacího prvku nepřekračuje daný int rozsah.
DDV_MinMaxLong Ověří, že daná hodnota ovládacího prvku nepřekračuje daný long rozsah.
DDV_MinMaxLongLong Ověří, že daná hodnota ovládacího prvku nepřekračuje daný rozsah LONGLONG .
DDV_MinMaxMonth Ověří, že daná hodnota ovládacího prvku nepřekračuje daný rozsah kalendářních dat.
DDV_MinMaxShort Ověří, že daná hodnota ovládacího prvku nepřekračuje daný short rozsah.
DDV_MinMaxSlider Ověří, že daná hodnota ovládacího prvku posuvníku spadá do daného rozsahu.
DDV_MinMaxUInt Ověří, že daná hodnota ovládacího prvku nepřekračuje danou oblast UINT .
DDV_MinMaxUnsigned Ověří, že daná hodnota ovládacího prvku spadá mezi dvě zadané hodnoty.
DDV_MinMaxULongLong Ověří, že daná hodnota ovládacího prvku nepřekračuje danou oblast ULONGLONG .

DDV_MaxChars

Voláním DDV_MaxChars ověřte, že množství znaků v ovládacím prvku přidruženém k hodnotě nepřekračuje nChars.

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

Parametry

pDX
Ukazatel na CDataExchange objekt. Architektura poskytuje tento objekt k vytvoření kontextu výměny dat, včetně jeho směru.

value
Odkaz na členovou proměnnou dialogového okna, zobrazení formuláře nebo objektu zobrazení ovládacího prvku, pomocí kterého jsou data ověřena.

nChars
Maximální povolený počet znaků

Poznámky

Další informace o DDV naleznete v tématu Výměna a ověření dat dialogového okna.

Požadavky

Hlavička afxdd_.h

DDV_MinMaxByte

Voláním DDV_MinMaxByte ověřte, že hodnota v ovládacím prvku přidruženém k hodnotě spadá mezi minVal a maxVal.

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

Parametry

pDX
Ukazatel na CDataExchange objekt. Architektura poskytuje tento objekt k vytvoření kontextu výměny dat, včetně jeho směru.

value
Odkaz na členovou proměnnou dialogového okna, zobrazení formuláře nebo objektu zobrazení ovládacího prvku, pomocí kterého jsou data ověřena.

minVal
Minimální povolená hodnota (typu BYTE).

maxVal
Maximální povolená hodnota (typu BYTE).

Poznámky

Další informace o DDV naleznete v tématu Výměna a ověření dat dialogového okna.

Požadavky

Hlavička afxdd_.h

DDV_MinMaxDateTime

Voláním DDV_MinMaxDateTime ověřte, zda hodnota času a data v ovládacím prvku pro výběr data a času ( CDateTimeCtrl) přidružená k refValue spadá mezi refMinRange a 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
Ukazatel na objekt CDataExchange . Architektura poskytuje tento objekt k vytvoření kontextu výměny dat, včetně jeho směru. Tento objekt nemusíte odstraňovat.

refValue
Odkaz na objekt CTime nebo COleDateTime přidružený k členské proměnné dialogového okna, zobrazení formuláře nebo objektu ovládacího prvku zobrazení. Tento objekt obsahuje data, která se mají ověřit.

refMinRange
Minimální povolená hodnota data a času

refMaxRange
Maximální povolená hodnota data a času

Poznámky

Další informace o DDV naleznete v tématu Výměna a ověření dat dialogového okna.

Požadavky

Hlavička afxdd_.h

DDV_MinMaxDouble

Voláním DDV_MinMaxDouble ověřte, že hodnota v ovládacím prvku přidruženém k hodnotě spadá mezi minVal a maxVal.

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

Parametry

pDX
Ukazatel na CDataExchange objekt. Architektura poskytuje tento objekt k vytvoření kontextu výměny dat, včetně jeho směru.

value
Odkaz na členovou proměnnou dialogového okna, zobrazení formuláře nebo objektu zobrazení ovládacího prvku, pomocí kterého jsou data ověřena.

minVal
Povolená minimální hodnota (typu double).

maxVal
Maximální povolená hodnota (typu double).

Poznámky

Další informace o DDV naleznete v tématu Výměna a ověření dat dialogového okna.

Požadavky

Hlavička afxdd_.h

DDV_MinMaxDWord

Voláním DDV_MinMaxDWord ověřte, že hodnota v ovládacím prvku přidruženém k hodnotě spadá mezi minVal a maxVal.

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

Parametry

pDX
Ukazatel na CDataExchange objekt. Architektura poskytuje tento objekt k vytvoření kontextu výměny dat, včetně jeho směru.

value
Odkaz na členovou proměnnou dialogového okna, zobrazení formuláře nebo objektu zobrazení ovládacího prvku, pomocí kterého jsou data ověřena.

minVal
Minimální povolená hodnota (typu DWORD).

maxVal
Maximální povolená hodnota (typu DWORD).

Poznámky

Další informace o DDV naleznete v tématu Výměna a ověření dat dialogového okna.

Požadavky

Hlavička afxdd_.h

DDV_MinMaxFloat

Voláním DDV_MinMaxFloat ověřte, že hodnota v ovládacím prvku přidruženém k hodnotě spadá mezi minVal a maxVal.

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

Parametry

pDX
Ukazatel na CDataExchange objekt. Architektura poskytuje tento objekt k vytvoření kontextu výměny dat, včetně jeho směru.

value
Odkaz na členovou proměnnou dialogového okna, zobrazení formuláře nebo objektu zobrazení ovládacího prvku, pomocí kterého jsou data ověřena.

minVal
Povolená minimální hodnota (typu float).

maxVal
Maximální povolená hodnota (typu float).

Poznámky

Další informace o DDV naleznete v tématu Výměna a ověření dat dialogového okna.

Požadavky

Hlavička afxdd_.h

DDV_MinMaxInt

Voláním DDV_MinMaxInt ověřte, že hodnota v ovládacím prvku přidruženém k hodnotě spadá mezi minVal a maxVal.

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

Parametry

pDX
Ukazatel na CDataExchange objekt. Architektura poskytuje tento objekt k vytvoření kontextu výměny dat, včetně jeho směru.

value
Odkaz na členovou proměnnou dialogového okna, zobrazení formuláře nebo objektu zobrazení ovládacího prvku, pomocí kterého jsou data ověřena.

minVal
Povolená minimální hodnota (typu int).

maxVal
Maximální povolená hodnota (typu int).

Poznámky

Další informace o DDV naleznete v tématu Výměna a ověření dat dialogového okna.

Požadavky

Hlavička afxdd_.h

DDV_MinMaxLong

Voláním DDV_MinMaxLong ověřte, že hodnota v ovládacím prvku přidruženém k hodnotě spadá mezi minVal a maxVal.

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

Parametry

pDX
Ukazatel na CDataExchange objekt. Architektura poskytuje tento objekt k vytvoření kontextu výměny dat, včetně jeho směru.

value
Odkaz na členovou proměnnou dialogového okna, zobrazení formuláře nebo objektu zobrazení ovládacího prvku, pomocí kterého jsou data ověřena.

minVal
Povolená minimální hodnota (typu long).

maxVal
Maximální povolená hodnota (typu long).

Poznámky

Další informace o DDV naleznete v tématu Výměna a ověření dat dialogového okna.

Požadavky

Hlavička afxdd_.h

DDV_MinMaxLongLong

Voláním DDV_MinMaxLongLong ověřte, že hodnota v ovládacím prvku přidruženém k hodnotě spadá mezi minVal a maxVal.

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

Parametry

pDX
Ukazatel na CDataExchange objekt. Architektura poskytuje tento objekt k vytvoření kontextu výměny dat, včetně jeho směru.

value
Odkaz na členovou proměnnou dialogového okna, zobrazení formuláře nebo objektu zobrazení ovládacího prvku, pomocí kterého jsou data ověřena.

minVal
Minimální povolená hodnota (typu LONGLONG).

maxVal
Maximální povolená hodnota (typu LONGLONG).

Poznámky

Další informace o DDV naleznete v tématu Výměna a ověření dat dialogového okna.

Požadavky

Hlavička afxdd_.h

DDV_MinMaxMonth

Voláním DDV_MinMaxMonth ověřte, že hodnota času a data v ovládacím prvku kalendáře měsíce ( CMonthCalCtrl) přidružená k refValue spadá mezi refMinRange a 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
Ukazatel na objekt CDataExchange . Architektura poskytuje tento objekt k vytvoření kontextu výměny dat, včetně jeho směru.

refValue
Odkaz na objekt typu CTime nebo COleDateTime přidružený k členské proměnné dialogového okna, zobrazení formuláře nebo objektu ovládacího prvku zobrazení. Tento objekt obsahuje data, která se mají ověřit. MFC předá tento odkaz při DDV_MinMaxMonth zavolání.

refMinRange
Minimální povolená hodnota data a času

refMaxRange
Maximální povolená hodnota data a času

Poznámky

Další informace o DDV naleznete v tématu Výměna a ověření dat dialogového okna.

Požadavky

Hlavička afxdd_.h

DDV_MinMaxShort

Voláním DDV_MinMaxShort ověřte, že hodnota v ovládacím prvku přidruženém k hodnotě spadá mezi minVal a maxVal.

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

Parametry

pDX
Ukazatel na CDataExchange objekt. Architektura poskytuje tento objekt k vytvoření kontextu výměny dat, včetně jeho směru.

value
Odkaz na členovou proměnnou dialogového okna, zobrazení formuláře nebo objektu zobrazení ovládacího prvku, pomocí kterého jsou data ověřena.

minVal
Povolená minimální hodnota (typu short).

maxVal
Maximální povolená hodnota (typu short).

Poznámky

Další informace o DDV naleznete v tématu Výměna a ověření dat dialogového okna.

Požadavky

Hlavička afxdd_.h

DDV_MinMaxSlider

Voláním DDV_MinMaxSlider ověřte, že hodnota v ovládacím prvku přidruženém k hodnotě spadá mezi minVal a maxVal.

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

Parametry

pDX
Ukazatel na objekt CDataExchange . Architektura poskytuje tento objekt k vytvoření kontextu výměny dat, včetně jeho směru.

value
Odkaz na hodnotu, která se má ověřit. Tento parametr uchovává nebo nastavuje aktuální pozici ovládacího prvku posuvníku.

minVal
Minimální povolená hodnota.

maxVal
Maximální povolená hodnota.

Poznámky

Další informace o DDV naleznete v tématu Výměna a ověření dat dialogového okna. Informace o ovládacích prvcích posuvníku naleznete v tématu Použití atributu CSliderCtrl.

Požadavky

Hlavička afxdd_.h

DDV_MinMaxUInt

Voláním DDV_MinMaxUInt ověřte, že hodnota v ovládacím prvku přidruženém k hodnotě spadá mezi minVal a maxVal.

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

Parametry

pDX
Ukazatel na CDataExchange objekt. Architektura poskytuje tento objekt k vytvoření kontextu výměny dat, včetně jeho směru.

value
Odkaz na členovou proměnnou dialogového okna, zobrazení formuláře nebo objektu zobrazení ovládacího prvku, pomocí kterého jsou data ověřena.

minVal
Minimální povolená hodnota (typu UINT).

maxVal
Maximální povolená hodnota (typu UINT).

Poznámky

Další informace o DDV naleznete v tématu Výměna a ověření dat dialogového okna.

Požadavky

Hlavička afxdd_.h

DDV_MinMaxULongLong

Voláním DDV_MinMaxULongLong ověřte, že hodnota v ovládacím prvku přidruženém k hodnotě spadá mezi minVal a maxVal.

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

Parametry

pDX
Ukazatel na CDataExchange objekt. Architektura poskytuje tento objekt k vytvoření kontextu výměny dat, včetně jeho směru.

value
Odkaz na členovou proměnnou dialogového okna, zobrazení formuláře nebo objektu zobrazení ovládacího prvku, pomocí kterého jsou data ověřena.

minVal
Minimální hodnota (typu ULONGLONG) povolená.

maxVal
Maximální povolená hodnota (typu ULONGLONG).

Poznámky

Další informace o DDV naleznete v tématu Výměna a ověření dat dialogového okna.

Požadavky

Hlavička afxdd_.h

DDV_MinMaxUnsigned

Voláním DDV_MinMaxUnsigned ověřte, že hodnota v ovládacím prvku přidruženém k hodnotě spadá mezi minVal a maxVal.

Syntaxe

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

Parametry

pDX
Ukazatel na CDataExchange objekt. Architektura poskytuje tento objekt k vytvoření kontextu výměny dat, včetně jeho směru.

value
Odkaz na členovou proměnnou dialogového okna, zobrazení formuláře nebo objektu zobrazení ovládacího prvku, pomocí kterého jsou data ověřena.

minVal
Povolená minimální hodnota (typu unsigned ).

maxVal
Maximální povolená hodnota (typu unsigned ).

Poznámky

Další informace o DDV naleznete v tématu Výměna a ověření dat dialogového okna.

Požadavky

Hlavička: afxdd_.h

Viz také

Rutiny výměny dat standardního dialogového okna
Makra a globální objekty
DDX_Slider
DDX_FieldSlider