월 달력 컨트롤

이 섹션에는 월 달력 컨트롤과 함께 사용되는 프로그래밍 요소에 대한 정보가 포함되어 있습니다.

개요

항목	콘텐츠
월 달력 컨트롤 정보	월 달력 컨트롤은 달력과 같은 사용자 인터페이스를 구현합니다.
월 달력 컨트롤 사용	이 섹션에서는 프로그래밍 월 달력 컨트롤에 대한 정보를 제공합니다.

매크로

항목	콘텐츠
MonthCal_GetCalendarBorder	월 달력 컨트롤의 테두리 크기(픽셀)를 가져옵니다. 이 매크로를 사용하거나 MCM_GETCALENDARBORDER 메시지를 명시적으로 보낼 수 있습니다.
MonthCal_GetCalendarCount	달력 컨트롤에 현재 표시된 달력 수를 가져옵니다. 이 매크로를 사용하거나 MCM_GETCALENDARCOUNT 메시지를 명시적으로 보낼 수 있습니다.
MonthCal_GetCalendarGridInfo	일정 눈금에 대한 정보를 가져옵니다.
MonthCal_GetCALID	지정된 달력 컨트롤의 현재 달력 ID를 가져옵니다. 이 매크로를 사용하거나 MCM_GETCALID 메시지를 명시적으로 보낼 수 있습니다.
MonthCal_GetColor	월 달력 컨트롤의 지정된 부분에 대한 색을 검색합니다. 이 매크로를 사용하거나 MCM_GETCOLOR 메시지를 명시적으로 보낼 수 있습니다.
MonthCal_GetCurrentView	월 달력 컨트롤에 대한 뷰를 가져옵니다. 이 매크로를 사용하거나 MCM_GETCURRENTVIEW 메시지를 명시적으로 보낼 수 있습니다.
MonthCal_GetCurSel	현재 선택된 날짜를 검색합니다. 이 매크로를 사용하거나 MCM_GETCURSEL 메시지를 명시적으로 보낼 수 있습니다.
MonthCal_GetFirstDayOfWeek	월 달력 컨트롤의 첫 번째 요일을 검색합니다. 이 매크로를 사용하거나 MCM_GETFIRSTDAYOFWEEK 메시지를 명시적으로 보낼 수 있습니다.
MonthCal_GetMaxSelCount	월 달력 컨트롤에서 선택할 수 있는 최대 날짜 범위를 검색합니다. 이 매크로를 사용하거나 MCM_GETMAXSELCOUNT 메시지를 명시적으로 보낼 수 있습니다.
MonthCal_GetMaxTodayWidth	월 달력 컨트롤에서 "today" 문자열의 최대 너비를 검색합니다. 여기에는 레이블 텍스트와 날짜 텍스트가 포함됩니다. 이 매크로를 사용하거나 MCM_GETMAXTODAYWIDTH 메시지를 명시적으로 보낼 수 있습니다.
MonthCal_GetMinReqRect	월 달력 컨트롤에서 전체 월을 표시하는 데 필요한 최소 크기를 검색합니다. 크기 정보는 RECT 구조체의 형태로 제공됩니다. 이 매크로를 사용하거나 MCM_GETMINREQRECT 메시지를 명시적으로 보낼 수 있습니다.
MonthCal_GetMonthDelta	월 캘린더 컨트롤의 스크롤 속도를 검색합니다. 스크롤 속도는 사용자가 스크롤 단추를 클릭할 때 컨트롤이 디스플레이를 이동하는 개월 수입니다. 이 매크로를 사용하거나 MCM_GETMONTHDELTA 메시지를 명시적으로 보낼 수 있습니다.
MonthCal_GetMonthRange	월 달력 컨트롤 표시의 상한 및 하한을 나타내는 날짜 정보를 검색합니다(SYSTEMTIME 구조체 사용). 이 매크로를 사용하거나 MCM_GETMONTHRANGE 메시지를 명시적으로 보낼 수 있습니다.
MonthCal_GetRange	월 달력 컨트롤에 설정된 최소 및 최대 허용 날짜를 검색합니다. 이 매크로를 사용하거나 MCM_GETRANGE 메시지를 명시적으로 보낼 수 있습니다.
MonthCal_GetSelRange	현재 사용자가 선택한 날짜 범위의 상한과 하한을 나타내는 날짜 정보를 가져옵니다. 이 매크로를 사용하거나 MCM_GETSELRANGE 메시지를 명시적으로 보낼 수 있습니다.
MonthCal_GetToday	월 달력 컨트롤에 대해 "today"로 지정된 날짜의 날짜 정보를 검색합니다. 이 매크로를 사용하거나 MCM_GETTODAY 메시지를 명시적으로 보낼 수 있습니다.
MonthCal_GetUnicodeFormat	컨트롤의 유니코드 문자 형식 플래그를 검색합니다. 이 매크로를 사용하거나 MCM_GETUNICODEFORMAT 메시지를 명시적으로 보낼 수 있습니다.
MonthCal_HitTest	화면의 지정된 지점에 있는 월 달력 컨트롤의 일부를 결정합니다. 이 매크로를 사용하거나 MCM_HITTEST 메시지를 명시적으로 보낼 수 있습니다.
MonthCal_SetCalendarBorder	월 달력 컨트롤의 테두리 크기(픽셀)를 설정합니다. 이 매크로를 사용하거나 MCM_SETCALENDARBORDER 메시지를 명시적으로 보낼 수 있습니다.
MonthCal_SetCALID	지정된 달력 컨트롤의 달력 ID를 설정합니다. 이 매크로를 사용하거나 MCM_SETCALID 메시지를 명시적으로 보낼 수 있습니다.
MonthCal_SetColor	월 달력 컨트롤의 지정된 부분에 대한 색을 설정합니다. 이 매크로를 사용하거나 MCM_SETCOLOR 메시지를 명시적으로 보낼 수 있습니다.
MonthCal_SetCurrentView	월 달력 컨트롤에 대한 뷰를 설정합니다. 이 매크로를 사용하거나 MCM_SETCURRENTVIEW 메시지를 명시적으로 보낼 수 있습니다.
MonthCal_SetCurSel	월 달력 컨트롤에 대해 현재 선택한 날짜를 설정합니다. 지정된 날짜가 표시되지 않으면 컨트롤이 디스플레이를 업데이트하여 표시합니다. 이 매크로를 사용하거나 MCM_SETCURSEL 메시지를 명시적으로 보낼 수 있습니다.
MonthCal_SetDayState	달력 컨트롤 내에서 현재 표시되는 모든 달의 날짜 상태를 설정합니다. 이 매크로를 사용하거나 MCM_SETDAYSTATE 메시지를 명시적으로 보낼 수 있습니다.
MonthCal_SetFirstDayOfWeek	월 달력 컨트롤의 첫 번째 요일을 설정합니다. 이 매크로를 사용하거나 MCM_SETFIRSTDAYOFWEEK 메시지를 명시적으로 보낼 수 있습니다.
MonthCal_SetMaxSelCount	월 달력 컨트롤에서 선택할 수 있는 최대 일수를 설정합니다. 이 매크로를 사용하거나 MCM_SETMAXSELCOUNT 메시지를 명시적으로 보낼 수 있습니다.
MonthCal_SetMonthDelta	월 달력 컨트롤에 대한 스크롤 비율을 설정합니다. 스크롤 속도는 사용자가 스크롤 단추를 클릭할 때 컨트롤이 디스플레이를 이동하는 개월 수입니다. 이 매크로를 사용하거나 MCM_SETMONTHDELTA 메시지를 명시적으로 보낼 수 있습니다.
MonthCal_SetRange	월 달력 컨트롤에 허용되는 최소 및 최대 날짜를 설정합니다. 이 매크로를 사용하거나 MCM_SETRANGE 메시지를 명시적으로 보낼 수 있습니다.
MonthCal_SetSelRange	월 달력 컨트롤에 대한 선택을 지정된 날짜 범위로 설정합니다. 이 매크로를 사용하거나 MCM_SETSELRANGE 메시지를 명시적으로 보낼 수 있습니다.
MonthCal_SetToday	월 달력 컨트롤에 대한 "today" 선택을 설정합니다. 이 매크로를 사용하거나 MCM_SETTODAY 메시지를 명시적으로 보낼 수 있습니다.
MonthCal_SetUnicodeFormat	컨트롤의 유니코드 문자 형식 플래그를 설정합니다. 이 메시지를 통해 컨트롤을 다시 만들지 않고도 런타임에 컨트롤에서 사용하는 문자 집합을 변경할 수 있습니다. 이 매크로를 사용하거나 MCM_SETUNICODEFORMAT 메시지를 명시적으로 보낼 수 있습니다.
MonthCal_SizeRectToMin	지정된 사각형에 맞는 달력 수를 계산한 다음, 해당 달력 수에 맞게 사각형이 필요한 최소 크기를 반환합니다. 이 매크로를 사용하거나 MCM_SIZERECTTOMIN 메시지를 명시적으로 보낼 수 있습니다.

메시지

항목	콘텐츠
MCM_GETCALENDARBORDER	테두리의 크기를 픽셀 단위로 가져옵니다. 이 메시지를 명시적으로 보내거나 MonthCal_GetCurrentView 매크로를 사용하여 보낼 수 있습니다.
MCM_GETCALENDARCOUNT	달력 컨트롤에 현재 표시된 달력 수를 가져옵니다. 이 메시지를 명시적으로 보내거나 MonthCal_GetCalendarCount 매크로를 사용하여 보낼 수 있습니다.
MCM_GETCALENDARGRIDINFO	일정 눈금에 대한 정보를 가져옵니다.
MCM_GETCALID	지정된 달력 컨트롤의 달력 ID를 가져옵니다. 이 메시지를 명시적으로 보내거나 MonthCal_GetCALID 매크로를 사용하여 보낼 수 있습니다.
MCM_GETCOLOR	월 달력 컨트롤의 지정된 부분에 대한 색을 검색합니다. 이 메시지를 명시적으로 보내거나 MonthCal_GetColor 매크로를 사용하여 보낼 수 있습니다.
MCM_GETCURRENTVIEW	달력의 현재 뷰를 가져옵니다. 이 메시지를 명시적으로 보내거나 MonthCal_GetCurrentView 매크로를 사용하여 보낼 수 있습니다.
MCM_GETCURSEL	현재 선택된 날짜를 검색합니다. 이 메시지를 명시적으로 보내거나 MonthCal_GetCurSel 매크로를 사용하여 보낼 수 있습니다.
MCM_GETFIRSTDAYOFWEEK	월 달력 컨트롤의 첫 번째 요일을 검색합니다. 이 메시지를 명시적으로 보내거나 MonthCal_GetFirstDayOfWeek 매크로를 사용하여 보낼 수 있습니다.
MCM_GETMAXSELCOUNT	월 달력 컨트롤에서 선택할 수 있는 최대 날짜 범위를 검색합니다. 이 메시지를 명시적으로 보내거나 MonthCal_GetMaxSelCount 매크로를 사용하여 보낼 수 있습니다.
MCM_GETMAXTODAYWIDTH	월 달력 컨트롤에서 "today" 문자열의 최대 너비를 검색합니다. 여기에는 레이블 텍스트와 날짜 텍스트가 포함됩니다. 이 메시지를 명시적으로 보내거나 MonthCal_GetMaxTodayWidth 매크로를 사용하여 보낼 수 있습니다.
MCM_GETMINREQRECT	월 달력 컨트롤에서 전체 월을 표시하는 데 필요한 최소 크기를 검색합니다. 이 메시지를 명시적으로 보내거나 MonthCal_GetMinReqRect 매크로를 사용하여 보낼 수 있습니다.
MCM_GETMONTHDELTA	월 캘린더 컨트롤의 스크롤 속도를 검색합니다. 스크롤 속도는 사용자가 스크롤 단추를 클릭할 때 컨트롤이 디스플레이를 이동하는 개월 수입니다. 이 메시지를 명시적으로 보내거나 MonthCal_GetMonthDelta 매크로를 사용하여 보낼 수 있습니다.
MCM_GETMONTHRANGE	월 달력 컨트롤 표시의 상한 및 하한을 나타내는 날짜 정보를 검색합니다(SYSTEMTIME 구조체 사용). 이 메시지를 명시적으로 보내거나 MonthCal_GetMonthRange 매크로를 사용하여 보낼 수 있습니다.
MCM_GETRANGE	월 달력 컨트롤에 설정된 최소 및 최대 허용 날짜를 검색합니다. 이 메시지를 명시적으로 보내거나 MonthCal_GetRange 매크로를 사용하여 보낼 수 있습니다.
MCM_GETSELRANGE	현재 사용자가 선택한 날짜 범위의 상한과 하한을 나타내는 날짜 정보를 가져옵니다. 명시적으로 이 메시지를 보내거나 MonthCal_GetSelRange 매크로를 사용하여 보낼 수 있습니다.
MCM_GETTODAY	월 달력 컨트롤에 대해 "today"로 지정된 날짜의 날짜 정보를 검색합니다. 이 메시지를 명시적으로 보내거나 MonthCal_GetToday 매크로를 사용하여 보낼 수 있습니다.
MCM_GETUNICODEFORMAT	컨트롤의 유니코드 문자 형식 플래그를 검색합니다. 이 메시지를 명시적으로 보내거나 MonthCal_GetUnicodeFormat 매크로를 사용할 수 있습니다.
MCM_HITTEST	화면의 지정된 지점에 있는 월 달력 컨트롤의 일부를 결정합니다. 이 메시지를 명시적으로 보내거나 MonthCal_HitTest 매크로를 사용하여 보낼 수 있습니다.
MCM_SETCALENDARBORDER	테두리의 크기를 픽셀 단위로 설정합니다. 이 메시지를 명시적으로 보내거나 MonthCal_SetCurrentView 매크로를 사용하여 보낼 수 있습니다.
MCM_SETCALID	지정된 달력 컨트롤의 달력 ID를 설정합니다. 이 메시지를 명시적으로 보내거나 MonthCal_SetCALID 매크로를 사용하여 보낼 수 있습니다.
MCM_SETCOLOR	월 달력 컨트롤의 지정된 부분에 대한 색을 설정합니다. 이 메시지를 명시적으로 보내거나 MonthCal_SetColor 매크로를 사용하여 보낼 수 있습니다.
MCM_SETCURRENTVIEW	달력의 현재 뷰를 설정합니다. 이 메시지를 명시적으로 보내거나 MonthCal_SetCurrentView 매크로를 사용하여 보낼 수 있습니다.
MCM_SETCURSEL	월 달력 컨트롤에 대해 현재 선택한 날짜를 설정합니다. 지정된 날짜가 표시되지 않으면 컨트롤이 디스플레이를 업데이트하여 표시합니다. 이 메시지를 명시적으로 보내거나 MonthCal_SetCurSel 매크로를 사용하여 보낼 수 있습니다.
MCM_SETDAYSTATE	달력 컨트롤 내에서 현재 표시되는 모든 달의 날짜 상태를 설정합니다. 이 메시지를 명시적으로 보내거나 MonthCal_SetDayState 매크로를 사용하여 보낼 수 있습니다.
MCM_SETFIRSTDAYOFWEEK	월 달력 컨트롤의 첫 번째 요일을 설정합니다. 이 메시지를 명시적으로 보내거나 MonthCal_SetFirstDayOfWeek 매크로를 사용하여 보낼 수 있습니다.
MCM_SETMAXSELCOUNT	월 달력 컨트롤에서 선택할 수 있는 최대 일수를 설정합니다. 이 메시지를 명시적으로 보내거나 MonthCal_SetMaxSelCount 매크로를 사용하여 보낼 수 있습니다.
MCM_SETMONTHDELTA	월 달력 컨트롤에 대한 스크롤 비율을 설정합니다. 스크롤 속도는 사용자가 스크롤 단추를 클릭할 때 컨트롤이 디스플레이를 이동하는 개월 수입니다. 이 메시지를 명시적으로 보내거나 MonthCal_SetMonthDelta 매크로를 사용하여 보낼 수 있습니다.
MCM_SETRANGE	월 달력 컨트롤에 허용되는 최소 및 최대 날짜를 설정합니다. 이 메시지를 명시적으로 보내거나 MonthCal_SetRange 매크로를 사용하여 보낼 수 있습니다.
MCM_SETSELRANGE	월 달력 컨트롤에 대한 선택을 지정된 날짜 범위로 설정합니다. 이 메시지를 명시적으로 보내거나 MonthCal_SetSelRange 매크로를 사용하여 보낼 수 있습니다.
MCM_SETTODAY	월 달력 컨트롤에 대한 "today" 선택을 설정합니다. 이 메시지를 명시적으로 보내거나 MonthCal_SetToday 매크로를 사용하여 보낼 수 있습니다.
MCM_SETUNICODEFORMAT	컨트롤의 유니코드 문자 형식 플래그를 설정합니다. 이 메시지를 통해 컨트롤을 다시 만들지 않고도 런타임에 컨트롤에서 사용하는 문자 집합을 변경할 수 있습니다. 이 메시지를 명시적으로 보내거나 MonthCal_SetUnicodeFormat 매크로를 사용하여 보낼 수 있습니다.
MCM_SIZERECTTOMIN	지정된 사각형에 맞는 달력 수를 계산한 다음, 해당 달력 수에 맞게 사각형이 필요한 최소 크기를 반환합니다. 이 메시지를 명시적으로 보내거나 MonthCal_SizeRectToMin 매크로를 사용하여 보낼 수 있습니다.

알림

항목	콘텐츠
MCN_GETDAYSTATE	월 달력 컨트롤에서 개별 일 표시 방법에 대한 정보를 요청하기 위해 전송됩니다. 이 알림 코드는 MCS_DAYSTATE 스타일을 사용하는 월 달력 컨트롤에서만 전송되며 WM_NOTIFY 메시지 형태로 전송됩니다.
MCN_SELCHANGE	현재 선택한 날짜 또는 날짜 범위가 변경되면 월 캘린더 컨트롤에서 보냅니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
MCN_SELECT	사용자가 월 달력 컨트롤 내에서 명시적 날짜 선택을 할 때 월 달력 컨트롤에서 전송됩니다. 이 알림은 WM_NOTIFY 메시지 형식으로 전송됩니다.
MCN_VIEWCHANGE	현재 뷰가 변경되면 월 달력 컨트롤에서 보냅니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
NM_RELEASEDCAPTURE (monthcal)	컨트롤이 마우스 캡처를 해제하고 있음을 monthcal 컨트롤의 부모 창에 알립니다. 이 알림은 WM_NOTIFY 메시지 형식으로 전송됩니다.

구조체

항목	콘텐츠
MCGRIDINFO	달력 컨트롤의 일부에 대한 정보를 포함합니다.
MCHITTESTINFO	월 달력 컨트롤에 대한 적중 횟수 테스트 지점과 관련된 정보를 전달합니다. 이 구조체는 MCM_HITTEST 메시지 및 해당 MonthCal_HitTest 매크로와 함께 사용됩니다.
NMDAYSTATE	MCN_GETDAYSTATE 알림 코드를 처리하는 데 필요한 정보를 전달합니다. 이 구조체의 모든 멤버는 MCN_GETDAYSTATE를 처리할 때 수신 애플리케이션이 설정해야 하는 prgDayState를 제외하고 입력용입니다.
NMSELCHANGE	MCN_SELCHANGE 알림 코드를 처리하는 데 필요한 정보를 전달합니다.
NMVIEWCHANGE	MCN_VIEWCHANGE 알림 코드를 처리하는 데 필요한 정보를 저장합니다.

상수

항목	콘텐츠
월 달력 컨트롤 스타일	다음 스타일 상수는 월 달력 컨트롤을 만들 때 사용됩니다.

데이터 형식

항목	콘텐츠
MONTHDAYSTATE	MONTHDAYSTATE 데이터 형식은 한 달의 각 날짜 상태를 보유하는 비트 필드입니다.