History

Das History-Control TcHmiVnHistory steuert die History-Funktionalität von einem ImageWatch Control über eine Toolbar und bringt eine grafische Auflistung (Image List) der History-Bilder mit. Die Beschreibung der einzelnen Konfigurationsmöglichkeiten finden Sie unter den folgenden Kategorien auf dieser Seite. Zu den jeweiligen Kategorien gibt es Unterkapitel mit weiteren Informationen. Dieses Control kann nur in Verbindung mit einem ImageWatch-Control verwendet werden und stellt lediglich die Anzeige und Bedienung der History-Funktionalität bereit. Die Daten und die damit verbundene Konfiguration sind im ImageWatch-Control zu finden.

	Für alle folgenden Attribute besitzt das Control eine Getter- und eine Setter-Methode. Zum Beispiel existieren für das Attribut `BarColor` die beiden Methoden `getBarColor(): SolidColor` und `setBarColor(value: SolidColor): void`. Die Benutzung der Attribute wird in den verlinkten Unterkapiteln näher erklärt. Alle weiteren Attribute, Events und Permissions die die Basisklasse Controls bereitstellt, finden Sie in der TwinCAT HMI Dokumentation.

Kategorie: Colors

Attribut	Typ	Beschreibung
`BarColor`	`SolidColor`	Farbe der Toolbar (siehe Kategorien Toolbar).
`IndexColor`	`SolidColor`	Farbe des Index in der Liste.
`IndexStrokeColor`	`SolidColor`	Farbe der Index-Umrandung in der Liste. Nur wirksam, wenn `FitImage` deaktiviert ist.
`IndexBackgroundColor`	`SolidColor`	Farbe des Index-Hintergrunds in der Liste.
`TimestampColor`	`SolidColor`	Farbe des Zeitstempels in der Liste.
`TimestampStrokeColor`	`SolidColor`	Farbe der Zeitstempel-Umrandung in der Liste. Nur wirksam, wenn `FitImage` deaktiviert ist.
`TimestampBackgroundColor`	`SolidColor`	Zeitstempel-Hintergrundfarbe in der Liste.
`ElementBackgroundColor`	`SolidColor`	Elemente-Hintergrundfarbe in der Liste.
`ElementSelectionColor`	`SolidColor`	Markierungsfarbe des ausgewählten Elements.

Kategorie: Common

Mit folgendem Attribut wird die Verlinkung zum ImageWatch-Control angegeben.

Attribut	Typ	Beschreibung
`ImageWatchControl`	TcHmiVnImage	Verlinkung zu der ImageWatch-Control-Instanz die gesteuert werden soll.

Kategorie: Toolbar

Mit folgenden Attributen kann die Toolbar des Controls angepasst werden.

Attribut	Typ	Beschreibung
`ToolbarVisible`	`Boolean`	Anzeige der Toolbar.
`QueueIndexVisible`	`Boolean`	Eingabewert des Index zur Auswahl bzw. Anzeige des angegebenen History-Bildes bei aktiviertem `ImageFreeze`. 0 entspricht dem zuletzt empfangenen Bild.
`NavigationButtonsVisible`	`Boolean`	Schaltflächen, um in der Bild-History bei aktiviertem `ImageFreeze` einen Bildeintrag vor- oder zurückzugehen.
`NavigationEndButtonsVisible`	`Boolean`	Schaltflächen, um zum zuerst oder zuletzt empfangenen Bild der History bei aktiviertem `ImageFreeze` zu springen.
`FreezeButtonVisible`	`Boolean`	Schaltfläche, um die Bildaktualisierung des verlinkten ImageWatch zu pausieren. Nur bei aktiviertem `ImageFreeze` kann die History-Funktionalität verwendet werden.
`DownloadButtonVisible`	`Boolean`	Schaltfläche, um einen browserspezifischen Download des aktuell angezeigten Bildes in Originalgröße auszulösen, siehe Bild-Download.
`ToolbarHeight`	`Number (px)`	Höhe der Toolbar.
`QueueIndexWidth`	`Number (px)`	Breite des `QueueIndex` Eingabefelds und der Gesamtanzahl von Einträgen.

Kategorie: List

Mit folgenden Attributen kann die Bild-Liste des Controls angepasst werden.

Attribut	Typ	Beschreibung
`ImageListVisible`	`Boolean`	Anzeige der Bild-Liste.
`Orientation`	`Orientation`	Orientierung des Controls, Horizontal oder Vertikal.
`IndexVisible`	`Boolean`	Anzeige des Index.
`ImageVisible`	`Boolean`	Anzeige des Bildes.
`TimestampVisible`	`Boolean`	Anzeige des Timestamps.
`FitImage`	`Boolean`	Maximiert die Bildgröße sodass Index und Timestamp auf dem Bild stehen. Nur wirksam, wenn `ImageVisible` aktiv ist.
`ImageSize`	`Number`	Bestimmt bei vertikaler Ansicht die Bildhöhe, bei horizontaler Ansicht die Bildbreite des Bildes in der Liste. Nur wirksam, wenn `ImageVisible` aktiv und `FitImage` nicht aktiv ist.
TimestampFormat	Function	Funktion, die eine Zeichenkette aus einem Zeitstempel für die Anzeige in der Liste generiert.
`IndexFontFamily`	`FontFamily`	Schriftart des Index in der Liste.
`IndexFontSize`	`MeasurementValue`	Schriftgröße des Index in der Liste.
`IndexFontStyle`	`FontStyle`	Font Style des Index in der Liste.
`IndexFontWeight`	`FontWeight`	Font Weight des Index in der Liste.
`TimestampFontFamily`	`FontFamily`	Schriftart des Zeitstempels in der Liste.
`TimestampFontSize`	`MeasurementValue`	Schriftgröße des Zeitstempels in der Liste.
`TimestampFontStyle`	`FontStyle`	Font Style des Zeitstempels in der Liste.
`TimestampFontWeight`	`FontWeight`	Font Weight des Zeitstempels in der Liste.

Weiterführende Informationen