Befehl 'Visualisierungselement vervielfachen'

Symbol: _visu_icon_multiply_element

Funktion: Der Befehl öffnet den Dialog „Visualisierungselement vervielfachen“, der eine aus dem Vorlagenelement und der Arraydeklaration abgeleitete Konfiguration enthält. Sie können dort die Anordnung der Elemente, aber auch deren Anzahl und den Indexzugriff auf die Arrraydaten anpassen. Wenn Sie den Dialog beenden, wird aus dem Vorlagenelement ein Feld aus gleichartigen Elementen erstellt. In den Eigenschaften der neuen Elemente, in denen Sie in der Vorlage eine Arrayvariable mit Indexzugriff-Platzhalter konfiguriert haben, sind nun Arrayvariablen mit konkreten Arrayindizes konfiguriert.

Aufruf: Menü „Visualisierung“, Kontextmenü

Voraussetzung: Die Visualisierung ist aktiv und ein konfiguriertes Vorlagenelement ist selektiert.

Dialog 'Visualisierungselement vervielfachen'

Tab. 694: Registerkarte „Grundeinstellungen“
„Gesamtanzahl Elemente“	Die Gesamtanzahl wird bestimmt von der Indexbereich der Platzhalters unter Berücksichtigung der Einstellung unter Registerkarte „Erweiterte Einstellungen“. Die Elemente können eindimensional (als Spalte oder Zeile) oder zweidimensional (als Tabellenfeld) angeordnet werden.
„Horizontal“	Anzahl der Elemente pro Zeile Voreinstellung: Anzahl der Arraykomponenten (Indexbereich) des Platzhalters `‎$FIRSTDIM$‎` Beispiel für Array `‎axLampIsOn: ARRAY[0..4] OF BOOL;‎` = `‎5‎`
„Vertikal“	Anzahl der Zeilen, die benötigt wird, um die Gesamtanzahl der Elemente anzuordnen Voreinstellung Bei Verwendung des Indexzugriff-Platzhalters `‎$FIRSTDIM$‎`: Wenn der Indexbereich des Platzhalters kleiner als 5 ist, werden entsprechend viele Elemente horizontal angeordnet. Wenn der Indexbereich größer als 5 ist, werden die Elemente möglichst quadratisch angeordnet. Bei Verwendung der Platzhalter `‎$FIRSTDIM$‎` und `‎$SECONDDIM$‎`: Es werden horizontal so viele Elemente angeordnet, wie der Indexbereichen des Platzhalters `‎$FIRSTDIM$‎` und vertikal so viele wie der Indexbereichen des Platzhalters `‎$SECONDDIM$‎` vorgibt.
„Offset zwischen den Elementen“	Abstand der neuen Elemente voneinander; beeinflusst die Positionen der neuen Elemente „ 0 “: Die Rahmen der Elemente überlappen um ein Pixel „1 “: Die Elemente stoßen aneinander „<n> “: Zwischen den Elementen ist ein sichtbarer Abstand von n-1 Pixel
„Horizontal“	Abstand der Elemente innerhalb einer Zeile in Pixel Beispiel: `‎2‎` für einen Abstand von einem Pixel
„Vertikal“	Abstand der Elemente innerhalb der Spalten in Pixel Beispiel für einen Abstand von 3 Pixel: `‎4‎`
„Anordnung der Elemente“	Ursprung, von dem ausgehend die neuen Elemente positioniert und angeordnet werden Wenn „Vertikal“ oder „Horizontal“ <> 1 „Von oben links“ „Von oben rechts“ „Von unten links“ „Von unten rechts“ Wenn oder „Horizontal“ oder „Vertikal“ = 1 „Von oben“ „Von unten“
„Orientierung“	Bestimmt, wo die Elemente nacheinander im Feld angeordnet werden (zeilenweise oder spaltenweise) „Zeile für Zeile“ „Spalte für Spalte“

„Vorschau“	Visualisiert die eingestellte Anordnung und Orientierung der Elemente als Pfeil

Tab. 695: Registerkarte „Erweiterte Einstellungen“
„Array-Zugriff“	Ausgehend vom Vorlagenelement wird für jedes neue Element der konkrete Index für den Zugriff auf die Arrayvariable berechnet. Basis der Berechnung sind die Arrayindexgrenzen, die bei der Arraydeklaration angegeben sind. Außerdem werden die Einstellungen hier berücksichtigt.
„Erste Dimension“	Berechnungsvorschrift für den Index der ersten Dimension, der `‎$FIRSTDIM$‎` ersetzt Das erste neue Element erhält in der ersten Dimension den darunter in „Start-Index“ angegebenen Wert. Die weiteren Elemente erhalten jeweils einen um „Hochzählen“ inkrementierten Index, bis für alle Elemente ein Index berechnet ist. Beispiel (voreingestellter „Start-Index“: `‎1‎` „Hochzählen“: `‎1‎`
„Zweite Dimension“	Berechnungsvorschrift für den Index der zweiten Dimension, der `‎$SECONDDIM$‎` ersetzt Das erste neue Element erhält in der zweiten Dimension den darunter in „Start-Index“ angegebenen Wert. Die weiteren Elemente erhalten jeweils einen um „Hochzählen“ inkrementierten Index. Beispiel „Start-Index“: `‎1‎` „Hochzählen“: `‎1‎`

„OK“

Zunächst wird validiert, ob die berechneten Indizes im Indexbereich der Arrayvariablen liegen. Wenn das der Fall ist, werden die dem Vorlagenelement gleichenden Elemente erzeugt und als Feld (Zeile, Spalte oder Tabelle) angeordnet. Die Platzhalterindizes werden durch die berechneten Indizes ersetzt.

Beispiel

Deklaration der Arrayvariablen

	
VAR
asTexts_Example: ARRAY[1..2,1..2] OF STRING := 
	[ 
		'1A Text', '2A Text', 
		'1B Text', '2B Text' 
	];
	asToolTips_Example: ARRAY[1..2,1..2] OF STRING := 
 	[ 
		'1A Tooltip', '2A Tooltip',  
		'1B Tooltip', '2B Tooltip' 
	];
	
	axUserInput_Example: ARRAY[1..2,1..2] OF BOOL;
END_VAR

Visualisierung mit Vorlagenelement und dessen Eigenschaftenkonfiguration

Tab. 696: Dialog 'Visualisierungselement vervielfachen'
Registerkarte „Grundeinstellungen“
„Gesamtanzahl Elemente“
„Horizontal“	`‎2‎`
„Vertikal“	`‎2‎`

„Offset zwischen den Elementen“
„Horizontal“	`‎2‎`
„Vertikal“	`‎2‎`

„Anordnung der Elemente“	„Von oben links“
„Orientierung“	„Zeile für Zeile“

Registerkarte „Erweiterte Einstellungen“
„Array-Zugriff“
„Erste Dimension“
„Start-Index“	`‎1‎`
„Hochzählen“	`‎1‎`
„Zweite Dimension“
„Start-Index“	`‎1‎`
„Hochzählen“	`‎1‎`

Visualisierung zur Laufzeit:

Siehe auch

⮫ „Visualisierungselement als Vorlage konfigurieren und vervielfachen“