DateTime_SetRange macro (commctrl.h)

Artigo
10/24/2024

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.

Sintaxe

BOOL DateTime_SetRange(
   HWND         hdp,
   DWORD        gd,
   LPSYSTEMTIME rgst
);

Parâmetros

hdp

Tipo: HWND

Um identificador para um controle DTP.

gd

Tipo: DWORD

Um valor que especifica quais valores de intervalo são válidos. Esse valor pode ser uma combinação do seguinte:

Valor	Significado
GDTR_MIN	O primeiro elemento na matriz de estrutura SYSTEMTIME é válido e será usado para definir o tempo mínimo permitido do sistema.
GDTR_MAX	O segundo elemento na matriz de estrutura SYSTEMTIME é válido e será usado para definir o tempo máximo permitido do sistema.

rgst

Tipo: LPSYSTEMTIME

Um ponteiro para uma matriz de dois elementos de estruturas SYSTEMTIME. O primeiro elemento da matriz SYSTEMTIME contém o tempo mínimo permitido. O segundo elemento da matriz SYSTEMTIME contém o tempo máximo permitido. Não é necessário preencher um elemento de matriz que não é especificado no parâmetro gd.

Valor de retorno

Tipo: BOOL

Retornará diferente de zero se tiver êxito ou zero de outra forma.

Observações

O seletor de data e hora exibe apenas datas/horas que se enquadram no intervalo especificado, impedindo que o usuário selecione uma data e hora que fiquem fora do intervalo. Se a mensagem DateTime_SetSystemtime especificar uma data e hora fora do intervalo, ela falhará.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	commctrl.h

Compartilhar via