TimePicker e TimeEntry

4D v20 R8

O widget TimePicker oferece objetos fáceis de usar que pode utilizar para aproveitar os campos que requerem a entrada ou mostrar horas. Podem ser utilizados das seguintes formas:

Pop-up simples ou duplo:

Área de entrada de horas em formato "hh:mm:ss" associadas com um passo a passo numérico que pode ser utilizado para aumentar ou diminuir o valor das horas, minutos ou segundos:

Relógios (TimeDisplay) ou relógios digitais (TimeDisplayLCD):

Além disso, cada tipo de TimePicker pode mostrar a hora em formato de 12 horas (AM-PM) ou 24 horas.

Um objeto TimePicker pode ser utilizado sem programação graças ao mecanismo previsto pela variável associada. No entanto, se deseja personalizar o funcionamento dos objetos TimePicker, pode utilizar o conjunto de métodos componente que se oferece.

Criação e uso

Pode inserir uma área TimePicker em um formulário de duas formas:

Mediante a inserção de um objeto "TimePicker" ou "TimeEntry" da livraria de objetos pré configurados de 4D.
Com a criação de uma área de subformulário e atribuindo ao formulário detalhado TimePicker, TimeEntry ou TimeDisplayLCD de sua escolha.

A continuação, especifique o nome da variável hora associada ao subformulário (propriedade "Nome de variável" na Lista de propriedades). Quando o formulário se executa, esta variável conterá automaticamente a hora definida pelo usuário. Pelo contrário, se modifica o valor desta variável pela programação, automaticamente serão mostrados no subformulário. Também pode optar por não nomear a variável com o propósito de se beneficiar do mecanismo das variáveis dinâmicas.

Sobre relógios (novo em v14)

Os widgets de relógio se desenham em SVG, e consequentemente tem um patrão em vetores permitindo assim deformações em modo Aplicação (em modo Desenho, seu tamanho se ajusta):

Note que:

Para um relógio estandarte, a segunda mão pode mostrar ou ocultar usando o método TimePicker DISPLAY SECOND HAND.
Um relógio estandarte muda automaticamente a "modo dia" ou "modo noite" dependendo da hora:

As faixas horárias são 8:00:00 -> 19:59:59 = Dia, 20:00 -> 07:59:59 = Noite.
O widget "relógio digital" é transparente e não tem cor de fundo, assim que pode ser localizado sobre objetos de cor para modificar sua aparência:

Há muitas opções para este widget disponíveis através dos métodos de componente os quais estão prefixados por "TimePicker LCD".

Nota: Os desenvolvedores podem deslocar este relógio e substituir ele com suas próprias criações, trocando o arquivo "clock.svg" que se encontra no primeiro nível da pasta "Recursos".

Mostrar a hora atual ou uma hora estática

Os relógios podem mostrar a hora atual dinamicamente ou mostrar uma hora estática.

Para mostrar a hora atual e funcionar como um relógio:

quando usar uma variável comodatsource, associar uma variavel Integer ao objeto subformulário do widget (por padrão)
ao usar uma propriedade objeto como fonte de dados |(por exemplo Form.myTime) associe um valor Integer ou Time ao objeto subformulário do widget

NOta: Você pode fazer uma compensação da hora: O valor numérico da variável indica a compensação em segundos. Por exemplo, 3600 = atrasar o relógio uma hora, -1800= adiantar o relógio 30 minutos, etc.

Para mostrar uma hora estática:
- quando usar uma variável como datasource, associe uma a variável Time ou Text ao objeto sub formulário do widget (usando a linguagem ou a lista de propriedades).
- Quando usar uma propriedade objeto, como datasource (por exemplo Form.myTime) associe um valor de Text ao objeto subformulário do widget..

Por exemplo, queremos que o relógio mostre 10:10:30:

com uma variável como datasource

 C_TIME(myTime) // myTime é o datasource do widget

 myTime:=?10:10:30?

 

  // equivalente a:

 C_TEXT(myOtherTime) // myOtherTime é o datasource do widget

 myOtherTime:="10:10:30"

com uma propriedade objeto como datasource:

Form.myTime:="10:10:30" // Form.myTime é o datasource do widget