Toolbar

Die auf dieser Seite erklärten Attribute und Funktionen sind in der Kategorie Toolbar zu finden.

Über die Bedienelemente in der Toolbar können verschiedene Aktionen interaktiv ausgeführt werden, die sonst nur über die Attribute zugänglich sind. Jedes Element kann ein- oder ausgeblendet werden. Außerdem kann die gesamte Toolbar in ihrer Höhe angepasst oder vollständig ausgeblendet werden.

Die Positionierung der Elemente in der Toolbar ist fest und kann nicht individuell angepasst werden. Wenn solche Anpassungen dennoch erforderlich sind, können Sie die entsprechenden Elemente mittels der Eigenschaft ToolbarItems ausblenden, mit eigenen Controls selbst implementieren und auf der Image-Control Toolbar platzieren.

Die verfügbaren Toolbar-Elemente teilen sich in die Gruppen General und History auf. Die einzelnen Elemente werden folgend pro Gruppe von links nach rechts beschrieben, die Gruppe General beginnt bei der dargestellten Auswahl des Result Bilds:

Kategorie: General

ImageSelection	Combobox zur Auswahl von Bildern aus der anzuzeigenden Bildliste (siehe Eigenschaft `ImageList` in der Kategorie Common). Wird nur angezeigt, wenn die Bildliste mindestens ein Element enthält. Beim Umschalten zwischen Bildern ist eine kurze Ladezeit zu erwarten.
ScaleSelection	Combobox zur Auswahl von bestimmten Skalierungswerten zur Anpassung des aktuellen Bildes. Die auswählbaren Skalierungswerte können über die Eigenschaft `ScaleOptions` angepasst werden. Wenn `ScaleSelectionEditable` deaktiviert wird, während eine benutzerdefinierte Skalierung eingestellt ist, zeigt die Combobox keinen Wert mehr an. Dies ist das Standardverhalten des Combobox-Controls.
ShapeButton	Schaltfläche zum Einstellen des Wertes der Eigenschaft `ScaleSelectionActive`. Wenn aktiv, wird ein vorhandenes Shape angezeigt und kann bearbeitet werden. Wird kein Shape angezeigt, kann ein neues gezeichnet werden.
FreezeButton	Schaltfläche zum Einstellen des Wertes der Eigenschaft `ImageFreeze`. Wenn aktiv, ist das aktuell angezeigte Bild festgesetzt und wird nicht mehr aktualisiert.
DownloadButton	Schaltfläche zum Herunterladen des aktuellen Bildes mit Standardnamen (siehe Funktion `downloadImage` unter Bild-Download). Um einen anderen Dateinamen zu vergeben, kann diese Schaltfläche selbst implementiert und dann die Funktion mit einem selbst definierten Namen aufgerufen werden.

Kategorie: History

QueueIndex	Eingabewert des Index zur Auswahl bzw. Anzeige des angegebenen History-Bildes bei aktiviertem `ImageFreeze`. 0 entspricht dem zuletzt empfangenen Bild.
NavigationButtons	Schaltflächen um in der Bild-History bei aktiviertem `ImageFreeze` einen Bildeintrag vor- oder zurückzugehen.
NavigationEndButtons	Schaltflächen um zum zuerst oder zuletzt empfangenen Bild der History bei aktiviertem `ImageFreeze` zu springen.

	Funktionen auch programmatisch zugänglich Jede Aktion, die über die Oberflächenelemente der Toolbar zugänglich ist, ist auch programmatisch über die Eigenschaften des Controls zugänglich.

Größeneinstellungen

Die Toolbar bietet mehrere Anpassungsmöglichkeiten, so lässt sich die Höhe über die Eigenschaft ToolbarHeight einstellen. Des Weiteren können einzelne Elemente über die Eigenschaften ImageSelectionWidth, ScaleSelectionWidth und QueueIndexWidth in der Breite angepasst werden. Die Breite aller Schaltflächen wird automatisch an die Höhe der Toolbar angepasst, sodass diese quadratisch sind.

Die Breite der Dropdown-Schaltfläche der Comboboxen kann nicht angepasst werden, da diese Funktionalität im Standard-Combobox-Control nicht vorhanden ist.

Intern wird die Eigenschaft ToolbarHeight auf maximal 150 Pixel begrenzt.

Hintergrundfarbe

Die Hintergrundfarbe der Toolbar ist standardmäßig ein halbtransparentes Weiß "rgba(255, 255, 255, 0.5)" bzw. R: 255, G: 255, B: 255, A: 127 und kann über die Eigenschaft BarColor in der Kategorie Colors angepasst werden.

Erweiterte Einstellungen

Weitere grafische Einstellungen (z. B. Schriftart der Comboboxen) können über Themed Resources verändert werden. Im Wesentlichen werden dabei Attribute der Comboboxen, Textblöcken und Numeric Input bereitgestellt. Die Themed Resources können im Theme-Editor unter TcHmiVnImage > Themed Resources angepasst werden. Diese Einstellungen gelten dann für alle Instanzen des Image Viewer Controls.