Skip to main content

Élément de visualisation : Éditeur de texte

Symbole:

_visu_img_text_editor.png

Catégorie: Contrôles spéciaux

Cet élément affiche le contenu des fichiers texte enregistrés sur le contrôleur. Les fichiers peuvent être encodés aux formats ASCII ou Unicode. Un utilisateur de visualisation peut également modifier le texte.

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: GenElemInst_1

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

Éditeur de texte

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.

Police de caractère

Nom de la police

Police non proportionnelle utilisée par la visualisation pour afficher le contenu du fichier

Exemple: Courrier Nouveau

Taille

Taille de police

Exemple: 12

Variables de contrôle

Fichier

Variable

variables (STRING) pour les noms de fichiers et éventuellement l'emplacement du fichier

Il se trouve dans le système de fichiers du contrôleur.

Exemple: PLC_PRG.strFile: STRING := '/Documentation/Info.txt';

Ouvert

Variable BOOL) pour ouvrir le fichier spécifié dans le Variable propriété

Exemple: bOpen: BOOL;

TRUE: Le fichier est ouvert.

Si un autre fichier est encore ouvert, il est fermé en définissant la variable close (TRUE). Le système nettoiera automatiquement. Cependant, toutes les modifications non enregistrées seront perdues.

Dans un cycle, l'appel ouvert est traité en premier, puis l'appel fermé. Lorsque les variables de contrôle de déclenchement sont définies simultanément, le fichier est d'abord ouvert puis immédiatement fermé.

Aussi tôt que le Ouvrir ou Nouveau est activé, cette action est exécutée lors du prochain cycle de visualisation et le nom de fichier existant est évalué. Les deux indicateurs sont évalués dans le même cycle et peuvent donc être activés simultanément.

Fermer

variables (BOOL) pour fermer le fichier spécifié dans le Variable propriété

Exemple: bClose: BOOL;

TRUE: Le dossier est fermé.

Remarque : Dans un cycle, l'appel ouvert est traité en premier, puis l'appel fermé. Lorsque les variables de contrôle de déclenchement sont définies simultanément, le fichier est d'abord ouvert puis immédiatement fermé.

Sauvegarder

variables (BOOL) pour enregistrer le fichier spécifié dans le Variable propriété

Exemple: bStore: BOOL;

TRUE: Le fichier est enregistré.

Nouvelle

variables (BOOL) pour créer un nouveau fichier avec le nom spécifié dans le Variable biens

Exemple: bCreate: BOOL;

TRUE: Un fichier est créé et ouvert.

Aussi tôt que le Ouvrir ou Nouveau est activé, ces actions sont exécutées lors du cycle de visualisation suivant et le nom de fichier existant est évalué. Les deux indicateurs sont évalués dans le même cycle et peuvent donc être activés simultanément.

Éditer

Variable

variables (STRING) pour la chaîne à rechercher dans le fichier

Exemple: strFind: STRING := 'abc';

Trouver

variables (BOOL) pour effectuer la recherche de la chaîne dans le Variable propriété

Exemple: bFind: BOOL;

TRUE: La recherche est effectuée. La variable est automatiquement réinitialisée à FALSE.

Rechercher suivant

variables (BOOL) pour lancer la recherche dans le fichier

Exemple: bFindNext: BOOL;

TRUE: La recherche commence au dernier emplacement de résultat de recherche.

FALSE: La recherche commence au début du fichier.

Position du caret

Ligne

Variable (type de données entier) pour la ligne caret

Exemple: iRowCursor: INT;

Colonne

Variable (type de données entier) pour la colonne caret

Exemple: iColumnCursor: INT;

Position

Variable de sortie (type de données entier) pour la sortie du absolu position du caret dans le texte

Exemple: iPosCursor: INT;

Définir le curseur

Variable BOOL) pour placer le curseur à un emplacement spécifique

Exemple: iSetCursor: INT;

TRUE: Le curseur est déplacé. Le nouveau poste est défini dans le Ligne et Colonne Propriétés.

FALSE: Le Ligne, Colonne, et Position les propriétés contiennent les valeurs réelles.

Remarque : La variable est utilisée comme variable de contrôle pour un événement d'entrée déclenché par un utilisateur de visualisation.

Sélection

La position de départ

Variable de sortie (type de données entier) pour la sortie du absolu position où commence la sélection de texte

Exemple: iPosSelection: INT;

Fin de course

Variable de sortie (type de données entier) pour la sortie du absolu position où la sélection de texte se termine

Exemple: iPosEndSelection: INT;

Numéro de ligne de départ

Variable de sortie (type de données entier) pour la sortie de la ligne où commence la sélection de texte

Exemple: iRowSelection: INT;

Index de la colonne de début

Variable de sortie (type de données entier) pour la sortie de la colonne où commence la sélection de texte

Exemple: iColumnSelection: INT;

Numéro de ligne de fin

Variable de sortie (type de données entier) pour la sortie de la ligne où la sélection de texte se termine

Exemple: iRowEndSelection: INT;

Indice de fin de colonne

Variable de sortie (type de données entier) pour la sortie de la colonne où la sélection de texte se termine

Exemple: iColumnEndSelection: INT;

Ligne à sélectionner

Variable (type de données entier) pour le numéro de ligne sélectionné

Remarque : La sélection est contrôlée par les variables du Sélection du déclencheur propriété.

Définir la sélection

variables (BOOL) pour contrôler la sélection d'une ligne

Exemple: bSetSelection: BOOL;

TRUE: La ligne de la Ligne à sélectionner propriété est sélectionnée et mise en surbrillance dans l'éditeur de texte.

Si la ligne ne se trouve pas dans le segment de texte actuel de l'éditeur de texte, le segment de texte est déplacé vers cette ligne.

Note

La variable est utilisée comme variable de contrôle pour un événement d'entrée déclenché par un utilisateur de visualisation. La variable de contrôle n'est pas réinitialisée automatiquement. Vous êtes responsable de ce que cela se produise dans la visualisation.

La gestion des erreurs

Variable pour le code d'erreur

Variable (type de données entier) pour le numéro d'erreur en cas d'erreur

Exemple: iError: INT;

Les codes d'erreur sont déclarés dans GVL_ErrorCodes dans le VisuElemTextEditor bibliothèque. Pour afficher le texte d'erreur, le VisuFctTextEditorGetErrorText() fonction de la bibliothèque doit être appelée.

Variable pour le contenu modifiée

variables (BOOL) pour la sortie de l'information si le contenu a changé

Exemple: bIsContentEdited: BOOL;

TRUE: Le contenu de l'éditeur de texte a changé.

Variable pour le mode d'accès

variables (BOOL) pour contrôler l'autorisation d'accès au fichier

Exemple: bIsReadOnly: BOOL;

TRUE: Un utilisateur de visualisation dispose d'une autorisation en lecture seule. Lors de l'exécution, le contenu du fichier est surligné en gris dans l'éditeur de texte.

FALSE: Un utilisateur de visualisation dispose d'une autorisation de lecture/écriture.

Note

La variable écrase le paramètre dans le Mode éditeur biens.

Longueur de ligne maximale

Longueur de ligne maximale

Nombre maximum de caractères par ligne

Mode éditeur

  • Lecture seulement: Un utilisateur de visualisation dispose d'autorisations en lecture seule sur le fichier. Lors de l'exécution, le contenu du fichier est surligné en gris dans l'éditeur de texte.

  • Lire écrire: Un utilisateur de visualisation dispose d'autorisations de lecture-écriture.

Nouveaux fichiers

Encodage de caractère

. Encodage des caractères du nouveau fichier :
  • ASCII

  • Unicode (Little Endian)

  • Unicode (gros boutiste)

Nouvelle séquence de caractères de ligne

. Caractère de fin de ligne du nouveau fichier :
  • CR/LF: Habituel pour les systèmes Windows

  • LF: Habituel pour les systèmes UNIX

Note

Lorsque l'utilisateur de la visualisation ouvre un fichier existant, le caractère de fin de ligne du fichier est détecté et utilisé automatiquement.

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

Variables d'état

Les variables contrôlent le comportement des éléments de manière dynamique.

Invisible

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

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

Astuce

Le Invisible la propriété est prise 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

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.