Unterstützte HTML-Tags im Text

Bisher war es in FastReport möglich, einige einfache HTML-Tags im Text-Objekt mit der HtmlTags Eigenschaft zu verwenden. Die HtmlTags Eigenschaft wurde jedoch durch die neue TextRenderType Eigenschaft ersetzt. Diese neue Eigenschaft bietet eine breitere Palette von Funktionen als nur die Handhabung von HTML-Tags.

Die TextRenderType Eigenschaft hat drei mögliche Werte:

  • Default ist nur Text, ohne Tag-Konvertierung;
  • HtmlTags ist ein Satz von HTML-Tags. Die Liste ist ziemlich begrenzt: <b>, <i>, <u>, <strike>, <br>, <sub>, <sup>, <img>;
  • HtmlParagraph ermöglicht die Einstellung des Zeilenabstands, des Einzugs und der gleichen Tags wie HtmlTags;
  • Inline zeigt Texte in einem einfachen Format an. Nur für den internen Gebrauch, die Verwendung wird nicht empfohlen.

Eines der in der vorherigen HtmlTags-Eigenschaft verfügbaren Tags war das <font>-Tag. Dieses Tag gilt inzwischen als veraltet und wird nicht von allen Browsern unterstützt. Daher wurde ein neuer Rendering-Mechanismus eingeführt, der es Ihnen ermöglicht, bestimmte CSS-Stile mit dem style-Attribut für das <span>-Tag anzuwenden.

Schauen wir uns die Verarbeitungsmodi für HTML-Tags genauer an:

HtmlTags

Wie bereits erwähnt, unterstützt das Text-Objekt die folgenden HTML-Tags:

  • <b> - Text mit fetter Schrift hervorheben

Anwendungsbeispiel:

<b>FastReport</b>

Ergebnis:

  • <i> - Text in Kursivdruck darstellen

Anwendungsbeispiel:

<i>FastReport</i>

Ergebnis:

  • <u> - Text unterstrichen darstellen

Anwendungsbeispiel:

<u>FastReport</u>

Ergebnis:

  • <strike> - Text durgestrichen darstellen

Anwendungsbeispiel:

<strike>FastReport</strike>

Ergebnis:

  • <br> - Zeilenumbruch

Anwendungsbeispiel:

Fast<br>Report

Ergebnis:

  • <sub> - Text tiefstellen

Anwendungsbeispiel:

Fast<sub>Report</sub>

Ergebnis:

  • <sup> - Text hochstellen

Anwendungsbeispiel:

Fast<sup>Report</sup>

Ergebnis:

  • <img> - Bilder in Text einfügen

    Das <img>-Tag unterstützt nur das src-Attribut, das einen Link zum Bild (http, https, base64) enthalten kann, sowie die Attribute width und height, die die Bildgröße in Pixel definieren. Auf diese Weise können Bilder direkt in den Text eingefügt werden. Für Webberichte sind Links zu Bildern mit http- und https-Protokollen anwendbar.

Anwendungsbeispiel:

<img src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAADwAAAAyCAIAAACPlC9VAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAAAGkSURBVGhD7dDRjoMgEAXQ/v9Pd417poEVBBRttul569yRuenjOc+jxd5pEx7SaIQvjzr+vfvneGvQkc8cnMe73cY+cOQabnQYWe1gtcTGLqst3Xu7LHXzWYmNXX1LFeKjvLIhruvYKJHN4MWcrKIVl8jm8W5OVrKblchm83pOtlEPSmTXcCMnyw2UFlzJpYQgV5luCK7nXkKQ6CptehdXg2miNNoQ3MXVhCC0S5vey+1gGja/NwT3cjshWDVKm76DBsF09S09lQYJwZ/SwmD6PnoE02/p+fQIpt/S8+kRTL+l59MjmH5C6YU8mL6DBgnBPyptuvrE0gvBvdxOCFaFTraC6b3cDqahXXohuIurCUEoF7IbTO/iakIQukovBNdzLyFIVNv4IiG4kksJQW6g9EJ2DTdystxeD9/lZLN5PSfbaJTwdU42j3dzspJ2A2/kZDN4MSer6DrvpQ3xUV4psVHRe9hjJTZG+LLExq6Bk17dZbXExi6rLWP/k7ev4UaHsdK/HJnHu92OlP7l4DneGnS89Iv7g3x8yITSL+rU2Tvp+fwB+FeG5yXqCcoAAAAASUVORK5CYII=" alt=""/>

Ergebnis:

HtmlParagraph

Dieser Modus enthält einen neuen HTML-Tag-Handler. Er verarbeitet die gleichen Tags wie HtmlTags und enthält außerdem ein <span>-Tag. Obwohl dieser Modus über die gleichen Tags verfügt, werden sie unterschiedlich gerendert. Besonders auffällig ist dies bei den Tags <sub> und <sup>.

Das <span>-Tag bietet die Möglichkeit, Texte mithilfe des style-Attributs zu formatieren. Dadurch können Sie verschiedene CSS-Stile wie Textfarbe, Schriftgröße, Ausrichtung und andere Formatierungsoptionen direkt auf einen bestimmten Textabschnitt anwenden. Also, anstatt das veraltete <font>-Tag zu verwenden, das die Funktionalität einschränkt und weniger flexibel ist, können Sie jetzt den gleichen Effekt durch die Verwendung des <span>-Tags mit einfachen CSS-Stilen im style-Attribut erzielen.

Anwendungsbeispiele:

<span style="font-size:20pt;">FastReport</span>
<span style="color:red;">Fast</span>Report
<span style="font-family:Consolas;">FastReport</span>
<span style="background-color:yellow;">FastReport</span>

Ergebnis:

ParagraphFormat

Die ParagraphFormat-Eigenschaft sollte gesondert betrachtet werden. Sie arbeitet mit der HtmlParagraph-Eigenschaft zusammen und stellt die Einstellungen für die Anzeige von Absätzen (Zeilenabstand, Einzug). Und zwar:

  • FirstLineIndent – Einzug der ersten Zeile;
  • LineSpacing - Zeilenabstand in Zentimetern;
  • LineSpacingMultiple - Multiplikationsfaktor mit dem Wert des vorherigen Parameters. Funktioniert mit dem Multiple-Typ;
  • LineSpacingType - Art des Zeilenabstands:
    • Einfacher (Single);
    • Mindestens (At least);
    • Exakt (Exact);
    • Mehrfach (Multiple).

Beispiele für Einstellungen:

Ergebnis: