Standardroutinen zur Prüfung der Dialogfelddaten

  • Artikel

In diesem Thema werden die standardmäßigen DDV-Routinen (Dialog Data Validation) aufgeführt, die für allgemeine MFC-Dialogfeldsteuerelemente verwendet werden.

Hinweis

Die Standarddialogdatenaustauschroutinen werden in der Headerdatei afxdd_.h definiert. Anwendungen sollten jedoch afxwin.h enthalten.

DDV-Funktionen

Name Beschreibung
DDV_MaxChars Überprüft, wie viele Zeichen in einem bestimmten Steuerelementwert maximal zulässig sind.
DDV_MinMaxByte Überprüft, ob ein bestimmter Steuerelementwert einen bestimmten BYTE-Bereich nicht überschreitet.
DDV_MinMaxDateTime Überprüft, ob ein bestimmter Steuerelementwert einen bestimmten Zeitraum nicht überschreitet.
DDV_MinMaxDouble Überprüft, ob ein bestimmter Steuerelementwert einen bestimmten double Bereich nicht überschreitet.
DDV_MinMaxDWord Überprüft, ob ein bestimmter Steuerelementwert einen bestimmten DWORD-Bereich nicht überschreitet.
DDV_MinMaxFloat Überprüft, ob ein bestimmter Steuerelementwert einen bestimmten float Bereich nicht überschreitet.
DDV_MinMaxInt Überprüft, ob ein bestimmter Steuerelementwert einen bestimmten int Bereich nicht überschreitet.
DDV_MinMaxLong Überprüft, ob ein bestimmter Steuerelementwert einen bestimmten long Bereich nicht überschreitet.
DDV_MinMaxLongLong Überprüft, ob ein bestimmter Steuerelementwert einen bestimmten LONGLONG-Bereich nicht überschreitet.
DDV_MinMaxMonth Überprüft, ob ein gegebener Steuerelementwert einen bestimmten Datumsbereich nicht überschreitet.
DDV_MinMaxShort Überprüft, ob ein bestimmter Steuerelementwert einen bestimmten short Bereich nicht überschreitet.
DDV_MinMaxSlider Überprüft, ob ein Schieberegler-Steuerelementwert innerhalb des angegebenen Bereichs liegt.
DDV_MinMaxUInt Überprüft, ob ein bestimmter Steuerelementwert einen bestimmten UINT-Bereich nicht überschreitet.
DDV_MinMaxUnsigned Überprüft, ob ein gegebener Steuerelementwert zwischen zwei angegebenen Werten liegt.
DDV_MinMaxULongLong Überprüft, ob ein bestimmter Steuerelementwert einen bestimmten ULONGLONG-Bereich nicht überschreitet.

DDV_MaxChars

Rufen Sie DDV_MaxChars auf, um zu überprüfen, ob die Anzahl der Zeichen im steuerelement, das dem Wert zugeordnet ist, nChars nicht überschreitet.

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

Parameter

pDX
Ein Zeiger auf ein CDataExchange-Objekt. Das Framework stellt dieses Objekt bereit, um den Kontext des Datenaustauschs herzustellen, darunter seine Richtung.

value
Ein Verweis auf eine Membervariable des Dialogfelds, der Formularansicht oder des Steuerelementansichtsobjekts, mit dem Daten überprüft werden.

nChars
Maximale Anzahl zulässiger Zeichen.

Hinweise

Weitere Informationen zu DDV finden Sie unter Dialog Data Exchange and Validation.

Anforderungen

Header afxdd_.h

DDV_MinMaxByte

Rufen Sie DDV_MinMaxByte auf, um zu überprüfen, ob der Wert im steuerelement, das dem Wert zugeordnet ist, zwischen minVal und maxVal liegt.

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

Parameter

pDX
Ein Zeiger auf ein CDataExchange-Objekt. Das Framework stellt dieses Objekt bereit, um den Kontext des Datenaustauschs herzustellen, darunter seine Richtung.

value
Ein Verweis auf eine Membervariable des Dialogfelds, der Formularansicht oder des Steuerelementansichtsobjekts, mit dem Daten überprüft werden.

minVal
Minimalwert (vom Typ BYTE) zulässig.

maxVal
Maximalwert (vom Typ BYTE) zulässig.

Hinweise

Weitere Informationen zu DDV finden Sie unter Dialog Data Exchange and Validation.

Anforderungen

Header afxdd_.h

DDV_MinMaxDateTime

Rufen Sie DDV_MinMaxDateTime auf, um zu überprüfen, ob der Zeit-/Datumswert im Steuerelement für die Datums- und Uhrzeitauswahl ( CDateTimeCtrl), das refValue zugeordnet ist, zwischen refMinRange und refMaxRange liegt.

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);

Parameter

pDX
Ein Zeiger auf ein CDataExchange-Objekt . Das Framework stellt dieses Objekt bereit, um den Kontext des Datenaustauschs herzustellen, darunter seine Richtung. Sie müssen dieses Objekt nicht löschen.

refValue
Ein Verweis auf ein CTime - oder COleDateTime-Objekt , das einer Membervariable des Dialogfelds, der Formularansicht oder des Steuerelementansichtsobjekts zugeordnet ist. Dieses Objekt enthält die zu überprüfenden Daten.

refMinRange
Minimal zulässiger Datums-/Uhrzeitwert.

refMaxRange
Maximal zulässiger Datums-/Uhrzeitwert.

Hinweise

Weitere Informationen zu DDV finden Sie unter Dialog Data Exchange and Validation.

Anforderungen

Header afxdd_.h

DDV_MinMaxDouble

Rufen Sie DDV_MinMaxDouble auf, um zu überprüfen, ob der Wert im steuerelement, das dem Wert zugeordnet ist, zwischen minVal und maxVal liegt.

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

Parameter

pDX
Ein Zeiger auf ein CDataExchange-Objekt. Das Framework stellt dieses Objekt bereit, um den Kontext des Datenaustauschs herzustellen, darunter seine Richtung.

value
Ein Verweis auf eine Membervariable des Dialogfelds, der Formularansicht oder des Steuerelementansichtsobjekts, mit dem Daten überprüft werden.

minVal
Minimalwert (vom Typ double) zulässig.

maxVal
Maximalwert (vom Typ double) zulässig.

Hinweise

Weitere Informationen zu DDV finden Sie unter Dialog Data Exchange and Validation.

Anforderungen

Header afxdd_.h

DDV_MinMaxDWord

Rufen Sie DDV_MinMaxDWord auf, um zu überprüfen, ob der Wert im steuerelement, das dem Wert zugeordnet ist, zwischen minVal und maxVal liegt.

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

Parameter

pDX
Ein Zeiger auf ein CDataExchange-Objekt. Das Framework stellt dieses Objekt bereit, um den Kontext des Datenaustauschs herzustellen, darunter seine Richtung.

value
Ein Verweis auf eine Membervariable des Dialogfelds, der Formularansicht oder des Steuerelementansichtsobjekts, mit dem Daten überprüft werden.

minVal
Minimalwert (vom Typ DWORD) zulässig.

maxVal
Maximalwert (vom Typ DWORD) zulässig.

Hinweise

Weitere Informationen zu DDV finden Sie unter Dialog Data Exchange and Validation.

Anforderungen

Header afxdd_.h

DDV_MinMaxFloat

Rufen Sie DDV_MinMaxFloat auf, um zu überprüfen, ob der Wert im steuerelement, das dem Wert zugeordnet ist, zwischen minVal und maxVal liegt.

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

Parameter

pDX
Ein Zeiger auf ein CDataExchange-Objekt. Das Framework stellt dieses Objekt bereit, um den Kontext des Datenaustauschs herzustellen, darunter seine Richtung.

value
Ein Verweis auf eine Membervariable des Dialogfelds, der Formularansicht oder des Steuerelementansichtsobjekts, mit dem Daten überprüft werden.

minVal
Minimalwert (vom Typ float) zulässig.

maxVal
Maximalwert (vom Typ float) zulässig.

Hinweise

Weitere Informationen zu DDV finden Sie unter Dialog Data Exchange and Validation.

Anforderungen

Header afxdd_.h

DDV_MinMaxInt

Rufen Sie DDV_MinMaxInt auf, um zu überprüfen, ob der Wert im steuerelement, das dem Wert zugeordnet ist, zwischen minVal und maxVal liegt.

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

Parameter

pDX
Ein Zeiger auf ein CDataExchange-Objekt. Das Framework stellt dieses Objekt bereit, um den Kontext des Datenaustauschs herzustellen, darunter seine Richtung.

value
Ein Verweis auf eine Membervariable des Dialogfelds, der Formularansicht oder des Steuerelementansichtsobjekts, mit dem Daten überprüft werden.

minVal
Minimalwert (vom Typ int) zulässig.

maxVal
Maximalwert (vom Typ int) zulässig.

Hinweise

Weitere Informationen zu DDV finden Sie unter Dialog Data Exchange and Validation.

Anforderungen

Header afxdd_.h

DDV_MinMaxLong

Rufen Sie DDV_MinMaxLong auf, um zu überprüfen, ob der Wert im steuerelement, das dem Wert zugeordnet ist, zwischen minVal und maxVal liegt.

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

Parameter

pDX
Ein Zeiger auf ein CDataExchange-Objekt. Das Framework stellt dieses Objekt bereit, um den Kontext des Datenaustauschs herzustellen, darunter seine Richtung.

value
Ein Verweis auf eine Membervariable des Dialogfelds, der Formularansicht oder des Steuerelementansichtsobjekts, mit dem Daten überprüft werden.

minVal
Minimalwert (vom Typ long) zulässig.

maxVal
Maximalwert (vom Typ long) zulässig.

Hinweise

Weitere Informationen zu DDV finden Sie unter Dialog Data Exchange and Validation.

Anforderungen

Header afxdd_.h

DDV_MinMaxLongLong

Rufen Sie DDV_MinMaxLongLong auf, um zu überprüfen, ob der Wert im steuerelement, das dem Wert zugeordnet ist, zwischen minVal und maxVal liegt.

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

Parameter

pDX
Ein Zeiger auf ein CDataExchange-Objekt. Das Framework stellt dieses Objekt bereit, um den Kontext des Datenaustauschs herzustellen, darunter seine Richtung.

value
Ein Verweis auf eine Membervariable des Dialogfelds, der Formularansicht oder des Steuerelementansichtsobjekts, mit dem Daten überprüft werden.

minVal
Minimalwert (vom Typ LONGLONG) zulässig.

maxVal
Maximalwert (vom Typ LONGLONG) zulässig.

Hinweise

Weitere Informationen zu DDV finden Sie unter Dialog Data Exchange and Validation.

Anforderungen

Header afxdd_.h

DDV_MinMaxMonth

Rufen Sie DDV_MinMaxMonth auf, um zu überprüfen, ob der Zeit-/Datumswert im Monatskalendersteuerelement ( CMonthCalCtrl), das refValue zugeordnet ist, zwischen refMinRange und refMaxRange liegt.

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);

Parameter

pDX
Ein Zeiger auf ein CDataExchange-Objekt . Das Framework stellt dieses Objekt bereit, um den Kontext des Datenaustauschs herzustellen, darunter seine Richtung.

refValue
Ein Verweis auf ein Objekt vom Typ CTime oder COleDateTime einem Elementvariablen des Dialogfelds, der Formularansicht oder des Steuerelementansichtsobjekts. Dieses Objekt enthält die zu überprüfenden Daten. MFC übergibt diesen Verweis, wenn DDV_MinMaxMonth er aufgerufen wird.

refMinRange
Minimal zulässiger Datums-/Uhrzeitwert.

refMaxRange
Maximal zulässiger Datums-/Uhrzeitwert.

Hinweise

Weitere Informationen zu DDV finden Sie unter Dialog Data Exchange and Validation.

Anforderungen

Header afxdd_.h

DDV_MinMaxShort

Rufen Sie DDV_MinMaxShort auf, um zu überprüfen, ob der Wert im steuerelement, das dem Wert zugeordnet ist, zwischen minVal und maxVal liegt.

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

Parameter

pDX
Ein Zeiger auf ein CDataExchange-Objekt. Das Framework stellt dieses Objekt bereit, um den Kontext des Datenaustauschs herzustellen, darunter seine Richtung.

value
Ein Verweis auf eine Membervariable des Dialogfelds, der Formularansicht oder des Steuerelementansichtsobjekts, mit dem Daten überprüft werden.

minVal
Minimalwert (vom Typ short) zulässig.

maxVal
Maximalwert (vom Typ short) zulässig.

Hinweise

Weitere Informationen zu DDV finden Sie unter Dialog Data Exchange and Validation.

Anforderungen

Header afxdd_.h

DDV_MinMaxSlider

Rufen Sie DDV_MinMaxSlider auf, um zu überprüfen, ob der Wert im steuerelement, das dem Wert zugeordnet ist, zwischen minVal und maxVal liegt.

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

Parameter

pDX
Ein Zeiger auf ein CDataExchange-Objekt . Das Framework stellt dieses Objekt bereit, um den Kontext des Datenaustauschs herzustellen, darunter seine Richtung.

value
Ein Verweis auf den zu überprüfenden Wert. Dieser Parameter enthält oder legt die aktuelle Daumenposition des Schiebereglersteuerelements fest.

minVal
Minimalwert zulässig.

maxVal
Maximal zulässiger Wert.

Hinweise

Weitere Informationen zu DDV finden Sie unter Dialog Data Exchange and Validation. Informationen zu Schiebereglersteuerelementen finden Sie unter Verwenden von CSliderCtrl.

Anforderungen

Header afxdd_.h

DDV_MinMaxUInt

Rufen Sie DDV_MinMaxUInt auf, um zu überprüfen, ob der Wert im steuerelement, das dem Wert zugeordnet ist, zwischen minVal und maxVal liegt.

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

Parameter

pDX
Ein Zeiger auf ein CDataExchange-Objekt. Das Framework stellt dieses Objekt bereit, um den Kontext des Datenaustauschs herzustellen, darunter seine Richtung.

value
Ein Verweis auf eine Membervariable des Dialogfelds, der Formularansicht oder des Steuerelementansichtsobjekts, mit dem Daten überprüft werden.

minVal
Minimalwert (vom Typ UINT) zulässig.

maxVal
Maximalwert (vom Typ UINT) zulässig.

Hinweise

Weitere Informationen zu DDV finden Sie unter Dialog Data Exchange and Validation.

Anforderungen

Header afxdd_.h

DDV_MinMaxULongLong

Rufen Sie DDV_MinMaxULongLong auf, um zu überprüfen, ob der Wert im steuerelement, das dem Wert zugeordnet ist, zwischen minVal und maxVal liegt.

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

Parameter

pDX
Ein Zeiger auf ein CDataExchange-Objekt. Das Framework stellt dieses Objekt bereit, um den Kontext des Datenaustauschs herzustellen, darunter seine Richtung.

value
Ein Verweis auf eine Membervariable des Dialogfelds, der Formularansicht oder des Steuerelementansichtsobjekts, mit dem Daten überprüft werden.

minVal
Minimalwert (vom Typ ULONGLONG) zulässig.

maxVal
Maximalwert (vom Typ ULONGLONG) zulässig.

Hinweise

Weitere Informationen zu DDV finden Sie unter Dialog Data Exchange and Validation.

Anforderungen

Header afxdd_.h

DDV_MinMaxUnsigned

Rufen Sie DDV_MinMaxUnsigned auf, um zu überprüfen, ob der Wert im steuerelement, das dem Wert zugeordnet ist, zwischen minVal und maxVal liegt.

Syntax

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

Parameter

pDX
Ein Zeiger auf ein CDataExchange-Objekt. Das Framework stellt dieses Objekt bereit, um den Kontext des Datenaustauschs herzustellen, darunter seine Richtung.

value
Ein Verweis auf eine Membervariable des Dialogfelds, der Formularansicht oder des Steuerelementansichtsobjekts, mit dem Daten überprüft werden.

minVal
Minimalwert (vom Typ unsigned ) zulässig.

maxVal
Maximalwert (vom Typ unsigned ) zulässig.

Hinweise

Weitere Informationen zu DDV finden Sie unter Dialog Data Exchange and Validation.

Anforderungen

Kopfzeile: afxdd_.h

Siehe auch

Standard-Dialogdatenaustauschroutinen
Makros und Globalen
DDX_Slider
DDX_FieldSlider