Visualisierungselement 'Tabelle'

 

Symbol:

_visu_img_table.png

Kennzeichen: Allgemeine Steuerelemente

Das Element visualisiert Daten, die als Array darstellbar sind, in einer Tabelle. Als Datentyp der visualisierenden Variable kommt daher ein ein- oder maximal zweidimensionales Array, ein Array von einem Array, ein Array von Strukturen oder auch ein Array von einem Funktions­baustein in Frage.

Elementeigenschaften

Elementname

Beispiel: Data set component 1

Optional

Tipp: Durch die Vergabe von eigenen Elementnamen werden die Elemente in der Elementliste schnell gefunden.

Elementtyp

Tabelle

Datenarray

Array, dessen Daten als Tabelle visualisiert werden

Variable (ARRAY), dessen Datentyp die Anzahl der Spalten und Zeilen der Tabelle bestimmt

Arraytypen

  • Eindimensionales Array: Die Tabelle hat eine Spalte

  • Zweidimensionales Array: Die zweite Dimension bestimmt die Anzahl der Spalten bestimmt

  • Array von einem Array: Die Anzahl der Arrayelemente des hinteren Arrays bestimmt die Anzahl der Spalten

  • Array einer Struktur: Die Anzahl der Struk­turkomponente bestimmt die Anzahl der Spalten

  • Array eines Funktionsbausteins: Die Anzahl der lokalen Variablen bestimmt die Anzahl der Spalten

Beispiel: PLC_PRG.aiTable

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

Tipp: Wenn sich die Deklaration des Arrays geändert hat, kann die Tabelle durch Setzen des Cursors in das Datenarray-Wertefeld und Drücken der Eingabe aktualisiert werden.

Max. Array-Index

Obere Indexgrenze für die angezeigte Tabelle. Begrenzt die Anzahl der angezeigten Reihen. Der Index beginnt bei 0.

  • Variable (Ganzzahliger Datentyp)

    Beispiel : PLC_PRG.iUpperIndexBoundToDisplay

  • Ganzzahliges Literal

    Beispiel: 4 bewirkt 5 in der Tabelle ange­zeigte Reihen

Siehe auch

Elementeigenschaft 'Spalten'

Das Tabellenelement stellt die Werte einer Variable in Tabellenansicht dar. Der Index von Arrayelementen oder von Komponenten einer Struktur wird in einer Spalte oder einer Zeile angezeigt. Zweidimensio­nale Arrays oder Arrays einer Struktur werden in mehreren Spalten angezeigt. Die visualisierte Variable wird in der Eigenschaft Datenarray festgelegt. Wenn dort eine Variable zugewiesen ist, kann die Darstellung der Tabellenspalten, in denen die jeweiligen Arrayelemente dargestellt werden, festgelegt werden. Für jede Spalte, die einem Index [<n>] zugeordnet ist, ist eine individuelle Konfiguration möglich.

Zeilenkopf anzeigen

_cds_icon_option_activated.png: Die Zeilenüberschrift ist sichtbar.

Spaltenkopf anzeigen

_cds_icon_option_activated.png: Die Beschriftung der Spalte ist sichtbar.

Zeilenhöhe

Höhe der Zeilen in Pixel.

Breite Zeilenkopf

Breite der Zeilenbeschriftung.

Größe des Scrollbars

Größe des Scrollbalkens in Pixel.

Elementeigenschaft 'Spalten: Spalte [<n>]'

Spaltenüberschrift

Standardmäßig wird der Name des Arrays/der Struktur mit dem zur Spalte gehörenden Index/Strukturkomponente als Überschrift genommen. Die Spaltenbeschriftung kann hier geändert werden, indem ein neuer Titel eingetragen wird.

Breite

Spaltenbreite in Pixel

Bildspalte

_cds_icon_option_activated.png: In der Spalte können Bilder angezeigt werden. Es werden Bilder der globalen Bildersammlung oder von benutzerdefinierten Bildersammlungen verwendet. Dabei stehen in den Zellen der Tabelle die Bild-IDs, wie in der Bildersammlung definiert.

Bildkonfiguration

Füllmodus

  • Zelle ausfüllen: Das Bild passt sich an die Größe der Zelle ohne Berücksichtigung des Höhen-Breiten-Verhältnisses an.

  • Zentriert: Das Bild wird in der Zelle zentriert und behält seine Proportionen; d.h. das Verhältnis Höhe-Breite bleibt erhalten.

Transparenz

_cds_icon_option_activated.png Die Farbe, die in Transparenzfarbe angegeben ist, wird transparent dargestellt.

Transparenzfarbe

Diese Farbe wird transparent dargestellt.

Voraussetzung: Die Eigenschaft Transparenz ist aktiviert ist.

Textausrichtung der Überschrift

Ausrichtung des Spaltenkopfs:

  • Links

  • Zentriert

  • Rechts

Vorlage verwenden

_cds_icon_option_activated.png In jede Zelle dieser Tabellenspalte wird ein weiteres Visualisierungselement (vom Typ Rechteck, Abgerundetes Rechteck oder Ellipse) eingefügt. Die Eigenschaftenliste wird automatisch um die Eigenschaften dieses Elements unter Vorlage erweitert.

Textausrichtung der Überschrift aus der Vorlage

Voraussetzung: Die Eigenschaft Vorlage verwenden ist aktiviert.

_cds_icon_option_activated.pngBei Aktivierung werden die in der eingefügten Vorlage getroffenen Einstellungen für Schrift(-Größe) und Ausrichtung auch auf die Spaltenüberschrift angewendet.

Vorlage

Voraussetzung: Die Eigenschaft Vorlage verwenden ist aktiviert.

Unter Vorlage werden die Eigenschaften aller Elemente, die der Spalte zugewiesen wurden, aufgelistet. Sie können dort, wie in unter "Rechteck, abgerundetes Rechteck und Ellipse" beschrieben, editiert werden.

Siehe auch

Elementeigenschaft 'Position'

Die Position definiert die Lage und Größe des Elements im Fenster der Visualisierung. Sie bezieht sich auf ein kartesisches Koordinaten­system. Der Ursprung liegt in der oberen linken Fensterecke. Die posi­tive horizontale X-Achse verläuft nach rechts. Die positive vertikale Y-Achse verläuft nach unten.

X

X-Koordinate der linken oberen Ecke des Elements

Angabe in Pixel

Beispiel: 10

Y

Y-Koordinate der linken oberen Ecke des Elements

Angabe in Pixel

Beispiel: 10

Breite

Angabe in Pixel

Beispiel: 150

Höhe

Angabe in Pixel

Beispiel: 30

Info

Die Werte können auch geändert werden, indem Sie im Editor die Symbole _visu_icon_position_element.png an eine andere Stelle ziehen.

Siehe auch

Elementeigenschaft 'Zentrum'

Die Eigenschaften enthalten feste Werte für die Koordinaten des Rota­tionspunkts. Er ist im Editor als Symbol _visu_icon_center_point.png dargestellt. Der Punkt dient als Zentrum für die Rotation und die Skalierung.

X

X-Koordinate des Rotationspunkts

Y

Y-Koordinate des Rotationspunkts

Info

Die Werte können auch geändert werden, indem Sie im Editor das Symbol _visu_icon_center_point.png an eine andere Stelle ziehen.

Elementeigenschaft 'Texteigenschaften'

Die Eigenschaften enthalten feste Werte für die Texteigenschaften.

Horizontale Ausrichtung

Horizontale Ausrichtung des Texts innerhalb des Elements.

Vertikale Ausrichtung

Vertikale Ausrichtung des Texts innerhalb des Elements.

Schriftart

Beispiel: Standard

_cds_icon_three_dots.png: Dialog Schriftart öffnet sich.

_cds_icon_arrow_down.png: Auswahlliste mit Stilschriftarten

Farbe Schriftart

Beispiel: Schwarz

_cds_icon_three_dots.png: Dialog Farbe öffnet sich.

_cds_icon_arrow_down.png: Auswahlliste mit Stilfarben

Transparenz

Ganze Zahl (Wertebereich von 255 bis 0). Sie bestimmt die Durchsichtigkeit der zugehörigen Farbe.

255: Die Farbe ist deckend.

0: Die Farbe ist voll transparent.

Hinweis: Wenn die Farbe eine Stilfarbe ist und bereits einen Transparenzwert enthält, ist diese Eigenschaft schreibgeschützt.

Elementeigenschaft 'Dynamische Texte'

Dynamische Texte sind variabel indizierte Texte einer Textliste. Zur Laufzeit wird der Text ausgegeben, der aktuell in der Variablen indiziert ist.

Textliste

Variable (String) oder Name der Textliste als fester String in einfachen Anführungszeichen.

Beispiel: 'Errorlist'

_cds_icon_arrow_down.png: Auswahlliste mit den im Projekt verfügbaren Textlisten.

Textindex

Textlisten-ID. Sie verweist auf den gewünschten Ausgabetext.

  • Als fester String mit der ID in einfachen Anführungszeichen.

    Beispiel: '1'

  • Als Variable (STRING) um die Textausgabe dynamisch zu steuern.

    Beispiel: strTextID

    Beispiel Zuweisung: PLC_PRG.strTextID := '1';

Tooltipindex

Textlisten-ID. Sie verweist auf den gewünschten Ausgabetext.

  • Als fester String mit der ID in einfachen Anführungszeichen.

    Beispiel: '2'

  • Als Variable (STRING) um die Textausgabe dynamisch zu steuern.

    Beispiel: strToolTipID

    Beispiel Zuweisung: PLC_PRG.strToolTipID := '2';

Siehe auch

Elementeigenschaft 'Schriftartvariablen'

Die Variablen ermöglichen, die Darstellung der Texte dynamisch zu steuern.

Schriftname

Variable (STRING). Enthält die Schriftart des Textes.

Beispiel: PLC_PRG.stFontVar := 'Arial';

Die Auswahl an Schriftarten entspricht der im Standarddialog Schriftart.

Größe

Variable (ganzzahliger Datentyp). Enthält den Schriftgrad in Pixel.

Beispiel: PLC_PRG.iFontHeight := 16;

Die Auswahl an Schriftgraden entspricht der im Standarddialog Schriftart.

Flags

Variable (DWORD). Enthält die Flags für die Schriftartdarstellung.

Flags:

  • 1: Kursiv

  • 2: Fett

  • 4: Unterstrichen

  • 8: Durchgestrichen

Hinweis: Sie können die Schriftartdarstellungen kombinieren, indem Sie die Codierung der Flags addieren. Zum Beispiel ein fetter und unterstrichener Text: PLC_PRG.dwFontType := 6;

Zeichensatz

Variable (DWORD). Enthält eine Zeichensatznummer für die Schriftart.

Die Auswahl an Zeichensatznummern entspricht der Einstellung Skript des Standarddialogs Schriftart.

Farbe

Variable (DWORD). Enthält die Farbe des Texts.

Beispiel: PLC_PRG.dwColorFont:= 16#FF000000;

Flags für Textausrichtung

Variable (Ganzzahliger Datentyp). Enthält die Codierung zur Textausrichtung.

Beispiel: PLC_PRG.dwTextAlignment.

Codierung:

  • 0: Oben links

  • 1: Horizontal zentriert

  • 2: Rechts

  • 4: Vertikal zentriert

  • 8: Unten

Hinweis: Sie können die Textausrichtungen kombinieren, indem Sie die Codierung der Flags addieren. Zum Beispiel ein vertikal und horizontal zentrierter Tex: PLC_PRG.dwFontType := 5;

Info

Feste Werte für die Darstellung der Texte sind in Texteigen­schaften gesetzt.

Siehe auch

Elementeigenschaft 'Absolute Bewegung'

Die Eigenschaften enthalten IEC-Variablen, um die Position des Elements dynamisch zu steuern. Bezugspunkt ist die linke obere Ecke des Elements. Zur Laufzeit wird das Element als Ganzes bewegt.

Bewegung

X

Variable (numerischer Datentyp). Sie enthält die X-Position in Pixel.

Beispiel PLC_PRG.iPos_X.

Ein Erhöhen des Werts zur Laufzeit führt zu einer Bewegung nach rechts.

Y

Variable (numerischer Datentyp). Sie enthält die Y-Position in Pixel.

Beispiel PLC_PRG.iPos_Y.

Ein Erhöhen des Werts zur Laufzeit führt zu einer Bewegung nach unten.

Rotation

Variable (numerischer Datentyp). Enthält den Drehwinkel in Grad.

Beispiel PLC_PRG.iAngle1.

Der Mittelpunkt des Elements rotiert um den Punkt in Zentrum. Dieser Rotationspunkt wird im Editor als Symbol _visu_icon_center_point.png dargestellt.

Zur Laufzeit bleibt die Ausrichtung des Elements in Bezug zum Koordinatensystem der Visualisierung erhalten. Ein Erhöhen des Werts führt zu einer Rechtsdrehung.

_visu_img_prp_rotation.png 

Innere Rotation

Variable (numerischer Datentyp). Enthält den Drehwinkel in Grad.

Beispiel: PLC_PRG.iAngle2.

Zur Laufzeit rotiert das Elements entsprechend dem Variablenwert um den Rotationspunkt in Zentrum. Zudem dreht die Ausrichtung des Elements bezüglich des Koordinatensystems der Visualisierung. Ein Erhöhen des Werts im Code bewirkt eine Rechtsdrehung.

Der Rotationspunkt wird im Editor als Symbol _visu_icon_center_point.png dargestellt.

Hinweis: Wenn in der Eigenschaft Position ‣ Winkel ein statischer Drehwinkel angegeben ist, wird bei der Visualisierungsausführung zum variablen Drehwinkel der statische Drehwinkel addiert (Offset).

_visu_img_prp_inner_rotation.png 

Info

Sie können die Variablen mit einer Einheitenumrechnung verbinden.

Info

Die Eigenschaften X, Y, Rotation und Innere Rotation werden von der Funktionalität "Client-Animation" unterstützt.

Siehe auch

Elementeigenschaft 'Zustandsvariablen'

Die Variablen steuern dynamisch das Verhalten des Elements.

Unsichtbarkeit

Variable (BOOL). Schaltet die Sichtbarkeit des Elements um.

TRUE: Das Element ist zur Laufzeit nicht sichtbar.

Eingaben deaktivieren

Variable (BOOL). Schaltet die Bedienbarkeit des Elements um.

TRUE: Benutzereingaben zur Laufzeit haben keine Auswirkung. Das Element wird deaktiviert angezeigt.

Info

Die Eigenschaft Unsichtbarkeit wird von der Funktionalität "Client-Animation" unterstützt.

Siehe auch

Elementeigenschaft 'Selektion'

Selektionsfarbe

Füllfarbe der selektierten Zeile.

Selektionsschriftfarbe

Schriftfarbe der selektierten Zeile.

Auswahlart

Auswahl beim Klick auf die Tabellenzelle

  • Keine Auswahl: Keine Auswahl

  • Zellenauswahl: nur die angeklickte Zelle.

  • Zeilenauswahl: Zeile der angeklickten Zelle.

  • Spaltenauswahl: Spalte der angeklickten Zelle.

  • Zeilen- und Spaltenauswahl: Zeile und Spalte der angeklickten Zelle

Rahmen um selektierte Zellen

_cds_icon_option_activated.png: Es wird ein Rahmen um die selektierten Zellen gezeichnet.

Variable für Spaltenauswahl

Variable (INT). Enthält den Arrayindex der Spalte der selektierten Zelle. Im Fall, dass das Daten-Array auf eine Struktur zeigt, werden die Strukturkomponenten beginnend mit 0 indiziert.

Achtung: Dieser Index repräsentiert nur dann die korrekte Position im Array, wenn keine Spalten von der Anzeige in der Tabelle ausgenommen wurden.

Variable für Zeilenauswahl

Variable (INT). Enthält den Arrayindex der Zeile der selektierten Zelle.

Variable für Gültigkeit der Spaltenauswahl

Variable (BOOL).

TRUE: Die Variable in Variable für Spaltenauswahl enthält einen gültigen Wert.

Variable für Gültigkeit der Zeilenauswahl

Variable (BOOL).

TRUE: Die Variable in Variable für Zeilenauswahl enthält einen gültigen Wert.

Diese Eigenschaften sind nur verfügbar, wenn Sie im Visualisierungs­manager die Option Client-Animationen und Überlagerungen syste­meigener Elemente unterstützen aktiviert haben.

Sie können eine Bewegung, eine Drehung und die Sichtbarkeit eines Visualisierungselements animieren.

Animationsdauer

Zeit in Millisekunden, in der das Element eine Animation ausführt

Beispiel: 500

In den Vordergrund bringen

Eigenschaftenwert (BOOL)

TRUE: Das Element wird zur Laufzeit im Vordergrund dargestellt.

FALSE: Das Element wird zur Laufzeit in der Ebene dargestellt, in der es im Visualisierungseditor eingefügt wurde.

Siehe auch

Elementeigenschaft 'Zugriffsrechte'

Voraussetzung: Eine Benutzerverwaltung für die Visualisierung ist eingerichtet.

Zugriffsrechte

Öffnet den Dialog Zugriffsrechte. Dort können Sie die Zugriffsrechte für das Element ändern.

Statusmeldungen:

  • Nicht gesetzt. Alle Rechte: Zugriffsrecht für alle Benutzergruppen: bedienbar

  • Rechte sind vergeben: eingeschränkte Rechte: Mindestens für eine Gruppe ist der Zugriff eingeschränkt

Siehe auch

Siehe auch

3.5.14.0

© Copyright 2019, CODESYS GmbH