Berichtselemente beim Bildrendering
Die Bildrenderingerweiterung rendert das Layout von Berichtselementen und -daten als statisches Bild. Es hängt vom jeweiligen Berichtselement ab, wie diese Elemente gerendert werden.
ReportItems
Die Elemente des ReportItems-Elements werden, wie weiter unten in diesem Thema beschrieben, gerendert. Für jedes Berichtselement werden die untergeordneten Elemente Name und Label ignoriert. Die untergeordneten Elemente Top, Left, Height, Width und ZIndex bestimmen, wie Elemente auf der Seite platziert werden. Weitere Informationen zum Positionieren finden Sie unter Entwerfen für die Bildausgabe.
Textbox
Ein Textfeld wird als umbrochener Text in einem Rechteck gerendert. In der folgenden Tabelle wird beschrieben, wie die Elemente im Textbox-RDL-Element von der Bildrenderingerweiterung gerendert werden.
| RDL-Element | Rendern als |
|---|---|
Value |
Text mit entsprechenden Formateigenschaften. |
CanGrow |
Wenn CanGrow gleich True ist, wird das Textfeld vertikal erweitert, damit genügend Platz für den Text zur Verfügung steht. Wenn CanGrow gleich False ist, wird der Text abgeschnitten. |
CanShrink |
Wenn CanShrink gleich True ist und der Text nicht so hoch ist wie das Textfeld, wird das Textfeld entsprechend verkleinert. |
HideDuplicates |
Der Text im Textfeld wird nicht gerendert, wenn die Daten mit dem vorherigen Datensatz identisch sind. Der Text wird angezeigt, wenn er im ersten Textfeld auf der Seite vorhanden ist. |
Image
In der folgenden Tabelle wird beschrieben, wie die Elemente im Image-RDL-Element von der Bildrenderingerweiterung gerendert werden.
| RDL-Element | Rendern als |
|---|---|
Value |
Wenn das Source-RDL-Element den Wert External hat, wird das Bild von diesem URL abgerufen und gerendert. Andernfalls wird das Bild von Bilddaten abgerufen und gerendert. Sollte das Bild nicht abgerufen werden können, wird ein rotes X angezeigt. |
Sizing |
Die Darstellung des Bildes wird durch das Sizing-RDL-Element bestimmt. Wenn Sizing den Wert Clip hat, wird die Größe des Bildes an die Ausgabeauflösung angepasst und dann an der angegebenen Höhe und Breite abgeschnitten. Mit dem Wert Fit wird die Größe des Bildes an die angegebene Höhe und Breite angepasst. Mit dem Wert FitProportional wird die Größe des Bildes an die angegebene Höhe oder Breite angepasst, wobei die ursprünglichen Proportionen des Bildes beibehalten werden. Mit dem Wert AutoSize wird die Größe des Bildes an die Ausgabeauflösung angepasst, wobei die Höhe und Breite ignoriert werden. |
Line
Das Line-Element wird mit allen entsprechenden Formateigenschaften gerendert.
Rectangle
Das Rectangle-Element wird mit allen entsprechenden Formateigenschaften gerendert. Die Inhalte werden innerhalb des Rechtecks angezeigt, und die Größe des Rechtecks wird an den Inhalt angepasst.
Subreport
Ein Unterbericht wird von der Bildrenderingerweiterung gerendert. Seitenumbrüche in einem Unterbericht werden so gerendert, als ob es sich bei dem Unterbericht um ein Rechteck handeln würde. Falls der Unterbericht nicht ausgeführt wird, wird anstelle des Unterberichts ein Fehler angezeigt.
BackgroundImage
Wiederholte Hintergrundbilder werden innerhalb des Elements wiederholt, in dem sie enthalten sind. Bilder werden an den Kanten des Elements, in dem sie enthalten sind, zugeschnitten. Hintergrundbilder werden unter den Elementen im Container angezeigt.
BorderStyle
Rahmen werden um ein Element herum gezeichnet, wie es in den Elementen Top, Right, Left und Bottom für die verschiedenen Rahmeneigenschaften angegeben wurde. Der Abstand für punktierte und gestrichelte Abstände ist unabhängig von der Auflösung identisch.
Beim Zeichnen von Rahmen wird eine Hälfte des Rahmens innerhalb des Elements und die andere Hälfte außerhalb des Elements erstellt. Beispielsweise werden für ein Textfeld mit einer Rahmenbreite von 4 Pixeln 2 Pixel des Rahmens innerhalb des Textfeldes und 2 Pixel des Rahmens außerhalb des Textfeldes angezeigt.
Fonts
Da der Bericht auf dem Server gerendert wird, müssen die im Bericht verwendeten Schriftarten auch auf dem Server installiert sein. Falls eine Schriftart nicht auf dem Server vorhanden ist, wird die GDI+-Schriftart GenericSerif verwendet. Wenn das FontWeight-Element den Wert 700, 800, 900, Bold oder Bolder hat, wird die Schriftart als fett gerendert.
Padding
Text wird in einem Berichtselement anhand der Werte der Elemente PaddingLeft, PaddingRight, PaddingTop und PaddingBottom positioniert. Der Abstand wird ab den Feldrändern gemessen, also ohne Berücksichtigung der Rahmen. Ist der Abstand kleiner als die Hälfte der Rahmenbreite, überschneidet der Rahmen den Text.
TextDecoration
Im TextDecoration-Element wird für den Wert Underline eine Linie unter dem Text angezeigt. Mit LineThrough wird der Text als durchgestrichen angezeigt. Overline wird nicht unterstützt.