Erstellen von benutzerdefinierten Linienstilen in FastReport .NET

Im neuesten FastReport .NET 2024.1 Update wurde eine neue DashPattern Eigenschaft zu den Objekten PolyLineObject, PolygonObject, LineObject und ShapeObject hinzugefügt. Mit dieser Eigenschaft können Sie ein benutzerdefiniertes Muster festlegen, um einen einzigartigen Stil von Linien zu erstellen, wenn das erforderliche Muster nicht im Standardsatz verfügbar ist.

Ein benutzerdefiniertes Muster ist ein Array von Werten, das mit dem Sammlungseditor oder manuell festgelegt werden kann.

Die Elemente im Array geben die Länge jedes Strichs und Leerzeichens im Muster an.

Das erste Element gibt die Länge des Strichs an, das zweite Element gibt die Länge des Leerzeichens an, das dritte Element gibt die Länge des Strichs an und so weiter. Im obigen Beispiel: 5 ist die Länge des Strichs, 3 ist die Länge des Leerzeichens, 2 ist die Länge des Strichs, 1 ist die Länge des Leerzeichens.

Jedes Element muss eine positive Zahl ungleich Null sein, andernfalls wird der Wert des Elements durch Eins ersetzt.

Damit das benutzerdefinierte Muster korrekt angezeigt wird, muss das Array des Musters eine gerade Anzahl von Elementen haben - 2, 4 usw. Wenn das Array eine ungerade Anzahl von Elementen hat, funktioniert das Muster wie folgt (mit dem Array 5,3,2 als Beispiel): es werden ein Strich der Länge 5, ein Leerzeichen der Länge 3, ein Strich der Länge 2, ein Leerzeichen der Länge 0, ein Strich der Länge 5 usw. gezeichnet.

Wenn das Array des Musters nur einen Wert enthält, wird eine durchgezogene Linie gezeichnet (nach dem gleichen Prinzip). Die Länge jedes Strichs und Leerzeichens im benutzerdefinierten Muster ist das Produkt aus dem Wert des Elements im Array und der Linienstärke. Das bedeutet, dass mit zunehmender Linienstärke auch die Länge der Striche und Leerzeichen zunimmt.

Diese Mechanik ist im folgenden Beispiel deutlich zu erkennen. Dasselbe benutzerdefinierte Muster mit unterschiedlichen Linienstärken führt zur Erstellung völlig unterschiedlicher Linienstile.

Der PDF-Export wird für Objekte unterstützt, die die DashPattern-Eigenschaft verwenden. Dies erweitert die Möglichkeiten zur Anpassung von Linien- und Konturstilen beim Speichern eines Berichts als PDF-Datei.