Das Event vom ExportParameter im WebReport.Report

2020-10-05

FastReport 2020.1 bietet eine Möglichkeit, Exportparameter zu ändern. Dazu wollen Sie das ExportParameters-Ereignis in WebReport.Report abonnieren.

Bisher bot die FastReport.Net-Bibliothek keinen Zugriff zum Exportparameter. Vielmehr stellte es aber nur einen Teil der Parameter und mit Hilfe einzelner Eigenschaften des WebReports zur Verfügung. Alle diese Eigenschaften werden in großen Mengen ausgegeben, und die Arbeit mit ihnen mit Intelisense ist völlig unpraktisch und deckt nicht alle Benutzeranforderungen ab. Daher wurde beschlossen, Benutzern mithilfe des speziellen ExportParameter-Ereignisses Zugriff auf alle Eigenschaften des Exportobjekts zu gewähren. Im Handler dieses Ereignisses können Sie das Exportobjekt abrufen und alle erforderlichen Eigenschaften festlegen. So wurde es möglich, den Export aufgrund bisher nicht verfügbarer Eigenschaften genauer anzupassen. So können Sie das neue Ereignis verwenden:

1
2
3
4
5
6
7
8
9
WebReport.Report.ExportParameters += (sender, e) =>
 {
 PDFExport export = e.Export as PDFExport;
 if (export != null)
 {
 export.Title = "test";
 export.DefaultPage = 2;
 }
 };

In diesem Beispiel haben wir nur den Titel und die Standardseite geändert. Bitte beachten Sie, dass wir während der Verarbeitung einen Export des PDF-Typs erwarten, was bedeutet, dass dieser Code für einen anderen Exporttyp nicht funktioniert. In einem Handler können Sie Einstellungen für mehrere Exportarten gleichzeitig festlegen.

You can specify settings for several export types at once

Lassen Sie uns nun am Beispiel des PDF-Exports sehen, wie die verfügbaren Exporteigenschaften erweitert wurden. Zuvor bot uns WebReport eine Reihe von Exporteigenschaften an, bei denen es sich im Wesentlichen um Wrapper für die Eigenschaften des PDFExport-Exportobjekts handelte:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
 public string PdfTitle { get; set; }
 public string PdfAuthor { get; set; }
 public string PdfSubject { get; set; }
 public string PdfKeywords { get; set; }
 public string PdfCreator { get; set; }
 public string PdfProducer { get; set; }
 public string PdfUserPassword { get; set; }
 public bool PdfPrintScaling { get; set; }
 public string PdfOwnerPassword { get; set; }
 public bool PdfAllowModify { get; set; }
 public bool PdfAllowCopy { get; set; }
 public bool PdfAllowAnnotate { get; set; }
 public bool PdfA { get; set; }
 public bool PdfShowPrintDialog { get; set; }
 public bool PdfImagesOriginalResolution { get; set; }
 public bool PdfJpegCompression { get; set; }
 public bool PdfAllowPrint { get; set; }
 public bool PdfCenterWindow { get; set; }
 public bool PdfHideWindowUI { get; set; }
 public bool PdfFitWindow { get; set; }
 public bool PdfEmbeddingFonts { get; set; }
 public bool PdfBackground { get; set; }
 public bool PdfInteractiveForms { get; set; }
 public bool PdfPrintOptimized { get; set; }
 public bool PdfOutline { get; set; }
 public bool PdfDisplayDocTitle { get; set; }
 public bool PdfHideToolbar { get; set; }
 public bool PdfHideMenubar { get; set; }
 public bool PdfTextInCurves { get; set; }

Ich will sagen, dass diese Liste der Eigenschaften die Haupt- und die beliebtesten, aber nicht alle enthält. Viele Benutzer wollen mehr. Mit dem neuen ExportParameter-Ereignis stehen ihnen nun alle Eigenschaften zur Verfügung:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
public bool HideWindowUI { get; set; } - hide user interface;
 public bool ShowPrintDialog { get; set; } – show printing dialog;
 public bool HideToolbar { get; set; } – hide toolbar in PDF viewer;
 public bool HideMenubar { get; set; } – hide menubar in PDF viewer;
 public GradientInterpolationPointsEnum GradientInterpolationPoints { get; set; } – gradient interpolation poinrs;
 public bool FitWindow { get; set; } – enable window fitting;
 public bool CenterWindow { get; set; } – center window;
 public bool PrintScaling { get; set; } – show scaling;
 public bool Outline { get; set; } – show contents;
 public MagnificationFactor DefaultZoom { get; set; }default zoom;
 public int RichTextQuality { get; set; } – RichText quality;
 public bool Compressed { get; set; } – compress file;
 public bool TransparentImages { get; set; } – transparent image;
 public bool DisplayDocTitle { get; set; } – display document title;
 public int DefaultPage { get; set; }default page number;
 public byte[] ColorProfile { get; set; } – color profile;
 public ExportType ExportMode { get; set; } – export type;
 public bool InteractiveForms { get; set; } – enable interactive forms;
 public bool IsDigitalSignEnable { get; set; } – enable digital signature;
 public bool SaveDigitalSignCertificatePassword { get; set; } – save digital signature certificate password;
 public X509Certificate2 DigitalSignCertificate { set; } – digital signature certificate;
 public string DigitalSignCertificatePath { get; set; } – digital signature certificate path;
 public string DigitalSignCertificatePassword { set; }; digital signature certificate password
 public string DigitalSignLocation { get; set; } – digital signature location;
 public string DigitalSignReason { get; set; } – digital signature reason;
 public string DigitalSignContactInfo { get; set; } – digital signature contact info;
 public CurvesInterpolationEnum CurvesInterpolation { get; set; } – curves interpolation;
 public bool AllowAnnotate { get; set; } – allow annotation;
 public bool AllowCopy { get; set; } – allow copying;
 public bool AllowModify { get; set; } – allow editing;
 public bool AllowPrint { get; set; } – allow print;
 public GradientQualityEnum GradientQuality { get; set; } – gradient quality;
 public PdfStandard PdfCompliance { get; set; } – PDF standard complience;
 public bool EmbeddingFonts { get; set; } – enable embedded fonts;
 public bool Background { get; set; } – enable background;
 public CurvesInterpolationEnum CurvesInterpolationText { get; set; } – interpolation text curves;
 public PdfColorSpace ColorSpace { get; set; } – color space;
 public bool ImagesOriginalResolution { get; set; } – use original image resolution;
 public bool PrintOptimized { get; set; } – print optimization;
 public bool JpegCompression { get; set; } – Jpeg image compression;
 public bool TextInCurves { get; set; } – make text in curves;
 public string Title { get; set; } – title;
 public string UserPassword { get; set; } – user password for encrypted documents;
 public int JpegQuality { get; set; } – Jpeg image quality;
 public string OwnerPassword { get; set; } – Owner’s password;
 public string Producer { get; set; } – Producer;
 public bool SvgAsPicture { get; set; } – Display Svg objects as pisctures;
 public string Keywords { get; set; } – Keywords;
 public string Subject { get; set; } – Subject of the document;
 public string Author { get; set; } – Author;
 public string Creator { get; set; } – Creator;

Und dies ohne Berücksichtigung der Eigenschaften, die mit allen Exporten gemeinsam sind.

Fassen wir die Vorteile des neuen ExportParameter-Ereignisses zusammen. Wenn Sie ein Objekt für einen bestimmten Export verwenden, stehen uns nur die Eigenschaften dieses Exports zur Verfügung. Bisher war es erforderlich, alle möglichen Exporte aus der allgemeinen Liste der Eigenschaften auszuwählen, was nicht immer praktisch ist, da die Namen einiger Eigenschaften nicht offensichtlich sind, um den Export zu identifizieren. Sie sehen eine vollständige Liste der verfügbaren Eigenschaften mit Intellisense oder eine vollständige Liste der verfügbaren Eigenschaften.

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.
30. Oktober 2024

Verwendung von Stilen beim Erstellen von Berichten in FastReport VCL

Dieser Artikel beschreibt eine der neuen Funktionen von FastReport VCL - die Verwendung von Stilen und Stilseiten.
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.