월 달력 컨트롤

  • 아티클

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

개요

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

매크로

항목 콘텐츠
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 데이터 형식은 한 달의 각 날짜 상태를 보유하는 비트 필드입니다.