MCHITTESTINFO 구조체(commctrl.h)
월 달력 컨트롤에 대한 적중 횟수 테스트 지점과 관련된 정보를 전달합니다. 이 구조체는 MCM_HITTEST 메시지 및 해당 MonthCal_HitTest 매크로와 함께 사용됩니다.
구문
typedef struct {
UINT cbSize;
POINT pt;
UINT uHit;
SYSTEMTIME st;
RECT rc;
int iOffset;
int iRow;
int iCol;
} MCHITTESTINFO, *PMCHITTESTINFO;
멤버
cbSize
형식: UINT
이 구조체의 크기(바이트)입니다.
pt
형식: POINT
적중 테스트를 가리킵니다.
uHit
형식: UINT
적중 테스트 작업의 결과를 나타내는 비트 플래그를 수신하는 출력 멤버입니다. 이 값은 다음 중 하나입니다.
| 값 | 의미 |
|---|---|
|
지정된 지점이 달력의 배경에 있었습니다. |
|
지정된 지점은 일정 외부에 있지만 달력 컨트롤 RECT 내에 있습니다. |
|
지정된 지점이 달력 내 특정 날짜에 있었습니다. lpMCHitTest>st의 SYSTEMTIME 구조체는 지정된 시점의 날짜로 설정됩니다. |
|
지정된 지점이 달력의 최소 날짜를 초과했습니다. |
|
지정된 지점이 달력의 최대 날짜를 초과했습니다. |
|
지정된 지점이 다음 월의 날짜 위에 있었습니다(현재 표시된 월의 끝에 부분적으로 표시됨). 사용자가 여기를 클릭하면 월 달력 표시가 다음 월 또는 월 세트로 스크롤됩니다. |
|
지정된 지점이 이전 월의 날짜 위에 있었습니다(현재 표시된 월의 끝에 부분적으로 표시됨). 사용자가 여기를 클릭하면 월 달력 표시가 이전 월 또는 월 세트로 스크롤됩니다. |
|
지정된 지점이 요일 약어(예: “Fri” ) 위에 있었습니다. lpMCHitTest>st의 SYSTEMTIME 구조체는 맨 위 행의 해당 날짜로 설정됩니다. |
|
지정된 지점이 주 번호 위에 있었습니다(MCS_WEEKNUMBERS 스타일만 해당). lpMCHitTest>st의 SYSTEMTIME 구조체는 맨 왼쪽 열의 해당 날짜로 설정됩니다. |
|
지정된 지점이 월 달력 컨트롤에 없었거나 컨트롤의 비활성 부분에 있었습니다. |
|
지정된 지점이 월 제목의 배경 위에 있었습니다. |
|
지정된 지점이 컨트롤 오른쪽 위의 단추 위에 있었습니다. 사용자가 여기를 클릭하면 월 달력 표시가 다음 월 또는 월 세트로 스크롤됩니다. |
|
지정된 지점이 컨트롤 왼쪽 위의 단추 위에 있었습니다. 사용자가 여기를 클릭하면 월 달력 표시가 이전 월 또는 월 세트로 스크롤됩니다. |
|
지정된 지점이 월 이름 위의 월 제목 표시줄에 있었습니다. |
|
지정된 지점이 연도 값 위의 월 제목 표시줄에 있었습니다. |
st
형식: SYSTEMTIME
적중 테스트된 위치와 관련된 날짜 및 시간 정보를 받습니다.
rc
형식: RECT
적중 테스트된 위치입니다.
iOffset
형식: int
둘 이상의 달력을 표시할 때 적중 테스트 지점(0부터 시작)에서 일정의 오프셋입니다.
iRow
형식: int
지정된 적중 지점이 끝난 달력 표의 행 번호입니다. 예: 월의 두 번째 주에 있는 월의 8번째를 적중 테스트한 경우 행의 인덱스가 0부터 시작하는 행 인덱스이므로 iRow 는 1이 됩니다.
iCol
형식: int
지정된 지점이 끝난 달력 표의 열 번호입니다. 예를 들어 주일이 일요일에 시작되고 월의 1일이 금요일인 경우 0부터 시작하는 열 인덱스를 사용하여 금요일이 행의 시작 부분에서 다섯 번째 열에 있으므로 1번째 테스트는 iCol에 대해 5(5)를 반환합니다.
설명
이 컨트롤의 열과 행은 0부터 시작하는 인덱스 시스템을 사용합니다. 즉, 첫 번째 열 또는 행에 인덱스가 0입니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 머리글 | commctrl.h |