Toolbar

Die hier 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 und mit eigenen Controls selbst implementieren und auf der Image-Control Toolbar platzieren. Die verfügbaren Toolbar-Elemente von links nach rechts sind:

Toolbar 1:

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 an die Größe des Controls. Die auswählbaren Skalenwerte können über eine zusätzliche Eigenschaft 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 ActivateShape. 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 FreezeCurrent. Wenn aktiv, ist das aktuell angezeigte Bild festgesetzt und wird nicht mehr aktualisiert.

DownloadButton

Schaltfläche zum Herunterladen des aktuellen Bildes mit Standardnamen (siehe Methode downloadImage). Um einen anderen Dateinamen zu vergeben, kann diese Schaltfläche selbst implementiert und dann die Methode mit einem selbst definierten Namen aufgerufen werden.

Toolbar 2:

Funktionen auch programmatisch zugänglich

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

Größeneinstellungen

Die Toolbar bietet Anpassungsmöglichkeiten für die Höhe der Symbolleiste selbst (Eigenschaft ToolbarHeight) und für die Breite der beiden Comboboxen (Eigenschaften ImageSelectionWidth und ScaleSelectionWidth). Die Breite der drei zusätzlichen Schaltflächen wird automatisch an die Höhe der Symbolleiste angepasst, so dass sie 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, 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 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.