날짜 및 시간 선택기

이 섹션에는 날짜 및 시간 선택기 컨트롤에 사용되는 API 요소에 대한 정보가 포함되어 있습니다.

개요

항목	콘텐츠
날짜 및 시간 선택기 컨트롤 정보	DTP(날짜 및 시간 선택기) 컨트롤은 날짜 및 시간 정보를 사용자와 교환하는 간단하고 직관적인 인터페이스를 제공합니다.
날짜 및 시간 선택기 컨트롤 사용	이 섹션에서는 날짜 및 시간 선택기 컨트롤을 구현하기 위한 정보 및 샘플 코드를 제공합니다.

매크로

항목	콘텐츠
DateTime_CloseMonthCal	DTP(날짜 및 시간 선택기) 컨트롤을 닫습니다. 이 매크로를 사용하거나 DTM_CLOSEMONTHCAL 메시지를 명시적으로 보냅니다.
DateTime_GetDateTimePickerInfo	지정된 DTP(날짜 및 시간 선택기) 컨트롤에 대한 정보를 가져옵니다.
DateTime_GetIdealSize	클리핑 없이 컨트롤을 표시하는 데 필요한 크기를 가져옵니다. 이 매크로를 사용하거나 DTM_GETIDEALSIZE 메시지를 명시적으로 보냅니다.
DateTime_GetMonthCal	DTP(날짜 및 시간 선택기) 자식 월 달력 컨트롤에 대한 핸들을 가져옵니다. 이 매크로를 사용하거나 DTM_GETMONTHCAL 메시지를 명시적으로 보낼 수 있습니다.
DateTime_GetMonthCalColor	DTP(날짜 및 시간 선택기) 컨트롤 내에서 월 달력의 지정된 부분에 대한 색을 가져옵니다. 이 매크로를 사용하거나 DTM_GETMCCOLOR 메시지를 명시적으로 보낼 수 있습니다.
DateTime_GetMonthCalFont	DTP(날짜 및 시간 선택기) 컨트롤의 자식 월 달력 컨트롤이 현재 사용하는 글꼴을 가져옵니다. 이 매크로를 사용하거나 DTM_GETMCFONT 메시지를 명시적으로 보낼 수 있습니다.
DateTime_GetMonthCalStyle	지정된 DTP 컨트롤의 스타일을 가져옵니다. 이 매크로를 사용하거나 DTM_GETMCSTYLE 메시지를 명시적으로 보냅니다.
DateTime_GetRange	DTP(날짜 및 시간 선택기) 컨트롤에 허용되는 현재 최소 및 최대 시스템 시간을 가져옵니다. 이 매크로를 사용하거나 DTM_GETRANGE 메시지를 명시적으로 보낼 수 있습니다.
DateTime_GetSystemtime	날짜 및 시간 선택기(DTP) 컨트롤에서 현재 선택된 시간을 가져와 지정된 SYSTEMTIME 구조체에 배치합니다. 이 매크로를 사용하거나 DTM_GETSYSTEMTIME 메시지를 명시적으로 보낼 수 있습니다.
DateTime_SetFormat	지정된 형식 문자열을 기반으로 DTP(날짜 및 시간 선택기) 컨트롤의 표시를 설정합니다. 이 매크로를 사용하거나 DTM_SETFORMAT 메시지를 명시적으로 보낼 수 있습니다.
DateTime_SetMonthCalColor	DTP(날짜 및 시간 선택기) 컨트롤 내에서 월 달력의 지정된 부분에 대한 색을 설정합니다. 이 매크로를 사용하거나 DTM_SETMCCOLOR 메시지를 명시적으로 보낼 수 있습니다.
DateTime_SetMonthCalFont	DTP(날짜 및 시간 선택기) 컨트롤의 자식 월 달력 컨트롤에서 사용할 글꼴을 설정합니다. 이 매크로를 사용하거나 DTM_SETMCFONT 메시지를 명시적으로 보낼 수 있습니다.
DateTime_SetMonthCalStyle	지정된 DTP 컨트롤의 스타일을 설정합니다. 이 매크로를 사용하거나 DTM_SETMCSTYLE 메시지를 명시적으로 보냅니다.
DateTime_SetRange	DTP(날짜 및 시간 선택기) 컨트롤에 허용되는 최소 및 최대 시스템 시간을 설정합니다. 이 매크로를 사용하거나 DTM_SETRANGE 메시지를 명시적으로 보낼 수 있습니다.
DateTime_SetSystemtime	DTP(날짜 및 시간 선택기) 컨트롤을 지정된 날짜 및 시간으로 설정합니다. 이 매크로를 사용하거나 DTM_SETSYSTEMTIME 메시지를 명시적으로 보낼 수 있습니다.

메시지

항목	콘텐츠
DTM_CLOSEMONTHCAL	DTP 컨트롤을 닫습니다. 이 메시지를 명시적으로 보내거나 DateTime_CloseMonthCal 매크로를 사용하여 보냅니다.
DTM_GETDATETIMEPICKERINFO	DTP(날짜 및 시간 선택기) 컨트롤에 대한 정보를 가져옵니다.
DTM_GETIDEALSIZE	클리핑 없이 컨트롤을 표시하는 데 필요한 크기를 가져옵니다. 이 메시지를 명시적으로 보내거나 DateTime_GetIdealSize 매크로를 사용하여 보냅니다.
DTM_GETMCCOLOR	DTP(날짜 및 시간 선택기) 컨트롤 내에서 월 달력의 지정된 부분에 대한 색을 가져옵니다. 이 메시지를 명시적으로 보내거나 DateTime_GetMonthCalColor 매크로를 사용하여 보낼 수 있습니다.
DTM_GETMCFONT	DTP(날짜 및 시간 선택기) 컨트롤의 자식 월 달력 컨트롤이 현재 사용하는 글꼴을 가져옵니다. 이 메시지를 명시적으로 보내거나 DateTime_GetMonthCalFont 매크로를 사용하여 보낼 수 있습니다.
DTM_GETMCSTYLE	DTP 컨트롤의 스타일을 가져옵니다. 이 메시지를 명시적으로 보내거나 DateTime_GetMonthCalStyle 매크로를 사용하여 보냅니다.
DTM_GETMONTHCAL	DTP(날짜 및 시간 선택기) 자식 월 달력 컨트롤에 대한 핸들을 가져옵니다. 이 메시지를 명시적으로 보내거나 DateTime_GetMonthCal 매크로를 사용하여 보낼 수 있습니다.
DTM_GETRANGE	DTP(날짜 및 시간 선택기) 컨트롤에 허용되는 현재 최소 및 최대 시스템 시간을 가져옵니다. 이 메시지를 명시적으로 보내거나 DateTime_GetRange 매크로를 사용하여 보낼 수 있습니다.
DTM_GETSYSTEMTIME	날짜 및 시간 선택기(DTP) 컨트롤에서 현재 선택된 시간을 가져와 지정된 SYSTEMTIME 구조체에 배치합니다. 이 메시지를 명시적으로 보내거나 DateTime_GetSystemtime 매크로를 사용하여 보낼 수 있습니다.
DTM_SETFORMAT	지정된 형식 문자열을 기반으로 DTP(날짜 및 시간 선택기) 컨트롤의 표시를 설정합니다. 이 메시지를 명시적으로 보내거나 DateTime_SetFormat 매크로를 사용하여 보낼 수 있습니다.
DTM_SETMCCOLOR	DTP(날짜 및 시간 선택기) 컨트롤 내에서 월 달력의 지정된 부분에 대한 색을 설정합니다. 이 메시지를 명시적으로 보내거나 DateTime_SetMonthCalColor 매크로를 사용할 수 있습니다.
DTM_SETMCFONT	DTP(날짜 및 시간 선택기) 컨트롤의 자식 월 달력 컨트롤에서 사용할 글꼴을 설정합니다. 이 메시지를 명시적으로 보내거나 DateTime_SetMonthCalFont 매크로를 사용할 수 있습니다.
DTM_SETMCSTYLE	DTP 컨트롤의 스타일을 설정합니다. 이 메시지를 명시적으로 보내거나 DateTime_SetMonthCalStyle 매크로를 사용하여 보냅니다.
DTM_SETRANGE	DTP(날짜 및 시간 선택기) 컨트롤에 허용되는 최소 및 최대 시스템 시간을 설정합니다. 이 메시지를 명시적으로 보내거나 DateTime_SetRange 매크로를 사용하여 보낼 수 있습니다.
DTM_SETSYSTEMTIME	DTP(날짜 및 시간 선택기) 컨트롤의 시간을 설정합니다. 이 메시지를 명시적으로 보내거나 DateTime_SetSystemtime 매크로를 사용하여 보낼 수 있습니다.

알림

항목	콘텐츠
DTN_CLOSEUP	사용자가 드롭다운 월 달력을 닫을 때 DTP(날짜 및 시간 선택기) 컨트롤에서 전송됩니다. 월 달력은 사용자가 월 달력에서 날짜를 선택하거나 달력이 열려 있는 동안 드롭다운 화살표를 클릭하면 닫힙니다.
DTN_DATETIMECHANGE	변경이 발생할 때마다 DTP(날짜 및 시간 선택기) 컨트롤에서 보냅니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
DTN_DROPDOWN	사용자가 드롭다운 월 달력을 활성화할 때 DTP(날짜 및 시간 선택기) 컨트롤에서 전송됩니다.
DTN_FORMAT	콜백 필드에 표시할 텍스트를 요청하기 위해 DTP(날짜 및 시간 선택기) 컨트롤에서 보냅니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
DTN_FORMATQUERY	콜백 필드에 표시될 문자열의 최대 허용 크기를 검색하기 위해 DTP(날짜 및 시간 선택기) 컨트롤에서 보냅니다. 이 알림 코드는 WM_NOTIFY 메시지 형식으로 전송됩니다.
DTN_USERSTRING	사용자가 컨트롤에서 문자열 편집을 완료할 때 DTP(날짜 및 시간 선택기) 컨트롤에서 전송됩니다. 이 알림 코드는 DTS_APPCANPARSE 스타일로 설정된 DTP 컨트롤에서만 전송됩니다. 이 메시지는 WM_NOTIFY 메시지 형식으로 전송됩니다.
DTN_WMKEYDOWN	사용자가 콜백 필드에 입력하는 경우 DTP(날짜 및 시간 선택기) 컨트롤에서 전송됩니다. 이 메시지는 WM_NOTIFY 메시지 형식으로 전송됩니다.
NM_KILLFOCUS(날짜 시간)	컨트롤이 입력 포커스를 잃었음을 날짜 및 시간 선택기 컨트롤의 부모 창에 알립니다. NM_KILLFOCUS(날짜 시간)는 WM_NOTIFY 메시지 형식으로 전송됩니다.
NM_SETFOCUS(날짜 시간)	컨트롤이 입력 포커스를 받았음을 날짜 및 시간 선택기 컨트롤의 부모 창에 알립니다. NM_SETFOCUS(날짜 시간)는 WM_NOTIFY 메시지 형식으로 전송됩니다.

구조체

항목	콘텐츠
DATETIMEPICKERINFO	DTP 컨트롤에 대한 정보가 포함되어 있습니다.
NMDATETIMECHANGE	DTP(날짜 및 시간 선택기) 컨트롤에서 발생한 변경 내용에 대한 정보가 포함되어 있습니다. 이 구조체는 DTN_DATETIMECHANGE 알림 코드와 함께 사용됩니다.
NMDATETIMEFORMAT	DTP(날짜 및 시간 선택기) 컨트롤 내에서 콜백 필드를 정의하는 형식 문자열의 일부에 대한 정보가 포함되어 있습니다. 콜백 필드를 정의하고 콜백 필드에 표시될 문자열을 수신하는 버퍼를 포함하는 하위 문자열을 전달합니다. 이 구조체는 DTN_FORMAT 알림 코드와 함께 사용됩니다.
NMDATETIMEFORMATQUERY	DTP(날짜 및 시간 선택기) 컨트롤 콜백 필드에 대한 정보가 포함되어 있습니다. 여기에는 콜백 필드를 정의하는 하위 문자열(컨트롤의 형식 문자열에서 가져온)이 포함되어 있습니다. 이 구조체는 콜백 필드에 표시될 텍스트의 허용 가능한 최대 크기를 수신합니다. 이 구조체는 DTN_FORMATQUERY 알림 코드와 함께 사용됩니다.
NMDATETIMESTRING	DTP(날짜 및 시간 선택기) 컨트롤에서 수행된 편집 작업과 관련된 정보가 포함되어 있습니다. 이 메시지는 DTN_USERSTRING 알림 코드와 함께 사용됩니다.
NMDATETIMEWMKEYDOWN	DTN_WMKEYDOWN 알림 코드를 설명하고 처리하는 데 사용되는 정보를 전달합니다.

상수

항목	콘텐츠
날짜 및 시간 선택기 컨트롤 스타일	여기에 나열된 창 스타일은 날짜 및 시간 선택기 컨트롤에만 적용됩니다.