Skip to main content

Élément de visualisation : Tableau

Symbole:

_visu_img_table.png

Catégorie: Commandes communes

L'élément affiche des données qui peuvent être représentées sous forme de tableau dans une table. Par conséquent, le type de données de la variable de visualisation peut être 1) un tableau à une dimension, 2) un tableau à deux dimensions maximum, 3) un tableau d'un tableau, 4) un tableau de structures ou 5) un tableau d'un bloc fonctionnel.

Propriétés de l'élément

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

Toutes les propriétés ne sont disponibles qu'une fois que vous avez sélectionné Avancé option ou Toutes les catégories filtrer dans Propriétés.

Nom de l'élément

Exemple : Data set component 1

Astuce

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

Type d'élément

Tableau

Tableau de données

Tableau dont les données sont visualisées sous forme de tableau

Variable (ARRAY) dont le type de données détermine le nombre de colonnes et de lignes du tableau

. Types de tableaux

  • Tableau unidimensionnel : le tableau comporte une colonne.

  • Tableau bidimensionnel : la deuxième dimension détermine le nombre de colonnes.

  • Tableau d'un tableau : le nombre d'éléments du tableau arrière détermine le nombre de colonnes.

  • Tableau d'une structure : le nombre de membres de la structure détermine le nombre de colonnes.

  • Tableau d'un bloc fonctionnel : le nombre de variables locales détermine le nombre de colonnes.

Exemple : PLC_PRG.aiTable

Déclaration : aiTable : ARRAY[0..3, 0..4] OF INT := [4(1, 2, 3, 4, 5)];

Astuce

Si la déclaration du tableau change, le tableau peut être actualisé en plaçant le curseur dans le champ de valeur du tableau de données et en appuyant sur Entrez clé.

Indice de tableau maximal

Limite d'index supérieure pour le tableau affiché. Limite le nombre de lignes affichées. L'indice commence à ArrayStart.

  • Variable (type de données entier)

    Exemple : PLC_PRG.iUpperIndexBoundToDisplay

  • Nombre entier littéral

    Exemple : 4 est affiché sous la forme 5 dans la ligne du tableau.

Astuce

Le nombre d'entrées du tableau peut être défini dynamiquement à l'aide du Maximum array index propriété. Cela peut être nécessaire si le nombre d'entrées n'est déterminé qu'au moment de l'exécution.

L'indice commence à ArrayStart et va jusqu'à Indice de tableau maximal.

Colonnes

Le Tableau L'élément affiche les valeurs d'une variable dans une vue tabulaire. Les éléments du tableau des membres de la structure sont affichés dans une colonne ou une ligne. Les réseaux bidimensionnels ou les tableaux d'une structure sont affichés dans plusieurs colonnes. La variable visualisée est définie dans le Tableau de données propriété. Lorsqu'une variable y est affectée, vous pouvez spécifier l'affichage des colonnes du tableau dans lesquelles les éléments du tableau sont affichés. Une configuration individuelle est possible pour chaque colonne affectée à un index n.

Tableau 11. Colonnes : Colonne [<n>] Propriété de l'élément

En-tête de colonne

Par défaut, le nom du tableau ou de la structure est appliqué comme titre avec l'index ou le membre de structure de la colonne. Si un tableau d'un bloc fonctionnel a été sélectionné pour Tableau de données, puis le nom du tableau est appliqué à l'en-tête de colonne avec les variables locales du bloc fonctionnel appartenant à la colonne.

Le libellé de la colonne peut être modifié ici en spécifiant un nouveau titre.

Largeur

Largeur de colonne (en pixels)

Colonne d'images

standard icon: Les images peuvent être affichées dans la colonne. Les images sont utilisées à partir du pool d'images global ou des pools d'images personnalisés. Les ID d'image sont affichés dans les cellules du tableau tels qu'ils sont définis dans le pool d'images.

Configuration de l'image

Mode de remplissage

  • Fill cell:

    L'image est redimensionnée aux dimensions de la cellule sans modifier le rapport hauteur/largeur.

  • Centered:

    L'image est centrée dans la cellule et conserve ses proportions (rapport hauteur/largeur).

Transparence

standard icon: La couleur qui est spécifiée dans Couleur transparente est affiché en tant que transparent.

Couleur transparente

Cette couleur est affichée comme transparente.

Exigence : La Transparence la propriété est activée.

Alignement du texte de l'en-tête

. Alignement de l'en-tête de colonne :

  • Left

  • Centered

  • Right

Utiliser un modèle

_cds_icon_option_deactivated.png: Les données du tableau sont affichées dans le tableau.

_cds_icon_option_activated.png: Les cellules du tableau obtiennent des propriétés supplémentaires (configurables par colonne), à savoir toutes celles qui ont un rectangle. Cela donne à une cellule de tableau la même gamme de fonctions qu'une rectangle. Les propriétés supplémentaires sont affichées sous Modèle propriété.

Cas d'utilisation : pour traiter les entrées de l'utilisateur (par exemple, cliquer dans une cellule), cette cellule doit avoir une configuration de saisie. Cela est possible lorsque Utiliser un modèle l'option est activée. Configuration des entrées La propriété est alors disponible et une action de suivi peut être configurée pour un événement impliquant la souris.

Exemple : lorsqu'un utilisateur clique sur la cellule configurée de cette manière dans la visualisation en cours, la variable booléenne attribuée à la cellule est basculée.

Alignement du texte du titre à partir du modèle

_cds_icon_option_activated.png: L'étiquette de colonne est créée avec les propriétés de texte du modèle.

Modèle

Quand le Utiliser un modèle est activée, cette propriété est visible et toutes les propriétés d'un rectangle sont disponibles en dessous.

Astuce

Ces propriétés et leurs options configurables sont décrites dans l'aide du Rectangle, Rectangle Arrondi, Ellipse élément.



Afficher l'en-tête de ligne

standard icon: L'en-tête de ligne est visible.

Exemple : pour un tableau, l'index de l'élément du tableau est affiché dans l'en-tête.

Afficher l'en-tête de colonne

standard icon: Le libellé de la colonne est visible.

Hauteur de ligne

Hauteur des lignes (en pixels)

Largeur de l'en-tête de ligne

Largeur de l'étiquette de ligne

Taille de la barre de défilement

Taille de la barre de défilement (en pixels)

Position

La position définit l'emplacement et la taille de l'élément dans la fenêtre de visualisation. Ceci est basé sur le système de coordonnées cartésiennes. L'origine est située dans le coin supérieur gauche de la fenêtre. L’axe X horizontal positif s’étend vers la droite. L’axe Y vertical positif va 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 également modifier les valeurs en faisant glisser la case _visu_icon_position_element.png symboles vers d’autres positions dans l’éditeur.

Propriétés du texte

Les propriétés obtiennent des valeurs fixes pour les propriétés du texte et agissent sur les textes configurés dans Textes → Texte ou Textes → Info-bulle.

Alignement horizontal

Alignement horizontal du texte dans l'élément

Alignement vertical

Alignement vertical du texte dans l'élément

Format texte

. Définition pour afficher les textes trop longs

  • Défaut: Le texte trop long est tronqué.

  • Saut de ligne: Le texte est divisé en lignes.

  • Ellipse: Le texte visible se termine par "..." indiquant qu'il n'est pas complet.

Police de caractère

Exemple: Défaut

_cds_icon_three_dots.png: Le Police de caractère la boîte de dialogue s'ouvre.

_cds_icon_arrow_down.png: Zone de liste avec les polices de style

Couleur de la police

Exemple: Noir

_cds_icon_three_dots.png: Le Couleur la boîte de dialogue s'ouvre.

_cds_icon_arrow_down.png: Zone de liste avec les couleurs de style

Transparence

Entier (valeur comprise entre 0 à 255)

La valeur de transparence détermine la transparence de la couleur correspondante.

255: La couleur est opaque.

0: La couleur est complètement transparente.

Note

Si la couleur est une couleur de style et possède déjà une valeur de transparence, cette propriété est protégée contre l'écriture.

Textes dynamiques

Les textes dynamiques sont des textes indexés de manière variable d'une liste de textes. Lors de l'exécution, le texte actuellement indexé dans la variable s'affiche.

Liste de texte

. Nom de la liste de textes

  • En tant que variable (STRING)

  • Sous forme de littéral de chaîne fixe avec des guillemets droits simples

    Exemple: 'Errorlist'

_cds_icon_arrow_down.png: Zone de liste avec les dialogues disponibles dans les listes de textes

Remarque : Si une liste de textes du projet est transférée vers une visualisation dans une bibliothèque, un point doit être ajouté au nom de la liste de textes.

Index du texte

. ID de la liste de textes qui fait référence au texte de sortie souhaité

  • Sous forme de chaîne fixe avec l'ID entre guillemets droits simples

    Exemple: '1'

  • En tant que variable (STRING) pour contrôler dynamiquement la sortie de texte

    Exemple: strTextID

    Exemple de mission : PLC_PRG.strTextID := '1';

Index des info-bulles

. ID de la liste de textes qui fait référence au texte de sortie souhaité

  • Sous forme de chaîne fixe avec l'ID entre guillemets droits simples

    Exemple: '2'

  • En tant que variable (STRING) pour contrôler dynamiquement la sortie de texte

    Exemple: strToolTipID

    Exemple de mission : PLC_PRG.strToolTipID := '2';

Variables de police

Les variables permettent un contrôle dynamique de l'affichage du texte.

Nom de la police

variables (STRING) pour la police du texte

Exemple: PLC_PRG.stFontVar := 'Arial';

La sélection des polices correspond à la valeur par défaut Police de caractère dialogue.

Taille

Variable (type de données entier) pour la taille de la police (en pixels)

Exemple: PLC_PRG.iFontHeight := 16;

La sélection des tailles de police correspond à la valeur par défaut Police de caractère dialogue.

Drapeaux

variables (DWORD) pour les drapeaux d'affichage des polices

. Drapeaux :

  • 1: Italique

  • 2: Audacieux

  • 4: souligné

  • 8: Barré

Note

Vous pouvez combiner les affichages de police en ajoutant le codage des drapeaux. Par exemple, un texte en gras et souligné : PLC_PRG.dwFontType := 6;

Jeu de caractères

variables (DWORD) pour un numéro de jeu de caractères

La sélection des numéros de jeu de caractères correspond à la Scénario établissement de la norme Police de caractère dialogue.

Couleur

variables (DWORD) pour la couleur du texte

Exemple: PLC_PRG.dwColorFont:= 16#FF000000;

Drapeaux pour l'alignement du texte

Variable (type de données entier) pour coder l'alignement du texte

Exemple: PLC_PRG.dwTextAlignment.

. Codage:

  • 0: En haut à gauche

  • 1: Centre horizontal

  • 2: Droit

  • 4: Centre vertical

  • 8: Bas

Note

Vous pouvez combiner les alignements de texte en ajoutant le codage des drapeaux. Par exemple, un texte centré verticalement et horizontalement : PLC_PRG.dwFontType := 5;

Astuce

Les valeurs fixes pour l'affichage des textes sont définies dans Propriétés du texte.

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".

Sélection

Couleur de sélection

Couleur de remplissage de la ligne sélectionnée

Couleur de la police de sélection

Couleur de la police de la ligne sélectionnée

Type de sélection de cadre

. Sélection lors du clic sur la ligne du tableau.

  • No selection: Pas de choix

  • Cell selection: La cellule cliquée uniquement.

  • Row selection: Ligne de la cellule cliquée.

  • Column selection: Colonne de la cellule cliquée.

  • Row and column selection: Ligne et colonne de la cellule cliquée.

Cadre autour des cellules sélectionnées

standard icon: Un cadre est dessiné autour des cellules sélectionnées.

Variable pour la colonne sélectionnée

variables (INT) pour l'indice de tableau du colonne de la cellule sélectionnée

Si le tableau de données pointe vers une structure, les membres de la structure sont indexés à partir de 0.

Avertissement

Cet index représente la position correcte dans le tableau uniquement si aucune colonne n'a été supprimée de la table dans l'affichage.

Variable pour la ligne sélectionnée

variables (INT) pour l'indice de tableau du ligne de la cellule sélectionnée

Variable pour une sélection de colonne valide

variables (BOOL)

TRUE: Le Variable pour la colonne sélectionnée variable contient une valeur valide.

Variable pour une sélection de ligne valide

variables (BOOL).

TRUE: Le Variable pour la ligne sélectionnée variable contient une valeur valide.

Centre

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

Astuce

Vous pouvez également modifier les valeurs en faisant glisser le _visu_icon_center_point.png symbole à 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 peuvent être affectées à 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

  • Variable (type de données numérique) pour la position X (en pixels)

    Exemple: PLC_PRG.iPos_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

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 à un conversion d'unité.

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é le Prise en charge des animations client et de la superposition d'éléments natifs possibilité dans le Gestionnaire de visualisation.

Durée des animations

Variable de 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 alors exécuté n'est pas saccadé, mais est fluide dans la durée d'animation spécifiée. L'élément de visualisation se déplace vers la position spécifiée tout en tournant dynamiquement. Les transitions sont fluides.

Passer au premier plan

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

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

FALSE: A l'exécution, l'élément de visualisation est affiché dans le calque où il a été inséré dans l'éditeur de visualisation.

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

Des droits d'accès

Note

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

Des droits d'accès bouton

Ouvre le Des droits d'accès dialogue. Là, vous pouvez modifier les privilèges d'accès pour l'élément.

. Messages d'état :

  • Pas encore défini. Pleins droits.: Droits d'accès pour tous les groupes d'utilisateurs : opérable

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

Dans cette section​: