Verwendung von Stilen beim Erstellen von Berichten in FastReport VCL

2024-10-30

Unter dem Stil (Style) versteht man in FastReport VCL ein Satz von visuellen Parametern einer Komponente, nämlich Schriftart, Füllung und Rahmen. Direkt im Berichtsdesigner können Sie einen Stil erstellen, der nur Informationen zur Schriftart entweder nur zum Rahmen oder zur Füllung mit Rahmen enthält. Sie können alle diese Parameter gleichzeitig oder abwechselnd verwenden, je nach Ihren Bedürfnissen.

Der Stil ist nützlich, um die Massenänderung des Erscheinungsbildes von Komponenten durchzuführen. Dies ist hilfreich, wenn Sie mehrere Parameter festlegen, um nicht mehrmals dieselben Eigenschaften manuell festlegen zu müssen. Auch durch die Änderung der Stilparameter können Sie das Erscheinungsbild des Berichts schnell ändern. Die fertige Stilbibliothek kann als separate Datei gespeichert und zum Anpassen mehrerer Berichte verwendet werden.

In FastReport VCL können Stile zu einem „StyleSheet“ zusammengefasst werden. Ein Satz von Stilseiten wird als „StyleSheet“ (oder „Stylebook“) bezeichnet. Jeder Stil ist auf jeder Stilseite vorhanden. Und auf jeder Stilseite kann der Stil selbst unterschiedliche Parameter haben. Auf diese Weise ist es möglich, die Einstellungen des Erscheinungsbildes eines Berichts schnell zu ändern, indem einfach die aktuelle Stilseite geändert wird. Dies kann z. B. nützlich sein, wenn derselbe Bericht auf mehreren Betriebssystemen mit unterschiedlichen Schriftarten verwendet werden soll. So werden die gewünschten Stile durch einfaches Wechseln der Stilseite eingestellt. 

Wir können davon ausgehen, dass in FastReport VCL jeder Bericht mindestens eine Stilseite mit dem Namen „Standard“ (Default) hat.

 


 

Stilsteuerelemente 

Zum Verwalten und Umgang mit Stilen und Stylesheets gibt es eine Symbolleiste „Stile“.

Stile Symbolleiste

 

steuert die Verwendung von Stylesheets und enthält ein Untermenü mit zwei Punkten: 
«Designer style book» ermöglicht die Verwendung von Stylesheets im Berichtsdesigner.
«Preview Style book» ermöglicht die Verwendung von Stylesheets im Vorschaufenster (Änderung des aktuellen Stylesheets).
aktiviert den Stilbearbeitungsmodus direkt im Bericht.
fügt eine neue Stilseite hinzu.
ist für die Auswahl der aktiven Stilseite und für die Änderung des Namens der Stilseite verantwortlich.
löscht die aktuell ausgewählte Stilseite.
fügt einen neuen Stil hinzu.
ermöglicht Ihnen, einen Stil für die aktuell ausgewählte Komponente auszuwählen und den Namen des aktuellen Stils zu ändern.
Löscht den aktuellen Stil.

 

Sie können das Formular auch zum Bearbeiten und Verwalten von Stilen verwenden, das über das Menü „Bericht“ -> „Stile“ aufgerufen werden kann.

Formular zur Stileinstellungen

Die Symbolleistenschaltflächen dieses Formulars haben dieselben Funktionen wie die in der Symbolleiste „Stile“. Darüber hinaus können Sie ein Stylesheet auf der Festplatte speichern und lesen.

Auf der linken Seite des Formulars befindet sich eine Liste der im Bericht verfügbaren Stile. Wenn Sie einen Stil auswählen, können Sie seine Parameter bearbeiten. Das folgende Panel enthält ein Beispiel für die Anwendung eines Stils auf ein Berichtselement.

In der Mitte des Formulars befinden sich 3 Schaltflächen, mit denen Sie die Stilkomponenten bearbeiten können. Neben den Schaltflächen befinden sich 3 Kontrollkästchen. In diesen Kontrollkästchen können Sie angeben, ob der Stil die eine oder andere Komponente enthält - Hintergrundfarbe, Schriftart oder Rahmen. Und die Verwendung der einen oder anderen Komponente des Stils ist auf allen Stilseiten gleichzeitig erlaubt oder verboten.

 


 

Umgang mit Stilen 

Ein spezielles Formular, das über das Menü „Bericht -> Stile...“ (siehe Screenshot oben) aufgerufen werden kann, dient zum Festlegen der Stileigenschaften. Mit diesem Formular können Sie dem Bericht Stile hinzufügen und daraus entfernen, sie umbenennen und ihre Eigenschaften festlegen. Sie können sie auch aus Stildateien speichern und laden.

Sie können den Stil der ausgewählten Berichtskomponente mithilfe der ComboBox auf der Stilleiste oder mithilfe der Eigenschaft „Stil“ im Objektinspektor festlegen. Wenn Sie einer Berichtskomponente einen Stil namens „Kein Stil“ zuweisen oder den Stilnamen im Objektinspektor entfernen, bleibt das Erscheinungsbild der Komponente erhalten. Nach diesen Schritten ist diese Komponente jedoch nicht mehr vom Stil abhängig.

Sie können den Berichtsdesigner auch über die Schaltfläche auf der Stilleiste (Edit Styles Mode) in den Stilbearbeitungsmodus wechseln. 

Umgang mit Stilen

In diesem Modus werden 2 Schaltflächen an den Seiten der ComboBox mit Stilnamen aktiv. Sie können damit Stile hinzufügen und entfernen. Wenn Sie über die Schaltfläche auf der Stilleiste einen Stil erstellen, werden die Eigenschaften der aktuell ausgewählten Komponente diesem Stil zugewiesen. Wenn Sie einen Stil löschen, bleibt die Formatierung der Berichtskomponenten erhalten. Allerdings wird die Formatierung jetzt nicht im Stil, sondern in der Komponente selbst gespeichert.

Jeder Benutzer hat die Möglichkeit, Stile direkt im Bericht zu bearbeiten. Wenn Sie visuelle Eigenschaften eines Elements bearbeiten, dem ein Stil zugewiesen ist, bearbeiten Sie tatsächlich die Eigenschaften dieses Stils. Dieses Verhalten ist direkt im Designer zu sehen. Wenn Sie die Parameter einer Komponente ändern, werden alle Komponenten, die diesen Stil haben, geändert. 

Beispiel für die Änderung des Schriftparameters

 


 

Umgang mit Stylesheets 

Auswählen von Stil-Modi

Um mit Stylesheets arbeiten zu können, müssen Sie diese zunächst aktivieren. Klicken Sie dazu auf die Schaltfläche „Style Book Mode“ und wählen Sie den Modus „Design Style Book“ oder „Preview Style Book“ aus. Danach werden die Schaltflächen „Add Style Sheet“, „Delete style Sheet“ und die ComboBox mit den Namen der Stylesheets aktiv. Sie können Stylesheets hinzufügen, löschen und umbenennen sowie jedes davon aktivieren.

Wenn ein Stylesheet aktiviert wird, ändern alle Stile ihren Status in den im aktuellen Stylesheet gespeicherten Status.

Wenn Sie ein neues Stylesheet erstellen, werden die Daten dafür aus dem aktuell aktiven Stylesheet übernommen. Wenn die Option „Preview Style Book” aktiviert ist, ist das Ändern von Stilseiten in der Vorschau möglich. Dann sehen Sie auf der rechten Seite der Symbolleiste eine ComboBox. Hier können Sie die gewünschte Stilseite auswählen, die dann sofort auf den Bericht angewendet wird.

Aktiver Modus „Preview Style B“

 


 

Speichern und Lesen von Stilen 

Schaltflächen „Laden“ und „Speichern“

Gehen wir zurück zum Fenster mit den Stileinstellungen. Dieses Fenster enthält die Schaltflächen „Speichern“ und „Lesen“. Wenn Sie darauf klicken, werden Dialoge zum Lesen und Schreiben einer Datei aufgerufen, mit denen Sie ein Stylesheet im *.fs3-Format speichern und lesen können. Unabhängig vom Stylesheet-Modus werden alle im Bericht enthaltenen Stylesheets in die Datei geschrieben. 

In der Regel sollte der Endbenutzer den Bericht nicht bearbeiten, er hat lediglich die Möglichkeit, eine Vorschau anzuzeigen. Daher muss der Softwareentwickler in der Lage sein, den aktuellen Berichtsstil im Anwendungscode festzulegen.  Dies kann wie folgt erfolgen:

begin
  //Bericht laden
  frxReport1.LoadFromFile(DefPath+'main.fr3');
  //Stile laden
  frxReport1.Styles.LoadFromFile(DefPath+'main.fs3');
  // für die Stylesheet-Verwaltung darf frxReport1.Styles.StyleBookMode nicht [] gleich sein 
  frxReport1.Styles.StyleBookMode:=[fsbDesigner];
  //den erforderlichen Stil festlegen 
  frxReport1.Styles.ActiveStyleSheet:='MyStyleSheet';
  //den Stil auf den Bericht anwenden 
  frxReport1.Styles.Apply;
  frxReport1.ShowReport();
end;

Weitere Einzelheiten zum Umgang mit Stilen sind im Handbuch für Softwareentwickler beschrieben.

 


 

Stylesheets und bedingte Formatierung 

Bei der Verwendung von bedingter Formatierung in Verbindung mit Stylesheets ist Vorsicht geboten. Wenn der Modus „Preview Style Book“ aktiv ist, geht die bedingte Formatierung bei der Stiländerung verloren. Sie können problemlos die Formatierungselemente ändern, die vom Stil nicht verwendet werden.

Fassen wir zusammen. Der Umgang mit Stilen und Stilseiten ist überhaupt nicht schwierig. Diese Funktionalität vereinfacht und beschleunigt die Erstellung von Berichten erheblich. Dadurch können Sie Gruppen von Berichten mit demselben Gestaltungsstil viel schneller erstellen.

26. November 2024

Installing FastReport on .NET 8.0 and Creating a Simple Report

The purpose of this article is to explain step by step how to install FastReport on .NET 8.0 and how to create a simple report. Taking the reporting process from the beginning, it will show how to connect, design and view reports.
20. November 2024

Lokalisierung und Ändern von Sprachen in FastReport VCL

FastReport VCL unterstützt 40 Sprachen für die Schnittstellenlokalisierung und ermöglicht es Ihnen, die Sprache im laufenden Betrieb über Menüs oder Code ohne Neukompilierung zu ändern.
1. November 2024

Neue Funktionen des FastReport VCL Berichtseditors

Wir betrachten die neuen Funktionen des Berichtseditors: Hilfslinien, Hervorhebung von sich schneidenden Objekten, aktualisierte Berichts- und Datenbäume.
Fast Reports
  • 800-985-8986 (Englisch, die USA)
  • +4930568373928 (Deutsch)
  • +55 19 98147-8148 (Portugiesisch)
  • info@fast-report.com
  • 66 Canal Center Plaza, Ste 505, Alexandria, VA 22314

© 1998-2024 Fast Reports Inc.