표준 대화 상자 데이터 유효성 검사 루틴

  • 아티클

이 항목에서는 일반적인 MFC 대화 상자 컨트롤에 사용되는 표준 DDV(대화 상자 데이터 유효성 검사) 루틴을 나열합니다.

참고 항목

표준 대화 상자 데이터 교환 루틴은 헤더 파일 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

값과 연결된 컨트롤의 문자 양이 nChars를 초과하지 않는지 확인하기 위한 호출 DDV_MaxChars 입니다.

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

매개 변수

pDX
CDataExchange 개체에 대한 포인터입니다. 프레임워크는 해당 방향을 포함해서 데이터 교환의 컨텍스트를 설정하기 위해 이 개체를 제공합니다.

value
데이터의 유효성을 검사하는 대화 상자, 폼 뷰 또는 컨트롤 뷰 개체의 멤버 변수에 대한 참조입니다.

nChars
허용되는 최대 문자 수입니다.

설명

DDV에 대한 자세한 내용은 대화 상자 데이터 교환 및 유효성 검사를 참조 하세요.

요구 사항

헤더 afxdd_.h

DDV_MinMaxByte

값과 연결된 컨트롤의 값이 minVal과 maxVal 사이에 속하는지 확인하려면 호출 DDV_MinMaxByte 합니다.

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

매개 변수

pDX
CDataExchange 개체에 대한 포인터입니다. 프레임워크는 해당 방향을 포함해서 데이터 교환의 컨텍스트를 설정하기 위해 이 개체를 제공합니다.

value
데이터의 유효성을 검사하는 대화 상자, 폼 뷰 또는 컨트롤 뷰 개체의 멤버 변수에 대한 참조입니다.

minVal
허용되는 최소값(BYTE 형식)입니다.

maxVal
허용되는 최대값(BYTE 형식)입니다.

설명

DDV에 대한 자세한 내용은 대화 상자 데이터 교환 및 유효성 검사를 참조 하세요.

요구 사항

헤더 afxdd_.h

DDV_MinMaxDateTime

refValue와 연결된 날짜 및 시간 선택기 컨트롤(CDateTimeCtrl)의 시간/날짜 값이 refMinRange와 refMaxRange 사이에 속하는지 확인하려면 호출 DDV_MinMaxDateTime 합니다.

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

값과 연결된 컨트롤의 값이 minVal과 maxVal 사이에 속하는지 확인하려면 호출 DDV_MinMaxDouble 합니다.

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

매개 변수

pDX
CDataExchange 개체에 대한 포인터입니다. 프레임워크는 해당 방향을 포함해서 데이터 교환의 컨텍스트를 설정하기 위해 이 개체를 제공합니다.

value
데이터의 유효성을 검사하는 대화 상자, 폼 뷰 또는 컨트롤 뷰 개체의 멤버 변수에 대한 참조입니다.

minVal
허용되는 최소값(형식 double)입니다.

maxVal
허용되는 최대값(형식 double)입니다.

설명

DDV에 대한 자세한 내용은 대화 상자 데이터 교환 및 유효성 검사를 참조 하세요.

요구 사항

헤더 afxdd_.h

DDV_MinMaxDWord

값과 연결된 컨트롤의 값이 minVal과 maxVal 사이에 속하는지 확인하려면 호출 DDV_MinMaxDWord 합니다.

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

매개 변수

pDX
CDataExchange 개체에 대한 포인터입니다. 프레임워크는 해당 방향을 포함해서 데이터 교환의 컨텍스트를 설정하기 위해 이 개체를 제공합니다.

value
데이터의 유효성을 검사하는 대화 상자, 폼 뷰 또는 컨트롤 뷰 개체의 멤버 변수에 대한 참조입니다.

minVal
허용되는 최소값(DWORD 형식)입니다.

maxVal
허용되는 최대값(DWORD 형식)입니다.

설명

DDV에 대한 자세한 내용은 대화 상자 데이터 교환 및 유효성 검사를 참조 하세요.

요구 사항

헤더 afxdd_.h

DDV_MinMaxFloat

값과 연결된 컨트롤의 값이 minVal과 maxVal 사이에 속하는지 확인하려면 호출 DDV_MinMaxFloat 합니다.

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

매개 변수

pDX
CDataExchange 개체에 대한 포인터입니다. 프레임워크는 해당 방향을 포함해서 데이터 교환의 컨텍스트를 설정하기 위해 이 개체를 제공합니다.

value
데이터의 유효성을 검사하는 대화 상자, 폼 뷰 또는 컨트롤 뷰 개체의 멤버 변수에 대한 참조입니다.

minVal
허용되는 최소값(형식 float)입니다.

maxVal
허용되는 최대값(형식 float)입니다.

설명

DDV에 대한 자세한 내용은 대화 상자 데이터 교환 및 유효성 검사를 참조 하세요.

요구 사항

헤더 afxdd_.h

DDV_MinMaxInt

값과 연결된 컨트롤의 값이 minVal과 maxVal 사이에 속하는지 확인하려면 호출 DDV_MinMaxInt 합니다.

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

매개 변수

pDX
CDataExchange 개체에 대한 포인터입니다. 프레임워크는 해당 방향을 포함해서 데이터 교환의 컨텍스트를 설정하기 위해 이 개체를 제공합니다.

value
데이터의 유효성을 검사하는 대화 상자, 폼 뷰 또는 컨트롤 뷰 개체의 멤버 변수에 대한 참조입니다.

minVal
허용되는 최소값(형식 int)입니다.

maxVal
허용되는 최대값(형식 int)입니다.

설명

DDV에 대한 자세한 내용은 대화 상자 데이터 교환 및 유효성 검사를 참조 하세요.

요구 사항

헤더 afxdd_.h

DDV_MinMaxLong

값과 연결된 컨트롤의 값이 minVal과 maxVal 사이에 속하는지 확인하려면 호출 DDV_MinMaxLong 합니다.

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

매개 변수

pDX
CDataExchange 개체에 대한 포인터입니다. 프레임워크는 해당 방향을 포함해서 데이터 교환의 컨텍스트를 설정하기 위해 이 개체를 제공합니다.

value
데이터의 유효성을 검사하는 대화 상자, 폼 뷰 또는 컨트롤 뷰 개체의 멤버 변수에 대한 참조입니다.

minVal
허용되는 최소값(형식 long)입니다.

maxVal
허용되는 최대값(형식 long)입니다.

설명

DDV에 대한 자세한 내용은 대화 상자 데이터 교환 및 유효성 검사를 참조 하세요.

요구 사항

헤더 afxdd_.h

DDV_MinMaxLongLong

값과 연결된 컨트롤의 값이 minVal과 maxVal 사이에 속하는지 확인하려면 호출 DDV_MinMaxLongLong 합니다.

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

매개 변수

pDX
CDataExchange 개체에 대한 포인터입니다. 프레임워크는 해당 방향을 포함해서 데이터 교환의 컨텍스트를 설정하기 위해 이 개체를 제공합니다.

value
데이터의 유효성을 검사하는 대화 상자, 폼 뷰 또는 컨트롤 뷰 개체의 멤버 변수에 대한 참조입니다.

minVal
허용되는 최소값(LONGLONG 형식)입니다.

maxVal
허용되는 최대값(LONGLONG 형식)입니다.

설명

DDV에 대한 자세한 내용은 대화 상자 데이터 교환 및 유효성 검사를 참조 하세요.

요구 사항

헤더 afxdd_.h

DDV_MinMaxMonth

refValue와 연결된 월 달력 컨트롤(CMonthCalCtrl)의 시간/날짜 값이 refMinRange와 refMaxRange 사이에 속하는지 확인하려면 호출 DDV_MinMaxMonth 합니다.

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

값과 연결된 컨트롤의 값이 minVal과 maxVal 사이에 속하는지 확인하려면 호출 DDV_MinMaxShort 합니다.

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

매개 변수

pDX
CDataExchange 개체에 대한 포인터입니다. 프레임워크는 해당 방향을 포함해서 데이터 교환의 컨텍스트를 설정하기 위해 이 개체를 제공합니다.

value
데이터의 유효성을 검사하는 대화 상자, 폼 뷰 또는 컨트롤 뷰 개체의 멤버 변수에 대한 참조입니다.

minVal
허용되는 최소값(형식 short)입니다.

maxVal
허용되는 최대값(형식 short)입니다.

설명

DDV에 대한 자세한 내용은 대화 상자 데이터 교환 및 유효성 검사를 참조 하세요.

요구 사항

헤더 afxdd_.h

DDV_MinMaxSlider

값과 연결된 컨트롤의 값이 minVal과 maxVal 사이에 속하는지 확인하려면 호출 DDV_MinMaxSlider 합니다.

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

매개 변수

pDX
CDataExchange 개체에 대한 포인터입니다. 프레임워크는 해당 방향을 포함해서 데이터 교환의 컨텍스트를 설정하기 위해 이 개체를 제공합니다.

value
유효성을 검사할 값에 대한 참조입니다. 이 매개 변수는 슬라이더 컨트롤의 현재 Thumb 위치를 보유하거나 설정합니다.

minVal
허용되는 최소값입니다.

maxVal
허용되는 최대값입니다.

설명

DDV에 대한 자세한 내용은 대화 상자 데이터 교환 및 유효성 검사를 참조 하세요. 슬라이더 컨트롤에 대한 자세한 내용은 CSliderCtrl 사용을 참조 하세요.

요구 사항

헤더 afxdd_.h

DDV_MinMaxUInt

값과 연결된 컨트롤의 값이 minVal과 maxVal 사이에 속하는지 확인하려면 호출 DDV_MinMaxUInt 합니다.

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

매개 변수

pDX
CDataExchange 개체에 대한 포인터입니다. 프레임워크는 해당 방향을 포함해서 데이터 교환의 컨텍스트를 설정하기 위해 이 개체를 제공합니다.

value
데이터의 유효성을 검사하는 대화 상자, 폼 뷰 또는 컨트롤 뷰 개체의 멤버 변수에 대한 참조입니다.

minVal
허용되는 최소값(UINT 형식)입니다.

maxVal
허용되는 최대값(UINT 형식)입니다.

설명

DDV에 대한 자세한 내용은 대화 상자 데이터 교환 및 유효성 검사를 참조 하세요.

요구 사항

헤더 afxdd_.h

DDV_MinMaxULongLong

값과 연결된 컨트롤의 값이 minVal과 maxVal 사이에 속하는지 확인하려면 호출 DDV_MinMaxULongLong 합니다.

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

매개 변수

pDX
CDataExchange 개체에 대한 포인터입니다. 프레임워크는 해당 방향을 포함해서 데이터 교환의 컨텍스트를 설정하기 위해 이 개체를 제공합니다.

value
데이터의 유효성을 검사하는 대화 상자, 폼 뷰 또는 컨트롤 뷰 개체의 멤버 변수에 대한 참조입니다.

minVal
허용되는 최소값(ULONGLONG 형식)입니다.

maxVal
허용되는 최대값(ULONGLONG 형식)입니다.

설명

DDV에 대한 자세한 내용은 대화 상자 데이터 교환 및 유효성 검사를 참조 하세요.

요구 사항

헤더 afxdd_.h

DDV_MinMaxUnsigned

값과 연결된 컨트롤의 값이 minVal과 maxVal 사이에 속하는지 확인하려면 호출 DDV_MinMaxUnsigned 합니다.

구문

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

매개 변수

pDX
CDataExchange 개체에 대한 포인터입니다. 프레임워크는 해당 방향을 포함해서 데이터 교환의 컨텍스트를 설정하기 위해 이 개체를 제공합니다.

value
데이터의 유효성을 검사하는 대화 상자, 폼 뷰 또는 컨트롤 뷰 개체의 멤버 변수에 대한 참조입니다.

minVal
허용되는 최소값(형식 unsigned )입니다.

maxVal
허용되는 최대값(형식 unsigned )입니다.

설명

DDV에 대한 자세한 내용은 대화 상자 데이터 교환 및 유효성 검사를 참조 하세요.

요구 사항

헤더: afxdd_.h

참고 항목

표준 대화 상자 데이터 교환 루틴
매크로 및 전역
DDX_Slider
DDX_FieldSlider