Skip to main content

Élément de visualisation : sélecteur de date/heure

Symbole:

_visu_icon_date_and_time_picker.png

Catégorie: Contrôles date/heure

L'élément permet à l'utilisateur de la visualisation de sélectionner une date (dans un calendrier) avec une heure.

Propriétés des éléments

Toutes les propriétés des éléments sont-elles disponibles ?

Toutes les propriétés ne sont disponibles qu'après avoir sélectionné le Avancé option ou la Toutes les catégories filtrer dans Propriétés.

Nom de l'élément

Exemple: StartDateAndTime

Astuce

Attribuez des noms individuels aux éléments afin qu'ils soient trouvés plus rapidement dans la liste des éléments.

Type d'élément

Sélecteur de date/heure

Position

La position définit l'emplacement et la taille de l'élément dans la fenêtre de visualisation. Elle est basée sur le système de coordonnées cartésiennes. L'origine se situe dans le coin supérieur gauche de la fenêtre. L'axe horizontal positif des X est orienté vers la droite. L'axe vertical positif des Y est orienté vers le bas.

X

La coordonnée X (en pixels) du coin supérieur gauche de l'élément

Exemple: 10

Y

La coordonnée Y (en pixels) du coin supérieur gauche de l'élément

Exemple: 10

Largeur

Spécifié en pixels

Exemple: 150

Hauteur

Spécifié en pixels

Exemple: 30

Astuce

Vous pouvez modifier les valeurs en faisant glisser la module _visu_icon_position_element.png symboles vers d'autres positions dans l'éditeur.

Variable

Variable

Facultatif

  • Variable (DATE, DT, LDATE, LDT, LTIME, LTOD, TIME, TOD) pour la valeur de date et d'heure

  • Si aucune variable n'est configurée, l'élément affiche automatiquement l'heure système. La valeur peut être ajustée par l'utilisateur de la visualisation.

. Le type de données détermine automatiquement les unités de valeur affichées :

  • DATE:Année, mois et jour

  • DT:Année, mois, jour, heure, minute et seconde

  • LTIME: Jour, heure, minute et seconde (par défaut, les millisecondes, microsecondes et nanosecondes ne sont pas affichées)

  • TIME: Jour, heure, minute et seconde (par défaut, les millisecondes ne sont pas affichées)

  • TOD: Heure, minute et seconde (par défaut, les millisecondes ne sont pas affichées)

Format de chaîne

Important

Si l'élément doit afficher l'heure système en temps universel (UTC), vous devez vous assurer que la variable VisuElems.Visu_DateTime.DisplayUTC est réglé sur TRUE dans l'application.

Vous pouvez également régler l'affichage de l'heure mondiale (UTC) avec l'option format Z.

Formate l'affichage de la valeur de date et d'heure afin que, par exemple, l'affichage puisse être limité à une unité de temps

Options pour spécifier la chaîne de format

  • En tant que chaîne fixe

    Exemple: yyyy-dd-MM

  • En tant que référence à une entrée de liste de textes <nom de la liste de textes>.<ID>

    Une chaîne de format y est définie pour chaque langue.

_visu_elem_prop_formatstring_ref_to_tlentry.png

Exemples

  • LTIME variable avec chaîne de format HH:mm:ss.ms.us.ns –> Affichage : 08:15:12.780.150.360

  • LTIME variable avec chaîne de format restrictive HH:mm –> Affichage : 08:15

  • DATE variable avec chaîne de format yyyy/MM/dd –> Affichage : 17/12/2015

  • Si aucune valeur n'est spécifiée dans Variable et la variable VisuElems.Visu_DateTime.DisplayUTC = TRUE est défini et contrôlé par le programme et la chaîne de format contient l'identifiant Z (dd:MM:yyyy HH:mm:ss:ms:Z), cela donne alors la sortie du temps universel (01.08.2021 10:12:03:450:Z).

  • Si aucune valeur n'est spécifiée dans Variable et la variable VisuElems.Visu_DateTime.DisplayUTC = FALSE est défini et contrôlé par le programme et la chaîne de format contient l'identifiant Z (dd:MM:yyyy HH:mm:ss:ms:Z), cela donne alors la sortie de l'heure locale avec un décalage par rapport à l'heure universelle (01.08.2021 10:12:03:450:+02:00 )

  • DateTime.DTPicker (entrée de liste de texte)

    Pour chaque langue de l'application, l'entrée de la liste de texte fait référence à une chaîne de format.

Note

En gros, tout %t Les options de format prises en charge sont décrites dans le "Espaces réservés avec définition de format" chapitre.

Astuce

Vous pouvez changer par programmation le fuseau horaire local de l'heure système vers l'heure universelle (UTC).

Lorsque la variable VisuElems.Visu_DateTime.DisplayUTC est réglé sur TRUE, l'heure système est affichée en temps universel (UTC). Par défaut, la variable VisuElems.Visu_DateTime.DisplayUTC est réglé sur FALSE afin que l'heure du système soit affichée dans le fuseau horaire local.

Pour l'affichage des valeurs de date et d'heure, vous pouvez étendre les valeurs respectives chaîne de format avec le code du fuseau horaire Z. Pour une sortie en heure système locale, le décalage est alors affiché en temps universel (UTC). Par exemple, dd:MM:yyyy HH:mm:ss:ms:Z sorties 01.08.2021 12:00:00:001:+02:00Lorsque l'heure universelle (UTC) est affichée, le code UTC est également affiché. 01.08.2021 10:00:00:001:Z

Sélecteur de date/heure de conception

  • Du style:Tous les paramètres sont préconfigurés en fonction du style.

  • Explicite: Le Paramètres de conception La propriété est disponible. Vous pouvez personnaliser le calendrier ici.

Sélecteur de date de conception

  • Du style:Tous les paramètres sont préconfigurés en fonction du style.

  • Explicite: Le Paramètres de conception La propriété est disponible. Vous pouvez personnaliser le calendrier ici.

Sélecteur de date de positionnement

  • Dynamique:Le calendrier s'adapte et se positionne automatiquement.

  • Manuel: Le Paramètres de position La propriété est disponible. Vous pouvez personnaliser le calendrier ici.

Variables d'état

Les variables contrôlent dynamiquement le comportement de l'élément.

Invisible

variables (BOOL) pour basculer la visibilité de l'élément

TRUE: L'élément n'est pas visible à l'exécution.

Exemple: bIsVisible avec VAR bIsVisible : BOOL := FALSE; END_VAR

Désactiver les entrées

variables (BOOL) pour basculer l'opérabilité de l'élément

TRUE: Les entrées utilisateur n'ont plus aucun effet dans le runtime. L'élément est affiché comme désactivé.

Astuce

le Invisible La propriété est prise en charge par la fonctionnalité "Animation client".

Centre

Les propriétés contiennent des valeurs fixes pour les coordonnées du point de rotation. Le point de rotation est affiché dans l'éditeur sous la forme _visu_icon_center_point.png symbole et est utilisé comme centre de rotation et de mise à l'échelle.

Astuce

Vous pouvez également modifier les valeurs en faisant glisser le _visu_icon_center_point.png symbole vers une autre position dans l'éditeur.

X

Coordonnée X du point de rotation

Y

Coordonnée Y du point de rotation

Mouvement absolu

Les propriétés contiennent des variables CEI pour contrôler dynamiquement la position de l'élément. Le point de référence est le coin supérieur gauche de l'élément. Lors de l'exécution, l'élément entier est déplacé.

Mouvement

X

L'augmentation de cette valeur à l'exécution déplace l'élément vers la droite.

Y

L'augmentation de cette valeur à l'exécution déplace l'élément vers le bas.

Rotation

Variable (type de données numérique) pour l'angle de rotation (en degrés)

Exemple: PLC_PRG.iAngle1.

Le milieu de l'élément tourne à la Centre point. Ce point de rotation est représenté par le _visu_icon_center_point.png symbole.

Lors de l'exécution, l'alignement de l'élément reste le même par rapport au système de coordonnées de la visualisation. L'augmentation de la valeur fait pivoter l'élément vers la droite.

_visu_img_prp_rotation.png

Mise à l'échelle

Variable (type de données entier) pour déclencher un étirement centré

Exemple: PLC_PRG.iScaling

Le point de référence est le Centre propriété.

La valeur 1 rétrécit l'élément d'un facteur de 0.001. La valeur 1000 remet l'élément à sa taille d'origine.

Rotation intérieure

Variable (type de données numérique) pour l'angle de rotation (en degrés)

Exemple: PLC_PRG.iAngle2.

Lors de l'exécution, l'élément tourne autour du point de rotation spécifié dans Centre selon la valeur de la variable. De plus, l'alignement de l'élément pivote selon le système de coordonnées de la visualisation. L'augmentation de la valeur dans le code tourne dans le sens des aiguilles d'une montre.

Le point de rotation est représenté par le _visu_icon_center_point.png symbole.

Note

Si un angle de rotation statique est spécifié dans le Emplacement → Angle , l'angle de rotation statique est ajouté à l'angle de rotation variable (décalage) lors de l'exécution de la visualisation.

_visu_img_prp_inner_rotation.png

Astuce

Vous pouvez combiner les variables en un Conversion d'unités.

Astuce

le X, Oui, Rotation, et Rotation intérieure sont prises en charge par la fonctionnalité "Animation client".

Animation

Astuce

Ces propriétés ne sont disponibles que lorsque vous avez sélectionné l'option Prise en charge des animations client et de la superposition d'éléments natifs option dans le Gestionnaire de visualisation.

Durée de l'animation

Variable pour la durée (en millisecondes) pendant laquelle l'élément exécute une animation

  • Variable (valeur entière)

    Exemple: Menu.tContent avec VAR tContent : INT := 500; END_VAR

  • Littéral entier

    Exemple: 500

. Propriétés animables

  • Mouvement absolu, Mouvement, X, Oui

  • Mouvement absolu, Rotation

  • Mouvement absolu, Rotation intérieure

  • Mouvement absolu, Rotation extérieure

Le mouvement animé est exécuté lorsqu'au moins une valeur d'une propriété animable a changé. Le mouvement n'est alors pas saccadé, mais fluide pendant la durée d'animation spécifiée. L'élément de visualisation se déplace vers la position spécifiée tout en effectuant une rotation dynamique. Les transitions sont fluides.

Passer au premier plan

Variable (BOOL ) pour mettre l'élément au premier plan

TRUE: Au moment de l'exécution, l'élément de visualisation est affiché au premier plan.

FALSE: Au moment de l'exécution, l'élément de visualisation s'affiche dans la couche où il a été inséré dans l'éditeur de visualisation.

Exemple: bIsInForeground avec VAR bIsInForeground : BOOL := FALSE; END_VAR

Configuration d'entrée

Astuce

La Configurer bouton ouvre le Configuration des entrées dialogue. Vous pouvez y affecter des actions de suivi à l'événement.

OnValueChanged

Evénement qui déclenche des actions de suivi en raison d'un changement de valeur

Les actions de suivi déclenchées sont configurées dans le Configuration d'entrée dialogue.

Les actions de suivi définies et la configuration correspondante sont affichées sous la propriété de l'élément.

La OnValueChanged l'événement peut être désactivé par le VISU_NO_VALUECHANGED compilateur définir dans la boîte de dialogue des propriétés de l'application.

Autorisations

Note

Disponible uniquement lorsqu'une gestion des utilisateurs est configurée pour la visualisation.

Droits d'accès bouton

Ouvre le Droits d'accès dialogue. Vous pouvez y modifier les droits d'accès de l'élément.

. Messages d'état :

  • Non défini. Tous droits réservés.: Droits d'accès pour tous les groupes d'utilisateurs : opérable

  • Les droits sont définis : Droits limités: L'accès est restreint pour au moins un groupe.

Dans cette section​: