Compartilhar via


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.