Стандартные программы проверки данных диалоговых окон

В этом разделе перечислены стандартные подпрограммы проверки данных диалоговых окон (DDV), используемые для распространенных элементов управления диалоговым окном MFC.

Примечание.

Стандартные подпрограммы обмена данными диалоговых окон определяются в файле заголовка afxdd_.h. Однако приложения должны включать afxwin.h.

Функции DDV

Имя	Описание
DDV_MaxChars	Проверяет количество символов в заданном значении элемента управления не превышает заданное максимальное значение.
DDV_MinMaxByte	Проверяет заданное значение элемента управления не превышает заданный диапазон BYTE .
DDV_MinMaxDateTime	Проверяет заданное значение элемента управления не превышает заданный диапазон времени.
DDV_MinMaxDouble	Проверяет заданное значение элемента управления не превышает заданный double диапазон.
DDV_MinMaxDWord	Проверяет заданное значение элемента управления не превышает заданный диапазон DWORD .
DDV_MinMaxFloat	Проверяет заданное значение элемента управления не превышает заданный float диапазон.
DDV_MinMaxInt	Проверяет заданное значение элемента управления не превышает заданный int диапазон.
DDV_MinMaxLong	Проверяет заданное значение элемента управления не превышает заданный long диапазон.
DDV_MinMaxLongLong	Проверяет заданное значение элемента управления не превышает заданный диапазон LONGLONG .
DDV_MinMaxMonth	Проверяет заданное значение элемента управления не превышает заданный диапазон дат.
DDV_MinMaxShort	Проверяет заданное значение элемента управления не превышает заданный short диапазон.
DDV_MinMaxSlider	Проверяет заданное значение элемента управления ползунка в пределах заданного диапазона.
DDV_MinMaxUInt	Проверяет заданное значение элемента управления не превышает заданный диапазон UINT .
DDV_MinMaxUnsigned	Проверяет заданное значение элемента управления между двумя указанными значениями.
DDV_MinMaxULongLong	Проверяет заданное значение элемента управления не превышает заданный диапазон ULONGLONG .

DDV_MaxChars

Вызов, DDV_MaxChars чтобы убедиться, что количество символов в элементе управления, связанном со значением , не превышает nChars.

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

Параметры

PDX
Указатель на объект CDataExchange. Структура предоставляет этот объект для формирования контекста обмена данными, включая его направление.

значение
Ссылка на переменную-член диалогового окна, представления формы или объекта элемента управления, с помощью которого проверяются данные.

nChars
Максимально допустимое число символов.

Замечания

Дополнительные сведения о DDV см. в диалоговом окне "Обмен данными" и "Проверка".

Требования

Заголовок afxdd_.h

DDV_MinMaxByte

Вызов для DDV_MinMaxByte проверки того, что значение в элементе управления, связанном со значением, попадает между minVal и maxVal.

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

Параметры

PDX
Указатель на объект CDataExchange. Структура предоставляет этот объект для формирования контекста обмена данными, включая его направление.

значение
Ссылка на переменную-член диалогового окна, представления формы или объекта элемента управления, с помощью которого проверяются данные.

minVal
Минимальное значение (типа BYTE) разрешено.

maxVal
Максимально допустимое значение (типа BYTE).

Замечания

Дополнительные сведения о DDV см. в диалоговом окне "Обмен данными" и "Проверка".

Требования

Заголовок afxdd_.h

DDV_MinMaxDateTime

Вызов для DDV_MinMaxDateTime проверки того, что значение времени и даты в элементе управления выбора даты и времени (CDateTimeCtrl), связанного с refValue, попадает между refMinRange и 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);

Параметры

PDX
Указатель на объект CDataExchange . Структура предоставляет этот объект для формирования контекста обмена данными, включая его направление. Удалить этот объект не нужно.

refValue
Ссылка на объект CTime или COleDateTime , связанный с переменной члена диалогового окна, представления формы или объекта элемента управления. Этот объект содержит данные для проверки.

refMinRange
Минимально допустимое значение даты и времени.

refMaxRange
Максимально допустимое значение даты и времени.

Замечания

Дополнительные сведения о DDV см. в диалоговом окне "Обмен данными" и "Проверка".

Требования

Заголовок afxdd_.h

DDV_MinMaxDouble

Вызов для DDV_MinMaxDouble проверки того, что значение в элементе управления, связанном со значением, попадает между minVal и maxVal.

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

Параметры

PDX
Указатель на объект CDataExchange. Структура предоставляет этот объект для формирования контекста обмена данными, включая его направление.

значение
Ссылка на переменную-член диалогового окна, представления формы или объекта элемента управления, с помощью которого проверяются данные.

minVal
Минимальное значение (типа double) разрешено.

maxVal
Максимально допустимое значение (типа double).

Замечания

Дополнительные сведения о DDV см. в диалоговом окне "Обмен данными" и "Проверка".

Требования

Заголовок afxdd_.h

DDV_MinMaxDWord

Вызов для DDV_MinMaxDWord проверки того, что значение в элементе управления, связанном со значением, попадает между minVal и maxVal.

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

Параметры

PDX
Указатель на объект CDataExchange. Структура предоставляет этот объект для формирования контекста обмена данными, включая его направление.

значение
Ссылка на переменную-член диалогового окна, представления формы или объекта элемента управления, с помощью которого проверяются данные.

minVal
Минимально допустимое значение (типа DWORD).

maxVal
Максимально допустимое значение (типа DWORD).

Замечания

Дополнительные сведения о DDV см. в диалоговом окне "Обмен данными" и "Проверка".

Требования

Заголовок afxdd_.h

DDV_MinMaxFloat

Вызов для DDV_MinMaxFloat проверки того, что значение в элементе управления, связанном со значением, попадает между minVal и maxVal.

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

Параметры

PDX
Указатель на объект CDataExchange. Структура предоставляет этот объект для формирования контекста обмена данными, включая его направление.

значение
Ссылка на переменную-член диалогового окна, представления формы или объекта элемента управления, с помощью которого проверяются данные.

minVal
Минимальное значение (типа float) разрешено.

maxVal
Максимально допустимое значение (типа float).

Замечания

Дополнительные сведения о DDV см. в диалоговом окне "Обмен данными" и "Проверка".

Требования

Заголовок afxdd_.h

DDV_MinMaxInt

Вызов для DDV_MinMaxInt проверки того, что значение в элементе управления, связанном со значением, попадает между minVal и maxVal.

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

Параметры

PDX
Указатель на объект CDataExchange. Структура предоставляет этот объект для формирования контекста обмена данными, включая его направление.

значение
Ссылка на переменную-член диалогового окна, представления формы или объекта элемента управления, с помощью которого проверяются данные.

minVal
Минимальное значение (типа int) разрешено.

maxVal
Максимально допустимое значение (типа int).

Замечания

Дополнительные сведения о DDV см. в диалоговом окне "Обмен данными" и "Проверка".

Требования

Заголовок afxdd_.h

DDV_MinMaxLong

Вызов для DDV_MinMaxLong проверки того, что значение в элементе управления, связанном со значением, попадает между minVal и maxVal.

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

Параметры

PDX
Указатель на объект CDataExchange. Структура предоставляет этот объект для формирования контекста обмена данными, включая его направление.

значение
Ссылка на переменную-член диалогового окна, представления формы или объекта элемента управления, с помощью которого проверяются данные.

minVal
Минимальное значение (типа long) разрешено.

maxVal
Максимально допустимое значение (типа long).

Замечания

Дополнительные сведения о DDV см. в диалоговом окне "Обмен данными" и "Проверка".

Требования

Заголовок afxdd_.h

DDV_MinMaxLongLong

Вызов для DDV_MinMaxLongLong проверки того, что значение в элементе управления, связанном со значением, попадает между minVal и maxVal.

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

Параметры

PDX
Указатель на объект CDataExchange. Структура предоставляет этот объект для формирования контекста обмена данными, включая его направление.

значение
Ссылка на переменную-член диалогового окна, представления формы или объекта элемента управления, с помощью которого проверяются данные.

minVal
Минимальное значение (типа LONGLONG) разрешено.

maxVal
Максимально допустимое значение (типа LONGLONG).

Замечания

Дополнительные сведения о DDV см. в диалоговом окне "Обмен данными" и "Проверка".

Требования

Заголовок afxdd_.h

DDV_MinMaxMonth

Вызов для DDV_MinMaxMonth проверки того, что значение времени и даты в элементе управления календаря месяца (CMonthCalCtrl), связанном с refValue, попадает между refMinRange и 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);

Параметры

PDX
Указатель на объект CDataExchange . Структура предоставляет этот объект для формирования контекста обмена данными, включая его направление.

refValue
Ссылка на объект типа CTime или COleDateTime связанный с переменной элемента диалогового окна, представления формы или элемента управления. Этот объект содержит данные для проверки. MFC передает эту ссылку при DDV_MinMaxMonth вызове.

refMinRange
Минимально допустимое значение даты и времени.

refMaxRange
Максимально допустимое значение даты и времени.

Замечания

Дополнительные сведения о DDV см. в диалоговом окне "Обмен данными" и "Проверка".

Требования

Заголовок afxdd_.h

DDV_MinMaxShort

Вызов для DDV_MinMaxShort проверки того, что значение в элементе управления, связанном со значением, попадает между minVal и maxVal.

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

Параметры

PDX
Указатель на объект CDataExchange. Структура предоставляет этот объект для формирования контекста обмена данными, включая его направление.

значение
Ссылка на переменную-член диалогового окна, представления формы или объекта элемента управления, с помощью которого проверяются данные.

minVal
Минимальное значение (типа short) разрешено.

maxVal
Максимально допустимое значение (типа short).

Замечания

Дополнительные сведения о DDV см. в диалоговом окне "Обмен данными" и "Проверка".

Требования

Заголовок afxdd_.h

DDV_MinMaxSlider

Вызов для DDV_MinMaxSlider проверки того, что значение в элементе управления, связанном со значением, попадает между minVal и maxVal.

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

Параметры

PDX
Указатель на объект CDataExchange . Структура предоставляет этот объект для формирования контекста обмена данными, включая его направление.

значение
Ссылка на проверяемое значение. Этот параметр содержит или задает текущее положение элемента управления ползунка.

minVal
Минимально допустимое значение.

maxVal
Максимально допустимое значение.

Замечания

Дополнительные сведения о DDV см. в диалоговом окне "Обмен данными" и "Проверка". Сведения об элементах управления ползунка см. в разделе Using CSliderCtrl.

Требования

Заголовок afxdd_.h

DDV_MinMaxUInt

Вызов для DDV_MinMaxUInt проверки того, что значение в элементе управления, связанном со значением, попадает между minVal и maxVal.

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

Параметры

PDX
Указатель на объект CDataExchange. Структура предоставляет этот объект для формирования контекста обмена данными, включая его направление.

значение
Ссылка на переменную-член диалогового окна, представления формы или объекта элемента управления, с помощью которого проверяются данные.

minVal
Минимальное значение (типа UINT) разрешено.

maxVal
Максимально допустимое значение (типа UINT).

Замечания

Дополнительные сведения о DDV см. в диалоговом окне "Обмен данными" и "Проверка".

Требования

Заголовок afxdd_.h

DDV_MinMaxULongLong

Вызов для DDV_MinMaxULongLong проверки того, что значение в элементе управления, связанном со значением, попадает между minVal и maxVal.

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

Параметры

PDX
Указатель на объект CDataExchange. Структура предоставляет этот объект для формирования контекста обмена данными, включая его направление.

значение
Ссылка на переменную-член диалогового окна, представления формы или объекта элемента управления, с помощью которого проверяются данные.

minVal
Минимальное значение (типа ULONGLONG) разрешено.

maxVal
Максимально допустимое значение (типа ULONGLONG).

Замечания

Дополнительные сведения о DDV см. в диалоговом окне "Обмен данными" и "Проверка".

Требования

Заголовок afxdd_.h

DDV_MinMaxUnsigned

Вызов для DDV_MinMaxUnsigned проверки того, что значение в элементе управления, связанном со значением, попадает между minVal и maxVal.

Синтаксис

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

Параметры

PDX
Указатель на объект CDataExchange. Структура предоставляет этот объект для формирования контекста обмена данными, включая его направление.

значение
Ссылка на переменную-член диалогового окна, представления формы или объекта элемента управления, с помощью которого проверяются данные.

minVal
Минимальное значение (типа unsigned ) разрешено.

maxVal
Максимально допустимое значение (типа unsigned ).

Замечания

Дополнительные сведения о DDV см. в диалоговом окне "Обмен данными" и "Проверка".

Требования

Заголовок: afxdd_.h

См. также

Стандартные программы обмена данными диалоговых окон
Макросы и глобальные
DDX_Slider
DDX_FieldSlider