4D Doc Center : TimePicker y TimeEntry

4D v14

TimePicker y TimeEntry

El widget TimePicker ofrece objetos fáciles de usar que puede utilizar para aprovechar los campos que requieren introducir o mostrar horas. Se puede utilizar en las siguientes formas:

Pop-up simple o doble:

Área de entrada de hora: en formato "hh:mm:ss" asociado con un paso a paso numérico que se puede utilizar para aumentar o disminuir el valor de las horas, los minutos o los segundos:

Relojes (TimeDisplay) o relojes digitales (TimeDisplayLCD):

Además, cada tipo de TimePicker puede mostrar la hora en formato de 12 horas (AM-PM) o 24 horas.

Un objeto TimePicker puede utilizarse sin programación gracias al mecanismo previsto por la variable asociada. Sin embargo, si desea personalizar el funcionamiento de los objetos TimePicker, puede utilizar el conjunto de métodos componente que se ofrece.

Creación y uso

Puede insertar un área TimePicker en un formulario de dos maneras:

Mediante la inserción de un objeto "TimePicker" o "TimeEntry" de la librería de objetos preconfigurados de 4D.
Con la creación de un área de subformulario y asignándola al formulario detallado TimePicker, TimeEntry o TimeDisplayLCD de su elección.

A continuación, especifique el nombre de la variable asociada al subformulario (propiedad "Nombre de variable" en la Lista de propiedades). Cuando el formulario se ejecuta, esta variable contendrá automáticamente la hora definida por el usuario. Por el contrario, si modifica el valor de esta variable por la programación, automáticamente se mostrarán en el subformulario. También puede optar por no nombrar la variable con el fin de beneficiarse del mecanismo de las variables dinámicas.

Acerca de relojes (nuevo en v14)

Los widgets de reloj se dibujan en SVG, y por consiguiente tienen un patrón en vectores permitiendo así deformaciones en modo Aplicación (en modo Diseño, su tamaño se ajusta):

Note que:

Para un reloj estándar, la segunda manecilla se puede mostrar u ocultar usando el método TimePicker DISPLAY SECOND HAND.
Un reloj estándar cambia automáticamente a "modo día" o "modo noche" dependiendo de la hora:

Los rangos horarios son 8:00:00 -> 19:59:59 = Día, 20:00 -> 07:59:59 = Noche.
El widget "reloj digital" es transparente y no tiene color de fondo, así que se puede ubicar sobre objetos de color para modificar su apariencia:

Hay muchas opciones para este widget disponibles a través de los métodos de componente los cuales están prefijados por "TimePicker LCD".

Nota: Los desarrolladores pueden desplazar este reloj y sustituirlo con sus propias creaciones, reemplazando el archivo "clock.svg" que se encuentra en el primer nivel de la carpeta "Recursos".

Mostrar la hora actual o una hora estática

Los relojes pueden mostrar la hora actual dinámicamente o mostrar una hora estática.

Para mostrar la hora actual, asocie la variable Real al objeto subformulario del widget (operación por defecto). En este caso, el widget muestra automáticamente la hora actual y funciona como un reloj.
Usted puede hacer una compensación de la hora: el valor numérico de la variable indica la compensación en segundos. Por ejemplo, 3600 = avanzar el reloj una hora, -1800= retrasar el reloj 30 minutos, etc.

Para mostrar una hora estática, asocie la variable Time al objeto subformulario del widget (usando el comando C_TIME o la lista de propiedades). Entonces el reloj muestra el valor de esta variable.

Por ejemplo, queremos que el reloj muestre 10:10:30:

C_TIME(myvar) // myvar es el nombre de la variable del widget</p><p>myvar:=?10:10:30?