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

적중 테스트 작업의 결과를 나타내는 비트 플래그를 수신하는 출력 멤버입니다. 이 값은 다음 중 하나입니다.

값 의미
MCHT_CALENDARBK
 지정된 지점이 달력의 배경에 있었습니다.
MCHT_CALENDARCONTROL
 지정된 지점은 일정 외부에 있지만 달력 컨트롤 RECT 내에 있습니다.
MCHT_CALENDARDATE
 지정된 지점이 달력 내 특정 날짜에 있었습니다. lpMCHitTest>st의 SYSTEMTIME 구조체는 지정된 시점의 날짜로 설정됩니다.
MCHT_CALENDARDATEMIN
 지정된 지점이 달력의 최소 날짜를 초과했습니다.
MCHT_CALENDARDATEMAX
 지정된 지점이 달력의 최대 날짜를 초과했습니다.
MCHT_CALENDARDATENEXT
 지정된 지점이 다음 월의 날짜 위에 있었습니다(현재 표시된 월의 끝에 부분적으로 표시됨). 사용자가 여기를 클릭하면 월 달력 표시가 다음 월 또는 월 세트로 스크롤됩니다.
MCHT_CALENDARDATEPREV
 지정된 지점이 이전 월의 날짜 위에 있었습니다(현재 표시된 월의 끝에 부분적으로 표시됨). 사용자가 여기를 클릭하면 월 달력 표시가 이전 월 또는 월 세트로 스크롤됩니다.
MCHT_CALENDARDAY
 지정된 지점이 요일 약어(예: “Fri” ) 위에 있었습니다. lpMCHitTest>st의 SYSTEMTIME 구조체는 맨 위 행의 해당 날짜로 설정됩니다.
MCHT_CALENDARWEEKNUM
 지정된 지점이 주 번호 위에 있었습니다(MCS_WEEKNUMBERS 스타일만 해당). lpMCHitTest>st의 SYSTEMTIME 구조체는 맨 왼쪽 열의 해당 날짜로 설정됩니다.
MCHT_NOWHERE
 지정된 지점이 월 달력 컨트롤에 없었거나 컨트롤의 비활성 부분에 있었습니다.
MCHT_TITLEBK
 지정된 지점이 월 제목의 배경 위에 있었습니다.
MCHT_TITLEBTNNEXT
 지정된 지점이 컨트롤 오른쪽 위의 단추 위에 있었습니다. 사용자가 여기를 클릭하면 월 달력 표시가 다음 월 또는 월 세트로 스크롤됩니다.
MCHT_TITLEBTNPREV
 지정된 지점이 컨트롤 왼쪽 위의 단추 위에 있었습니다. 사용자가 여기를 클릭하면 월 달력 표시가 이전 월 또는 월 세트로 스크롤됩니다.
MCHT_TITLEMONTH
 지정된 지점이 월 이름 위의 월 제목 표시줄에 있었습니다.
MCHT_TITLEYEAR
 지정된 지점이 연도 값 위의 월 제목 표시줄에 있었습니다.

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