TimePicker, TimeEntry et TimeDisplay

4D v20

Le widget TimePicker propose des objets simples d’emploi que vous pouvez utiliser pour valoriser des champs nécessitant la saisie d’heures ou afficher des heures. Il est utilisable sous différentes formes :

Pop up menu simple ou double :

Zone de saisie d’heures au format "hh:mm:ss" associées à un stepper numérique permettant d’augmenter ou de réduire les valeurs d’heures, minutes ou secondes :

Horloge (TimeDisplay) ou horloge digitale (TimeDisplayLCD) :

En outre, chaque type de TimePicker peut afficher l’heure sur 12 heures (AM-PM) ou 24 heures.

Un objet TimePicker peut être utilisé sans programmation grâce aux mécanismes fournis par la variable associée. Toutefois, vous pouvez personnaliser le fonctionnement des objets TimePicker à l'aide des méthodes composant qui sont fournies.

Création et configuration

Vous pouvez insérer une zone TimePicker dans un formulaire de deux manières :

en déposant un objet "TimePicker", "Zone de saisie d'heure" ou "Zone d'affichage d'heure" depuis la bibliothèque d’objets préconfigurés de 4D
en créant une zone de sous-formulaire et en lui affectant le formulaire détaillé TimePicker, TimeEntry, TimeDisplay ou TimeDisplayLCD selon votre choix.

Définissez ensuite le nom de la variable associée au sous-formulaire (propriété "Nom de la variable" dans la Liste des propriétés). A l’exécution du formulaire, cette variable contiendra automatiquement l’heure définie par l’utilisateur. A l’inverse, si vous modifiez par programmation la valeur de cette variable, elle sera automatiquement représentée dans le sous-formulaire. Vous pouvez aussi ne pas nommer de variable afin de bénéficier du mécanisme des variables dynamiques.

A propos des horloges

Les widgets "horloge" sont dessinés en SVG, ils bénéficient donc d’un tracé vectoriel autorisant les déformations en mode Application (en mode Développement, leur taille est fixe) :

A noter que :

Dans l'horloge standard, la trotteuse peut être affichée ou masquée à l’aide de la méthode TimePicker DISPLAY SECOND HAND.
L’horloge standard passe automatiquement en "mode jour" ou "mode nuit" en fonction de l’heure :

Les plages horaires sont 8:00:00 -> 19:59:59 = Jour, 20:00 -> 07:59:59 = Nuit.
Le widget "horloge digitale" est transparent et sans arrière-plan, il peut donc être placé au-dessus d’objets colorés afin de varier les rendus :

Vous disposez de plusieurs options d’affichage pour ce widget, accessibles via les méthodes composant débutant par "TimePicker LCD".

Note: Les développeurs peuvent remplacer le dessin de l’horloge standard par leurs propres créations en remplaçant le fichier "clock.svg" situé au premier niveau du dossier "Resources".

Afficher l’heure courante ou une heure statique

Les horloges peuvent soit afficher dynamiquement l’heure courante soit afficher une heure statique.

Pour afficher l’heure courante, et fonctionner comme une pendule :
- Lors de l'utilisation d'une variable comme source de données, associez une variable numérique à l’objet sous-formulaire du widget (fonctionnement par défaut).
- Lors de l'utilisation d'une propriété d'objet comme source de données ( par exemple Form.myTime), associez une variable numérique ou Heure à l’objet sous-formulaire du widget.

Note : Vous pouvez appliquer un décalage à l’heure affichée : la valeur de la variable numérique indique le décalage en secondes. Par exemple, 3600 = avancer la pendule d’une heure, -1800 = reculer la pendule de 30 mn, etc.

Pour afficher une heure statique :
- Lors de l'utilisation d'une variable comme source de données, associez une variable Heure ou Texte à l'objet sous-formulaire du widget (en utilisant la langue ou la liste des propriétés).
- Lors de l'utilisation d'une propriété d'objet comme source de données (par exemple Form.myTime), associer une valeur Texte à l'objet sous-formulaire du widget.

Par exemple, on souhaite afficher 10:10:30 :

avec une variable comme source de données :

 C_TIME(myTime) //myTime est la source de données du widget

 myTime:=?10:10:30?

 

  // équivalent à :

 C_TEXT(myOtherTime) // myOtherTime est la source de données du widget

 myOtherTime:="10:10:30"

avec une propriété d'objet comme source de données :

Form.myTime:="10:10:30" // Form.myTime est la source de données du widget