Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Esta seção contém informações sobre os elementos da API usados com controles de seletor de data e hora.
Visão geral
| Tópico | Índice |
|---|---|
| Sobre os controles do seletor de data e hora | Um de controle de seletor de data e hora (DTP) fornece uma interface simples e intuitiva através 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 | Índice |
|---|---|
| DateTime_CloseMonthCal | Fecha o controle DTP (seletor de data e hora). Use esta macro ou envie a mensagem DTM_CLOSEMONTHCAL explicitamente. |
| DateTime_GetDateTimePickerInfo | Obtém informações para um controle de seletor de data e hora (DTP) especificado. |
| DateTime_GetIdealSize | Obtém o tamanho necessário para exibir o controle sem recorte. Use esta macro ou envie a mensagem DTM_GETIDEALSIZE explicitamente. |
| DateTime_GetMonthCal | Obtém o identificador para um controle de calendário 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 para uma determinada parte do calendário do mês dentro de um controle de seletor de data e hora (DTP). Você pode usar essa macro ou enviar a mensagem DTM_GETMCCOLOR explicitamente. |
| DateTime_GetMonthCalFont | Obtém a fonte que o controle de calendário de mês filho do controle de data e hora (DTP) 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 esta macro ou envie a mensagem DTM_GETMCSTYLE explicitamente. |
| DateTime_GetRange | Obtém os tempos mínimos e máximos permitidos atuais do sistema 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 atualmente selecionada de um controle DTP (seletor de data e hora) e a coloca em uma estrutura deSYSTEMTIMEespecificada. 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 para uma determinada parte do calendário do mês dentro de um controle de seletor de data e hora (DTP). 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 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 esta 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 de seletor de data e hora (DTP) para uma determinada data e hora. Você pode usar essa macro ou enviar a mensagem DTM_SETSYSTEMTIME explicitamente. |
Mensagens
| Tópico | Índice |
|---|---|
| DTM_CLOSEMONTHCAL | Fecha um controle DTP. Envie esta 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 esta mensagem explicitamente ou usando a macro DateTime_GetIdealSize. |
| DTM_GETMCCOLOR | Obtém a cor para uma determinada parte do calendário do mês dentro de 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 de data e hora (DTP) 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 esta mensagem explicitamente ou usando a macro DateTime_GetMonthCalStyle. |
| DTM_GETMONTHCAL | Obtém o identificador para um controle de calendário 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 permitidos atuais 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 deSYSTEMTIMEespecificada. 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 para uma determinada parte do calendário do mês dentro de um controle de seletor de data e hora (DTP). 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 esta 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 | Índice |
|---|---|
| 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 DTP (seletor de data e hora) sempre que ocorre uma alteração. Este código de notificação é enviado na forma de uma mensagem WM_NOTIFY. |
| DTN_DROPDOWN | Enviado por um controle de seletor de data e hora (DTP) quando o usuário ativa o calendário suspenso do mês. |
| 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. Este código de notificação é enviado na forma de uma mensagem 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. Este código de notificação é enviado na forma de uma mensagem 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 sob a forma de uma mensagem WM_NOTIFY. |
| DTN_WMKEYDOWN | Enviado por um controle de seletor de data e hora (DTP) quando o usuário digita em um campo de retorno de chamada. Esta mensagem é enviada sob a 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 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 | Índice |
|---|---|
| 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 DTP (seletor de data e hora). 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 para uma operação de edição que ocorreu em um controle DTP (seletor de data e hora). Esta mensagem é usada com o código de notificação DTN_USERSTRING. |
| NMDATETIMEWMKEYDOWN | Carrega informações usadas para descrever e lidar com um código de notificação DTN_WMKEYDOWN. |
Constantes
| Tópico | Índice |
|---|---|
| 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. |