Rectangle (Interactive)

Das Rectangle (Interactive) Control bietet eine Umgebung, um ein Rechteck anzeigen oder per Klicks zeichnen zu können. Hauptsächlich wird das Control innerhalb des Image Watch-Controls verwendet; es kann aber auch alleinstehend genutzt werden. Somit können z.B. Bildregionen ausgewählt werden, um Objekte zu markieren oder ROIs festzulegen. Neben einem Rechteck können auch Quadrate, Kreise oder Ellipsen gezeichnet werden. Dazu müssen die Attribute StrokeShape und AspectRatio entsprechend angepasst werden.

	Für alle folgenden Attribute besitzt das Control eine Getter- und eine Setter-Methode. Alle weiteren Attribute, Events und Permissions die die Basisklasse Controls bereitstellt, finden Sie in der TwinCAT HMI Dokumentation.

Kategorie: Colors

Attribut	Typ	Beschreibung
`StrokeColor`	`SolidColor`	Farbe der Konturen des gezeichneten Rechtecks.
`HandleColor`	`SolidColor`	Farbe der Griffe des gezeichneten Rechtecks.

Kategorie: Common

Attribut	Typ	Beschreibung
`ShapeData`	`TcVnRotatedRectangle`	Enthält die Beschreibung des Rechtecks. Kann sowohl zum Abrufen eines gezeichneten Rechtecks genutzt werden als auch zum Einstellen eines spezifischen Rechtecks.
`AspectRatio`	`Number`	Gibt das Seitenverhältnis an, dass beim Zeichnen des Rechtecks erzwungen wird. Beim Wert `0` wird kein bestimmtes Seitenverhältnis erzwungen.

Funktion	Beschreibung
`clear`	Löscht das gezeichnete Rechteck und die Beschreibung aus dem `ShapeData`-Attribut.

Kategorie: Usage

Attribut	Typ	Beschreibung
`InitialSelection`	`InitialSelection`	Legt fest, ob das Rechteck mit zwei Klicks oder mit einer streichenden Bewegung oder mittels beider Optionen gezeichnet werden kann.
`CenterHandle`	`Boolean`	Zeigt ein Element in der Mitte des Rechtecks an, um dieses zu verschieben.
`CornerHandles`	`Boolean`	Zeigt Elemente an den Ecken des Rechtecks an, um dessen Größe zu verändern.
`EdgeHandles`	`Boolean`	Zeigt Elemente an den Kanten des Rechtecks an, um dessen Größe zu verändern.
`RotationHandle`	`Boolean`	Zeigt ein Element außen am Rechteck an, um dieses zu drehen.
`ShapeDragging`	`Boolean`	Legt fest, ob das Rechteck an den Kanten verschoben werden kann.
`AngleInterval`	`Number`	Gibt an, in welchen Schritten das Rechteck gedreht werden kann. Bei 0 kann das Rechteck beliebig gedreht werden.
`Boundary`	`Boundary`	Legt über die fünf Eigenschaften „X“, „Y“, „Width“, „Height“ und „IsActive“ einen Bereich fest, in dem die Form gezeichnet und bearbeitet werden kann. Die Form kann diesen Bereich nicht verlassen.
`DataUpdate`	`DataUpdate`	Legt fest, ob ShapeData während „onChanged“ oder am Ende „onConfirmed“ einer grafischen Interaktion aktualisiert werden soll.

Kategorie: Appearance

Attribut	Typ	Beschreibung
`StrokeThickness`	`MeasurementValue`	Linien-Dicke des Rechtecks.
`HandleSize`	`MeasurementValue`	Größe der Elemente zum Verschieben und Verändern des Rechtecks.
`StrokeShape`	`StrokeShape`	Legt fest, ob ein Rechteck oder eine Ellipse gemalt wird. Die Beschreibung ist für beides identisch. Um ein Quadrat oder einen Kreis zu erhalten, kann der AspectRatio auf 1 gesetzt werden.
`ClickableSize`	`MeasurementValue`	Größe der klickbaren Fläche um o.g. Elemente zum Verschieben und Verändern des Rechtecks. Hiermit kann die Benutzung per Touchscreen vereinfacht werden, ohne das Aussehen zu verändern.
`Offset`	`Vector2`	Legt fest, mit welcher Verschiebung die Form angezeigt werden soll.
`Scale`	`Number`	Legt fest, in welcher Skalierung die Form angezeigt werden soll. Der Wert 1 entspricht dabei 100%.

Events

Event	Beschreibung
`.onShapeChanged`	Dieses Event wird ausgelöst, sobald sich das Attribut `ShapeData` ändert.
`.onShapeConfirmed`	Dieses Event wird ausgelöst, wenn eine Form gesetzt oder eine Interaktion mit dieser abgeschlossen wurde.