Bild-Liste
Die auf dieser Seite erklärten Attribute und Funktionen sind in der Kategorie List zu finden.
Eigenschaft: ImageListVisible
Mit der Eigenschaft ImageListVisible kann die Bild-Liste aus- und eingeblendet werden. Wenn die Liste ausgeblendet ist, nimmt die Toolbar die Fläche des gesamten Controls ein. Da das Control im Hochformat initialisiert wird, sollte für diesen Fall die Höhe angepasst werden.
Bild-Liste
Die Bild-Liste zeigt für alle temporär gespeicherten History-Bilder einen Eintrag an, wenn ImageFreeze des verlinkten ImageWatch-Controls aktiviert ist. Pro Bild werden in der Liste die Index-Nummer, das entsprechende Bild sowie der Zeitstempel angezeigt. Der Zeitstempel stammt von dem Zeitpunkt, an dem das entsprechende Bild vom ImageWatch-Control empfangen wurde. Als Vorausetzung muss die QueueSize des ImageWatch Controls größer 0 sein.
In folgenden Fällen wird alternativ ein Text anstatt der Bild-Liste angezeigt:
- Wenn kein ImageWatch-Control verknüpft ist: „Link an ImageWatch control to use the image history“
- Wenn ImageFreeze nicht aktiv ist: „Activate freeze to show the image history“
- Wenn die History-Queue leer ist: „The image history queue is empty“
Je nach Orientierung repräsentiert der oberste oder der rechte Listeneintrag immer das aktuell empfangene Bild. Per Klick auf einen Eintrag kann ein Bild ausgewählt werden. Das in der Liste ausgewählte Bild wird markiert und im verlinkten ImageWatch-Control angezeigt.
Eigenschaft: Orientation
Mit der Eigenschaft Orientation wird festgelegt, wie die Einträge in der Bildliste angeordnet werden. Bei vertikal von oben nach unten und bei horizontal von rechts nach links. Somit befindet sich das zuletzt hinzugefügte Bild mit Index 0 immer oben oder rechts in der Bildliste.
Sichtbarkeiten
Die Inhalte der Listeneinträge können beliebig ein- und ausgeblendet werden. Hierfür dienen die Attribute IndexVisible, ImageVisible und TimestampVisible. Dabei erscheinen die Inhalte immer in folgender Reihenfolge: Index, Bild, Zeitstempel. Bei vertikaler Orientierung der Liste werden die Inhalte von links nach rechts und bei horizontaler Orientierung von oben nach unten angeordnet.
Eigenschaft: FitImage
Wenn die Eigenschaft FitImage aktiviert ist, werden die Bilder in der Liste maximiert dargestellt. Der Index wandert dabei in die obere linke Bildecke und der Zeitstempel in die untere rechte Bildecke. Damit beide weiterhin gut sichtbar bleiben, bekommt der Index eine größere Schrift sowie eine Textumrandung. Der Zeitstempel bekommt hingegen einen einfarbigen Hintergrund.
Diese Standardkonfiguration kann über die Eigenschaften IndexColor, IndexStrokeColor, IndexBackgroundColor, TimestampColor, TimestampStrokeColor und TimestampBackgroundColor in der Kategorie Colors individuell angepasst werden. So kann beispielsweise auch der Index einen einfarbigen Hintergrund bekommen und der Zeitstempel eine Textumrandung. Alternativ können der einfarbige Hintergrund des Zeitstempels und die Textumrandung des Index, durch Setzen einer transparenten Farbe, entfernt werden.
Eigenschaft: ImageSize
Die gewünschte Bildgröße der Bilder in der Liste kann mit der Eigenschaft ImageSize angegeben werden. Bei vertikaler Orientierung bezieht sich diese Eigenschaft auf die Bildhöhe. Bei horizontaler Orientierung dementsprechend auf die Bildbreite. Wenn das Bild mit der eingestellten Bildgröße den Platz anderer Inhalte einnehmen würde, wird es automatisch verkleinert. Wenn dies nicht erwünscht ist, sollte die Größe des gesamten Controls, je nach Orientierung, in der Breite (Vertikal) oder in der Höhe (Horizontal) erweitert werden.
Performance
Wenn zum ersten Mal ImageFreeze des ImageWatch-Controls aktiviert wird, wird die Bild-Liste des History-Controls erstellt. Bei größeren QueueSize Werten und in Abhängigkeit der Systemperformance kann dies mehr Zeit erfordern. Bei jedem weiteren Aktivieren von ImageFreeze werden nur die Listeneinträge geupdatet, sofern die Anzahl der Einträge gleich bleibt, was deutlich schneller geht. Daher empfehlen wir, die QueueSize nicht zu groß zu wählen.
Eigenschaften zur Anpassung der Schrift
Um die Liste stilistisch anpassen zu können stehen die Eigenschaften ListFontFamily, ListFontSize, ListFontStyle und ListFontWeight zur Verfügung.