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:
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 |
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 |
DownloadButton | Schaltfläche zum Herunterladen des aktuellen Bildes mit Standardnamen (siehe Methode |
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.