표준 대화 상자 데이터 유효성 검사 루틴
이 항목에서는 일반적인 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