Erweiterte Rich-Text-Verarbeitung Rich-Text-Verarbeitungs-APIs

Unterstützte HTML-Teilmenge

Die Text-Widgets von Qt können Rich-Text anzeigen, der mithilfe einer Teilmenge des HTML-4-Markups definiert wird. Widgets, die „ QTextDocument “ verwenden, wie beispielsweise „ QLabel “ und „ QTextEdit “, können auf diese Weise definierten Rich-Text anzeigen.

Verwendung von HTML-Markup in Text-Widgets

Widgets erkennen HTML-Markup automatisch und zeigen Rich-Text entsprechend an. Wenn Sie beispielsweise die Eigenschaft ` text ` eines Labels auf die Zeichenkette ` "Hello Qt!" ` setzen, wird das Label den Text wie folgt anzeigen: Hello Qt!

Wenn HTML-Markup für Text verwendet wird, befolgt Qt die in der HTML-4-Spezifikation definierten Regeln. Dazu gehören Standard-Eigenschaften für das Textlayout, wie beispielsweise die Richtung des Textflusses (von links nach rechts), die durch Anwenden des dir Attribut auf Textblöcke angewendet wird.

Unterstützte Tags

Die folgende Tabelle listet die HTML-Tags auf, die von der Rich-Text-Engine von Qt unterstützt werden.

Hinweis: Die für die unten aufgeführten Tags implementierte Funktionalität ist eine Teilmenge der vollständigen HTML-4-Spezifikation. Es werden nicht alle Attribute unterstützt; siehe die Anmerkungen zu den einzelnen Tags.

Tag	Beschreibung	Anmerkung
`a`	Anker oder Link	Unterstützt die Attribute „ `href` “, „ `name` “ und „ `title` “.
`address`	Adresse
`b`	Fett
`big`	Größere Schrift
`blockquote`	Eingezogener Absatz
`body`	Dokumenttext	Unterstützt das Attribut „ `bgcolor` “, das entweder eine Qt- color name - oder eine „ `#RRGGBB` “-Farbspezifikation sein kann.
`br`	Zeilenumbruch
`center`	Zentrierter Absatz
`cite`	Inline-Zitat	Wie bei „ `i` “.
`code`	Code	Wie unter `tt` beschrieben.
`dd`	Definitionsdaten
`del`	Gelöscht	Wie unter `s`. Seit Qt 6.11
`dfn`	Definition	Wie unter `i` beschrieben.
`div`	Dokumentaufteilung	Unterstützt die Standard -Blockattribute.
`dl`	Definitionsliste	Unterstützt die Standard -Blockattribute.
`dt`	Definitionsbegriff	Unterstützt die Standard -Blockattribute.
`em`	Hervorgehoben	Entspricht „ `i` “.
`font`	Schriftgröße, Schriftart und/oder Farbe	Unterstützt die folgenden Attribute: „ `size` “, „ `face` “ und „ `color` “ (Qt color names oder `#RRGGBB`).
`h1`	Überschrift der Ebene 1	Unterstützt die Standard -Blockattribute.
`h2`	Überschrift der Ebene 2	Unterstützt die Standard -Blockattribute.
`h3`	Überschrift der Ebene 3	Unterstützt die Standard -Blockattribute.
`h4`	Überschrift der Ebene 4	Unterstützt die Standard -Blockattribute.
`h5`	Überschrift der Stufe 5	Unterstützt die Standard -Blockattribute.
`h6`	Überschrift der Ebene 6	Unterstützt die Standard -Blockattribute.
`head`	Dokumentkopf
`hr`	Horizontale Linie	Unterstützt das Attribut „ `width` “, das als absoluter oder relativer Wert (`%`) angegeben werden kann.
`html`	HTML-Dokument
`i`	Kursiv
`img`	Bild	Unterstützt die Attribute „ `src` “, „ `width` “, „ `height` “, „ `style` “, „ `alt` “ und „ `title` “.
`kbd`	Vom Benutzer eingegebener Text
`meta`	Metainformationen	Wenn eine Textkodierung mithilfe des Tags „ `meta` “ angegeben wird, wird diese von Qt::codecForHtml() übernommen. Ebenso wird, wenn eine Kodierung für „ QTextDocument::toHtml()“ angegeben wird, die Kodierung mithilfe eines „ `meta` “-Tags gespeichert, zum Beispiel: `<meta http-equiv="Content-Type" content="text/html; charset=EUC-JP" />`
`li`	Listenelement
`nobr`	Nicht umbrechbarer Text
`ol`	Nummerierte Liste	Unterstützt die Standard -Listenattribute.
`p`	Absatz	Standardmäßig linksbündig. Unterstützt die Standard-Blockattribute.
`pre`	Vorgeformter Text
`qt`	Qt-Rich-Text-Dokument	Synonym für „ `html` “. Wird aus Kompatibilitätsgründen mit früheren Versionen von Qt bereitgestellt.
`s`	Durchgestrichen
`samp`	Beispielcode	Entspricht „ `tt` “.
`small`	Kleine Schrift
`span`	Gruppierte Elemente
`strong`	Fett	Wie unter `b` beschrieben.
`sub`	Tiefgestellt
`sup`	Hoch
`table`	Tabelle	Unterstützt die folgenden Attribute: `border`, `bgcolor` (Qt color names oder `#RRGGBB`), `cellspacing`, `cellpadding`, `width` (absolut oder relativ) und `height`.
`tbody`	Tabelleninhalt	Hat keine Funktion.
`td`	Tabellendatenzelle	Unterstützt die Standardattribute für Tabellenzellen.
`tfoot`	Tabellenfußzeile	Hat keine Funktion.
`th`	Tabellenkopfzelle	Unterstützt die Standardattribute für Tabellenzellen.
`thead`	Tabellenkopf	Wenn das Tag „ `thead` “ angegeben ist, wird es beim Drucken von Tabellen verwendet, die sich über mehrere Seiten erstrecken.
`title`	Dokumenttitel	Der mit dem Tag ` `title` ` angegebene Wert ist über ` QTextDocument::metaInformation()` verfügbar.
`tr`	Tabellenzeile	Unterstützt das Attribut „ `bgcolor` “, das eine Qt- color name - oder eine „ `#RRGGBB` “-Farbspezifikation sein kann.
`tt`	Schreibmaschinenschrift
`u`	Unterstrichen
`ul`	Ungeordnete Liste	Unterstützt die Standard -Listenattribute.
`var`	Variabel	Wie bei „ `i` “.

Blockattribute

Die folgenden Attribute werden von den Tags „ div “, „ dl “, „ dt “, „ h1 “, „ h2 “, „ h3 “, „ h4 “, „ h5 “, „ h6 “ und „ p “ unterstützt:

align (left, right, center, justify)
dir (ltr, rtl)

Listenattribute

Das folgende Attribut wird von den Tags „ ol “ und „ ul “ unterstützt:

type (1, a, A, square, disc, circle)

Darüber hinaus wird das folgende Attribut vom Tag „ ol “ unterstützt:

start

Tabellenzellenattribute

Die folgenden Attribute werden von den Tags „ td “ und „ th “ unterstützt:

width (absolut, relativ oder kein Wert)
bgcolor color names (Qt XML-ph-0000@deepl.internal oder ) #RRGGBB
colspan
rowspan
align (left, right, center, justify)
valign (top, middle, bottom)

CSS-Eigenschaften

Die folgende Tabelle listet die von der Rich-Text -Engine von Qt unterstützten CSS-Eigenschaften auf:

Eigenschaft	Werte	Beschreibung
`background-color`	<color>	Hintergrundfarbe für Elemente
`background-image`	<uri>	Hintergrundbild für Elemente
`color`	<color>	Text-Vordergrundfarbe
`font-family`	<Schriftfamilienname>	Name der Schriftfamilie
`font-size`	[ klein \| mittel \| groß \| extra groß \| sehr groß ] \| <Größe>pt \| <Größe>px	Schriftgröße relativ zur Dokumentschriftart oder angegeben in Punkten oder Pixeln
`font-style`	[ normal \| kursiv \| schräg ]
`font-weight`	[ normal \| fett \| 100 \| 200 \| 300 \| 400 \| 500 \| 600 \| 700 \| 800 \| 900 ]	Gibt die für den Text verwendete Schriftstärke an, wobei „ `normal` “ und „ `bold` “ den entsprechenden „ QFont “-Stärken zugeordnet sind. Numerische Werte entsprechen dem 8-fachen der entsprechenden „ QFont “-Stärken.
`text-decoration`	none \| [ underline \|\| overline \|\| line-through ]	Zusätzliche Texteffekte
`font`	[ [ <'font-style'> \|\| <'font-weight'> ]? <'font-size'> <'font-family'> ]	Kurzform-Eigenschaft für Schriftarten
`text-indent`	<length>px	Einrückung der ersten Textzeile in Pixeln
`white-space`	normal \| pre \| nowrap \| pre-wrap	Legt fest, wie Leerzeichen in HTML behandelt werden.
`margin-top`	<length>px	Oberer Absatzrand in Pixeln
`margin-bottom`	<length>px	Unterer Absatzrand in Pixeln
`margin-left`	<length>px	Linker Absatzrand in Pixeln
`margin-right`	<Länge>px	Rechter Absatzrand in Pixeln
`padding-top`	<Länge>px	Oberer Abstand in der Tabellenzelle in Pixeln
`padding-bottom`	<Länge>px	Untenränder der Tabellenzellen in Pixeln
`padding-left`	<Länge>px	Abstand links in der Tabellenzelle in Pixeln
`padding-right`	<Länge>px	Abstand rechts in der Tabellenzelle in Pixeln
`padding`	<Länge>px	Kurzschreibweise zum gleichzeitigen Festlegen aller Abstands-Eigenschaften.
`vertical-align`	baseline \| sub \| super \| middle \| top \| bottom	Vertikale Textausrichtung. Für die vertikale Ausrichtung in Texttabellenzellen gelten nur „middle“, „top“ und „bottom“.
`border-collapse`	collapse \| separate	Modus für das Zusammenziehen von Rahmen bei Texttabellen. Bei der Einstellung „collapse“ wird kein Zellenabstand angewendet.
`border-color`	<Farbe>	Rahmenfarbe für Texttabellen und Tabellenzellen.
`border-top-color`	<Farbe>	Farbe des oberen Rahmens für Tabellenzellen.
`border-bottom-color`	<color>	Farbe des unteren Rahmens für Tabellenzellen.
`border-left-color`	<Farbe>	Farbe des linken Rahmens für Tabellenzellen.
`border-right-color`	<color>	Farbe des rechten Rahmens für Tabellenzellen.
`border-style`	none \| dotted \| dashed \| dot-dash \| dot-dot-dash \| solid \| double \| groove \| ridge \| inset \| outset	Rahmenstil für Texttabellen und Tabellenzellen.
`border-top-style`	<border-style>	Stil des oberen Rahmens für Tabellenzellen.
`border-bottom-style`	<border-style>	Stil der unteren Rahmenlinie für Tabellenzellen.
`border-left-style`	<border-style>	Stil des linken Rahmens für Tabellenzellen.
`border-right-style`	<border-style>	Stil des rechten Rahmens für Tabellenzellen.
`border-width`	<width>px	Breite des Tabellen- oder Zellrandes
`border-top-width`	<length>px	Breite des oberen Rahmens für Tabellenzellen.
`border-bottom-width`	<length>px	Breite des unteren Rahmens für Tabellenzellen.
`border-left-width`	<Länge>px	Breite des linken Rahmens für Tabellenzellen.
`border-right-width`	<Länge>px	Breite des rechten Rahmens für Tabellenzellen.
`border-top`	<Breite>px <Rahmenstil> <Rahmenfarbe>	Kurzschreibweise zum Festlegen von Breite, Stil und Farbe des oberen Rahmens
`border-bottom`	<Breite>px <Rahmenstil> <Rahmenfarbe>	Kurzschreibweise zum Festlegen von Breite, Stil und Farbe des unteren Rahmens
`border-left`	<Breite>px <Rahmenstil> <Rahmenfarbe>	Kurzschreibweise zur Festlegung von Breite, Stil und Farbe des linken Rahmens
`border-right`	<Breite>px <Rahmenstil> <Rahmenfarbe>	Kurzschreibweise zur Festlegung von Breite, Stil und Farbe des rechten Rahmens
`border-top`	<Breite>px <Rahmenstil> <Rahmenfarbe>	Kurzschreibweise zur Festlegung von Breite, Stil und Farbe des oberen Rahmens
`border-bottom`	<Breite>px <Rahmenstil> <Rahmenfarbe>	Kurzschreibweise zur Festlegung von Breite, Stil und Farbe des unteren Rahmens
`border`	<Breite>px <Rahmenstil> <Rahmenfarbe>	Kurzschreibweise zum Festlegen von Breite, Stil und Farbe aller vier Rahmen
`background`	[ <'background-color'> \|\| <'background-image'> ]	Kurzform-Eigenschaft für den Hintergrund
`page-break-before`	[ auto \| always ]	Ermöglicht es, einen Seitenumbruch vor dem Absatz/der Tabelle zu erzwingen
`page-break-after`	[ auto \| always ]	Ermöglicht das Erzwingen eines Seitenumbruchs nach dem Absatz/der Tabelle
`float`	[ left \| right \| none ]	Legt fest, wo ein Bild oder ein Text in einem anderen Element platziert wird. Beachten Sie, dass die Eigenschaft „ `float` “ nur für Tabellen und Bilder unterstützt wird.
`text-transform`	[ Großbuchstaben \| Kleinbuchstaben ]	Wählen Sie die Transformation aus, die vor der Anzeige auf den Text angewendet werden soll.
`font-kerning`	[ normal \| keine ]	Aktiviert oder deaktiviert das Kerning zwischen Textzeichen.
`font-variant`	small-caps	Führt vor der Anzeige die Small-Caps-Transformation auf den Text an.
`word-spacing`	<Breite>px	Legt einen alternativen Abstand zwischen den einzelnen Wörtern fest.
`line-height`	<Zahl>[% \| px \| pt \| cm]	Legt die Höhe einer Zeile fest. Es kann einer der folgenden Werte sein: feste Zeilenhöhe in Pixeln, Punkten oder Zentimetern. ein Prozentsatz der aktuellen Schriftgröße.

Hinweis: Bestimmte CSS-Eigenschaften werden nur unterstützt, wenn sie auf ein Block-Tag angewendet werden, wie z. B. . Werden diese Eigenschaften beispielsweise auf ein  gesetzt, hat dies keine Auswirkung. Der Rand (margin) ist ein Beispiel für eine solche Eigenschaft. Eine Übersicht über die Formatierungsoptionen, die für Blöcke und Spans in QTextDocument verfügbar sind, finden Sie unter QTextBlockFormat und QTextCharFormat.

Qt-spezifische CSS-Eigenschaften

Neben den zuvor aufgeführten Standard-CSS-Eigenschaften können auch die folgenden Qt-spezifischen Eigenschaften zur Gestaltung eines Textblocks verwendet werden:

Eigenschaft	Werte	Beschreibung
`-qt-block-indent`	`<number>`	Rückt den Textblock um die angegebene Anzahl von Leerzeichen ein.
`-qt-list-indent`	`<number>`	Rückt die Listenelemente um die angegebene Anzahl von Leerzeichen ein.
`-qt-list-number-prefix`	`<string>`	Fügt der Listenzahl in einer HTML-Aufzählungsliste die angegebene Zeichenfolge als Präfix hinzu.
`-qt-list-number-suffix`	<Zeichenkette>	Fügt die angegebene Zeichenfolge an die Listennummer in einer HTML-Aufzählungsliste an.
`-qt-paragraph-type`	`empty`	Blendet den Textblock aus.
`-qt-table-type`	`root \| frame`	`root` Rendert die Textblöcke inline ohne Rahmen und Einrückung, während `frame` sie in einer neuen Zeile mit einem Rahmen darum rendert.
`-qt-user-state`	`<number>`	Fügt sie als Benutzerdaten für den Textblock hinzu.

Unterstützte CSS-Selektoren

Alle CSS-2.1-Selektor-Klassen werden unterstützt, mit Ausnahme von Pseudoklassen-Selektoren wie :first-child, :visited und :hover.

Erweiterte Rich-Text-Verarbeitung Rich-Text-Verarbeitungs-APIs

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.