Средство выбора даты и времени

В этом разделе содержатся сведения об элементах 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.

Notifications

Раздел	Содержимое
DTN_CLOSEUP	Отправляется элементом управления выбора даты и времени (DTP), когда пользователь закрывает раскрывающийся календарь месяца. Календарь месяца закрывается, когда пользователь выбирает дату из календаря месяца или щелкает стрелку раскрывающегося списка во время открытия календаря.
DTN_DATETIMECHANGE	Отправляется элементом управления выбора даты и времени (DTP) при каждом изменении. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
DTN_DROPDOWN	Отправляется элементом управления выбора даты и времени (DTP), когда пользователь активирует раскрывающийся календарь месяца.
DTN_FORMAT	Отправляется элементом управления выбора даты и времени (DTP) для запроса текста, отображаемого в поле обратного вызова. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
DTN_FORMATQUERY	Отправляется элементом управления выбора даты и времени (DTP), чтобы получить максимальный допустимый размер строки, которая будет отображаться в поле обратного вызова. Этот код уведомления отправляется в виде сообщения WM_NOTIFY.
DTN_USERSTRING	Отправляется элементом управления выбора даты и времени (DTP), когда пользователь завершает редактирование строки в элементе управления. Этот код уведомления отправляется только элементами управления DTP, заданными в стиле DTS_APPCANPARSE. Это сообщение отправляется в виде сообщения 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 .

Константы

Раздел	Содержимое
Стили элементов управления "Выбор даты и времени"	Стили окон, перечисленные здесь, относятся к элементам управления выбора даты и времени.