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.

	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`	`RectangleData`	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`	`"OnlyViaClicks" \| "OnlyViaDrag" \| "ViaBoth"`	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 Elemente 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.

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`	`"Rectangle" \| "Ellipse"`	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.