Seletor de data e hora

Esta seção contém informações sobre os elementos de API usados com controles de seletor de data e hora.

Visões gerais

Tópico	Contents
Sobre os controles do seletor de data e hora	Um controle DTP (seletor de data e hora) fornece uma interface simples e intuitiva por meio da qual é possível trocar informações de data e hora com um usuário.
Usando controles do seletor de data e hora	Esta seção fornece informações e código de exemplo para implementar controles de seletor de data e hora.

Macros

Tópico	Contents
DateTime_CloseMonthCal	Fecha o controle DTP (seletor de data e hora). Use essa macro ou envie a mensagem de DTM_CLOSEMONTHCAL explicitamente.
DateTime_GetDateTimePickerInfo	Obtém informações para um controle DTP (seletor de data e hora) especificado.
DateTime_GetIdealSize	Obtém o tamanho necessário para exibir o controle sem recorte. Use essa macro ou envie a mensagem de DTM_GETIDEALSIZE explicitamente.
DateTime_GetMonthCal	Obtém o identificador para o controle de calendário de mês filho (DTP) de um seletor de data e hora. Você pode usar essa macro ou enviar a mensagem de DTM_GETMONTHCAL explicitamente.
DateTime_GetMonthCalColor	Obtém a cor de uma determinada parte do calendário do mês em um controle de seletor de data e hora (DTP). Você pode usar essa macro ou enviar a mensagem de DTM_GETMCCOLOR explicitamente.
DateTime_GetMonthCalFont	Obtém a fonte que o controle de calendário de mês filho do controle DTP (seletor de data e hora) está usando no momento. Você pode usar essa macro ou enviar a mensagem de DTM_GETMCFONT explicitamente.
DateTime_GetMonthCalStyle	Obtém o estilo de um controle DTP especificado. Use essa macro ou envie a mensagem de DTM_GETMCSTYLE explicitamente.
DateTime_GetRange	Obtém as horas mínimas e máximas permitidas do sistema para um controle DTP (seletor de data e hora). Você pode usar essa macro ou enviar a mensagem de DTM_GETRANGE explicitamente.
DateTime_GetSystemtime	Obtém a hora atualmente selecionada de um controle DTP (seletor de data e hora) e a coloca em uma estrutura SYSTEMTIME especificada. Você pode usar essa macro ou enviar a mensagem de DTM_GETSYSTEMTIME explicitamente.
DateTime_SetFormat	Define a exibição de um controle DTP (seletor de data e hora) com base em uma determinada cadeia de caracteres de formato. Você pode usar essa macro ou enviar a mensagem de DTM_SETFORMAT explicitamente.
DateTime_SetMonthCalColor	Define a cor de uma determinada parte do calendário do mês em um controle DTP (seletor de data e hora). Você pode usar essa macro ou enviar a mensagem de DTM_SETMCCOLOR explicitamente.
DateTime_SetMonthCalFont	Define a fonte a ser usada pelo controle de calendário de mês filho do controle DTP (seletor de data e hora). Você pode usar essa macro ou enviar explicitamente a mensagem DTM_SETMCFONT.
DateTime_SetMonthCalStyle	Define o estilo para um controle DTP especificado. Use essa macro ou envie a mensagem DTM_SETMCSTYLE explicitamente.
DateTime_SetRange	Define as horas mínimas e máximas permitidas do sistema para um controle DTP (seletor de data e hora). Você pode usar essa macro ou enviar a mensagem de DTM_SETRANGE explicitamente.
DateTime_SetSystemtime	Define um controle de seletor de data e hora (DTP) para uma determinada data e hora. Você pode usar essa macro ou enviar a mensagem de DTM_SETSYSTEMTIME explicitamente.

Mensagens

Tópico	Contents
DTM_CLOSEMONTHCAL	Fecha um controle DTP. Envie essa mensagem explicitamente ou usando a macro DateTime_CloseMonthCal.
DTM_GETDATETIMEPICKERINFO	Obtém informações sobre um controle de seletor de data e hora (DTP).
DTM_GETIDEALSIZE	Obtém o tamanho necessário para exibir o controle sem recorte. Envie essa mensagem explicitamente ou usando a macro DateTime_GetIdealSize.
DTM_GETMCCOLOR	Obtém a cor de uma determinada parte do calendário do mês em um controle de seletor de data e hora (DTP). Você pode enviar essa mensagem explicitamente ou usar a macro DateTime_GetMonthCalColor.
DTM_GETMCFONT	Obtém a fonte que o controle de calendário de mês filho do controle DTP (seletor de data e hora) está usando no momento. Você pode enviar essa mensagem explicitamente ou usar a macro DateTime_GetMonthCalFont.
DTM_GETMCSTYLE	Obtém o estilo de um controle DTP. Envie essa mensagem explicitamente ou usando a macro DateTime_GetMonthCalStyle.
DTM_GETMONTHCAL	Obtém o identificador para o controle de calendário de mês filho (DTP) de um seletor de data e hora. Você pode enviar essa mensagem explicitamente ou usar a macro DateTime_GetMonthCal.
DTM_GETRANGE	Obtém as horas mínimas e máximas permitidas do sistema para um controle DTP (seletor de data e hora). Você pode enviar essa mensagem explicitamente ou usar a macro DateTime_GetRange.
DTM_GETSYSTEMTIME	Obtém a hora atualmente selecionada de um controle DTP (seletor de data e hora) e a coloca em uma estrutura SYSTEMTIME especificada. Você pode enviar essa mensagem explicitamente ou usar a macro DateTime_GetSystemtime.
DTM_SETFORMAT	Define a exibição de um controle DTP (seletor de data e hora) com base em uma determinada cadeia de caracteres de formato. Você pode enviar essa mensagem explicitamente ou usar a macro DateTime_SetFormat.
DTM_SETMCCOLOR	Define a cor de uma determinada parte do calendário do mês em um controle DTP (seletor de data e hora). Você pode enviar essa mensagem explicitamente ou usar a macro DateTime_SetMonthCalColor.
DTM_SETMCFONT	Define a fonte a ser usada pelo controle de calendário de mês filho do controle DTP (seletor de data e hora). Você pode enviar essa mensagem explicitamente ou usar a macro DateTime_SetMonthCalFont.
DTM_SETMCSTYLE	Define o estilo de um controle DTP. Envie essa mensagem explicitamente ou usando a macro DateTime_SetMonthCalStyle.
DTM_SETRANGE	Define as horas mínimas e máximas permitidas do sistema para um controle DTP (seletor de data e hora). Você pode enviar essa mensagem explicitamente ou usar a macro DateTime_SetRange.
DTM_SETSYSTEMTIME	Define a hora em um controle de seletor de data e hora (DTP). Você pode enviar essa mensagem explicitamente ou usar a macro DateTime_SetSystemtime.

Notifications

Tópico	Contents
DTN_CLOSEUP	Enviado por um controle de seletor de data e hora (DTP) quando o usuário fecha o calendário suspenso do mês. O calendário do mês é fechado quando o usuário escolhe uma data do calendário do mês ou clica na seta suspensa enquanto o calendário está aberto.
DTN_DATETIMECHANGE	Enviado por um controle de seletor de data e hora (DTP) sempre que ocorre uma alteração. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
DTN_DROPDOWN	Enviado por um controle de seletor de data e hora (DTP) quando o usuário ativa o calendário de mês suspenso.
DTN_FORMAT	Enviado por um controle DTP (seletor de data e hora) para solicitar que o texto seja exibido em um campo de retorno de chamada. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
DTN_FORMATQUERY	Enviado por um controle DTP (seletor de data e hora) para recuperar o tamanho máximo permitido da cadeia de caracteres que será exibida em um campo de retorno de chamada. Esse código de notificação é enviado na forma de uma mensagem de WM_NOTIFY.
DTN_USERSTRING	Enviado por um controle DTP (seletor de data e hora) quando um usuário termina de editar uma cadeia de caracteres no controle. Esse código de notificação só é enviado por controles DTP definidos para o estilo DTS_APPCANPARSE. Essa mensagem é enviada na forma de uma mensagem WM_NOTIFY.
DTN_WMKEYDOWN	Enviado por um controle DTP (seletor de data e hora) quando o usuário digita em um campo de retorno de chamada. Essa mensagem é enviada na forma de uma mensagem WM_NOTIFY.
NM_KILLFOCUS (data e hora)	Notifica a janela pai de um controle de seletor de data e hora de que o controle perdeu o foco de entrada. NM_KILLFOCUS (data e hora) é enviada na forma de uma mensagem de WM_NOTIFY.
NM_SETFOCUS (data e hora)	Notifica a janela pai de um controle de seletor de data e hora de que o controle recebeu o foco de entrada. NM_SETFOCUS (data e hora) é enviada na forma de uma mensagem WM_NOTIFY .

Estruturas

Tópico	Contents
DATETIMEPICKERINFO	Contém informações sobre um controle DTP.
NMDATETIMECHANGE	Contém informações sobre uma alteração que ocorreu em um controle de seletor de data e hora (DTP). Essa estrutura é usada com o código de notificação DTN_DATETIMECHANGE.
NMDATETIMEFORMAT	Contém informações sobre uma parte da cadeia de caracteres de formato que define um campo de retorno de chamada dentro de um controle de seletor de data e hora (DTP). Ele carrega a substring que define o campo de retorno de chamada e contém um buffer para receber a cadeia de caracteres que será exibida no campo de retorno de chamada. Essa estrutura é usada com o código de notificação DTN_FORMAT.
NMDATETIMEFORMATQUERY	Contém informações sobre um campo de retorno de chamada de controle DTP (seletor de data e hora). Ele contém uma substring (retirada da cadeia de caracteres de formato do controle) que define um campo de retorno de chamada. A estrutura recebe o tamanho máximo permitido do texto que será exibido no campo de retorno de chamada. Essa estrutura é usada com o código de notificação DTN_FORMATQUERY.
NMDATETIMESTRING	Contém informações específicas de uma operação de edição que ocorreu em um controle de seletor de data e hora (DTP). Essa mensagem é usada com o código de notificação DTN_USERSTRING.
NMDATETIMEWMKEYDOWN	Carrega informações usadas para descrever e manipular um código de notificação DTN_WMKEYDOWN .

Constantes

Tópico	Contents
Estilos de controle do seletor de data e hora	Os estilos de janela listados aqui são específicos para controles de seletor de data e hora.