Средство выбора даты и времени
В этом разделе содержатся сведения об элементах 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 . |
Константы
| Раздел | Содержимое |
|---|---|
| Стили элементов управления "Выбор даты и времени" | Стили окон, перечисленные здесь, относятся к элементам управления выбора даты и времени. |