Compartilhar via

macro DateTime_SetRange (commctrl.h)

  • Artigo

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

void DateTime_SetRange(
   hdp,
   gd,
   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 flags .

Retornar valor

Nenhum

Comentários

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
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho commctrl.h