Usar o controle DateTimePicker no Visual FoxPro

Este artigo descreve como usar o controle DateTimePicker no Visual FoxPro.

Versão original do produto: Visual FoxPro
Número de KB original: 259646

Resumo

DTPicker.exe é um exemplo que mostra como usar o controle ActiveX DateTimePicker.

Mais informações

O arquivo a seguir está disponível para download no Centro de Download da Microsoft:

Baixe o pacote DTPicker.exe agora. Data de lançamento: Abr-26-2000

Para obter mais informações sobre como baixar Suporte da Microsoft arquivos, consulte Como obter arquivos de suporte da Microsoft de serviços online.

A Microsoft examinou esse arquivo em busca de vírus. A Microsoft usou o software de detecção de vírus mais atual que estava disponível na data em que o arquivo foi postado. O arquivo é armazenado em servidores aprimorados pela segurança que ajudam a evitar alterações não autorizadas no arquivo.

O arquivo DTPicker.exe contém os seguintes arquivos:

Nome do arquivo Tamanho
ReadMe.txt 3560
DTPicker.scx 4630
DTPicker.sct 19897

Sobre o controle DateTimePicker

O controle DateTimePicker permite que você forneça um campo de datetime formatado que permita uma seleção de data ou hora fácil. Além disso, os usuários podem selecionar uma data de uma interface de calendário suspensa semelhante ao controle MonthView.

O controle DateTimePicker opera em dois modos:

  • Modo calendário suspenso (padrão) – permite que o usuário exiba um calendário suspenso que pode ser usado para selecionar uma data.

  • Modo Formato de Hora – permite que o usuário selecione um campo na exibição de data (como, o mês, o dia, o ano e assim por diante) e pressione a seta PARA CIMA ou PARA BAIXO à direita do controle para definir seu valor.

Você pode navegar até o controle usando o teclado ou o mouse. O calendário suspenso tem dois botões que permitem rolar os meses dentro e fora de exibição.

Observação

O controle DateTimePicker faz parte de um grupo de controles ActiveX encontrados no arquivo Mscomct2.ocx. Para usar o controle DateTimePicker em seu aplicativo, você deve adicionar o arquivo Mscomct2.ocx ao projeto. Ao distribuir seu aplicativo, instale o arquivo Mscomct2.ocx no diretório Microsoft Windows System ou System32 do usuário.

Sobre este exemplo

Este exemplo fornece um formulário que contém o controle DateTimePicker junto com controles adicionais que permitem manipular as várias propriedades no controle e ver os resultados. Vários controles são configurados apenas como leitura porque a propriedade que eles representam do controle DateTimePicker é somente gravação. Você pode acessar o valor atual de data/hora da Object.Value propriedade no controle ou nas propriedades que correspondem às várias partes de um valor datetime (Ano, Mês, Dia, Hora, Minuto, Segundo e assim por diante).

Com o controle DateTimePicker, você pode especificar um intervalo válido de datetimes, bem como o formato do valor datetime exibido no controle. Os formatos disponíveis são Data Longa (0), Data Curta (1), Hora (2) e Personalizado (3). Se o formato Personalizado for especificado, você poderá usar os caracteres de formato compatíveis com o controle DateTimePicker para personalizar o formato às suas necessidades.

Observação

A CustomFormat propriedade é sensível a maiúsculas de minúsculas. Enquanto os formatos M e MM se referem a Meses, os valores de minúsculas m e mm referem-se a minutos. Você também precisa observar que h, hh, H e H se referem a horas; os valores de caso inferior h e hh referem-se a horas no formato de doze horas, enquanto o caso superior H e HH referem-se a horas no formato de vinte e quatro horas.

Conforme mencionado anteriormente, o DateTimePicker é capaz de operar em um dos dois modos (Calendário suspenso ou Formato de Tempo). Isso é controlado pela UpDown propriedade. Quando a UpDown propriedade é definida como True (.T.), o controle está no modo Formato de Tempo. Isso é evidente pela aparência dos botões giratórios na extrema direita do controle. Nesse modo, o usuário pode selecionar uma parte do valor datetime (Mês, Dia, Ano, Hora, Minuto e assim por diante) e girar os valores até que o datetime desejado seja atingido. Quando a UpDown propriedade é definida como False (.F.) o controle está no modo Calendário suspenso. Isso é evidente pela aparência de um botão suspenso na extrema direita do controle. Nesse modo, a parte de hora do valor datetime não será alterada.

Observação

Quando o formato do controle DateTimePicker é definido como Hora (2), a UpDown propriedade é ignorada e o controle está no modo Formato de Tempo.

O controle DateTimePicker pode ter uma caixa de seleção habilitada no controle. Quando essa caixa de seleção estiver limpa (desmarcada), os valores de data e hora retornados do controle são . NULL. Valores.

Referências

Para obter mais informações sobre o controle DateTimePicker, consulte esse tópico no arquivo ajuda de controles do Windows, CMCTL298. CHM, localizado onde você instalou seu Biblioteca MSDN.

Para obter mais informações sobre como adicionar um controle ActiveX a um projeto, confira "Adicionar controles a um projeto" no Guia do Programador.