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.

Súmulas

Tópico Conteúdo
sobre controles de seletor de data e hora Um controle DTP (seletor de data e hora) fornece uma interface simples e intuitiva por meio da qual trocar informações de data e hora com um usuário.
usando controles de 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 Conteúdo
DateTime_CloseMonthCal Fecha o controle DTP (seletor de data e hora). Use essa macro ou envie a mensagem 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 DTM_GETIDEALSIZE explicitamente.
DateTime_GetMonthCal Obtém o identificador para um controle de calendário do mês filho do seletor de data e hora (DTP). Você pode usar essa macro ou enviar a mensagem DTM_GETMONTHCAL explicitamente.
DateTime_GetMonthCalColor Obtém a cor de uma determinada parte do calendário do mês dentro de um controle DTP (seletor de data e hora). Você pode usar essa macro ou enviar a mensagem DTM_GETMCCOLOR explicitamente.
DateTime_GetMonthCalFont Obtém a fonte que o controle de calendário do mês filho do controle DTP (seletor de data e hora) está usando no momento. Você pode usar essa macro ou enviar a mensagem DTM_GETMCFONT explicitamente.
DateTime_GetMonthCalStyle Obtém o estilo de um controle DTP especificado. Use essa macro ou envie a mensagem DTM_GETMCSTYLE explicitamente.
DateTime_GetRange Obtém os tempos mínimos e máximos de sistema permitidos atuais para um controle DTP (seletor de data e hora). Você pode usar essa macro ou enviar a mensagem DTM_GETRANGE explicitamente.
DateTime_GetSystemtime Obtém a hora selecionada no momento de um controle DTP (seletor de data e hora) e a coloca em uma estruturaSYSTEMTIMEespecificada. Você pode usar essa macro ou enviar a mensagem 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 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 DTM_SETMCCOLOR explicitamente.
DateTime_SetMonthCalFont Define a fonte a ser usada pelo controle de calendário do mês filho do controle de data e hora (DTP). Você pode usar essa macro ou enviar explicitamente a mensagem DTM_SETMCFONT.
DateTime_SetMonthCalStyle Define o estilo de um controle DTP especificado. Use essa macro ou envie a mensagem DTM_SETMCSTYLE explicitamente.
DateTime_SetRange Define os tempos mínimos e máximos permitidos do sistema para um controle DTP (seletor de data e hora). Você pode usar essa macro ou enviar a mensagem DTM_SETRANGE explicitamente.
DateTime_SetSystemtime Define um controle DTP (seletor de data e hora) como uma determinada data e hora. Você pode usar essa macro ou enviar a mensagem DTM_SETSYSTEMTIME explicitamente.

Mensagens

Tópico Conteúdo
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 DTP (seletor de data e hora).
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 dentro de um controle DTP (seletor de data e hora). Você pode enviar essa mensagem explicitamente ou usar a macro DateTime_GetMonthCalColor.
DTM_GETMCFONT Obtém a fonte que o controle de calendário do 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 um controle de calendário do mês filho do seletor de data e hora (DTP). Você pode enviar essa mensagem explicitamente ou usar a macro DateTime_GetMonthCal.
DTM_GETRANGE Obtém os tempos mínimos e máximos de sistema permitidos atuais 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 selecionada no momento de um controle DTP (seletor de data e hora) e a coloca em uma estruturaSYSTEMTIMEespecificada. 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 do mês filho do controle de data e hora (DTP). 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 os tempos mínimos e máximos permitidos 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 DTP (seletor de data e hora). Você pode enviar essa mensagem explicitamente ou usar a macro DateTime_SetSystemtime.

Notificações

Tópico Conteúdo
DTN_CLOSEUP Enviado por um controle DTP (seletor de data e hora) quando o usuário fecha o calendário do mês suspenso. 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 DTP (seletor de data e hora) 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 DTP (seletor de data e hora) quando o usuário ativa o calendário do 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á exibido 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. Esta mensagem é enviada na forma de uma mensagem de 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. Esta mensagem é enviada na forma de uma mensagem de WM_NOTIFY.
NM_KILLFOCUS (hora da data) Notifica a janela pai de um controle seletor de data e hora de que o controle perdeu o foco de entrada. NM_KILLFOCUS (hora da data) é enviado na forma de uma mensagem de WM_NOTIFY.
NM_SETFOCUS (data e hora) Notifica a janela pai de um controle seletor de data e hora de que o controle recebeu o foco de entrada. NM_SETFOCUS (hora da data) é enviado na forma de uma mensagem de WM_NOTIFY.

Estruturas

Tópico Conteúdo
DATETIMEPICKERINFO Contém informações sobre um controle DTP.
NMDATETIMECHANGE Contém informações sobre uma alteração que ocorreu em um controle DTP (seletor de data e hora). 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 DTP (seletor de data e hora). Ele carrega a subcadeia de caracteres 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 subcadeia de caracteres (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 para uma operação de edição que ocorreu em um controle DTP (seletor de data e hora). 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 Conteúdo
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.
  • Last updated on