Unterstützte HTML-Untermenge

Die Text-Widgets von Qt können Rich-Text anzeigen, der mit einer Teilmenge von HTML 4-Markup angegeben wird. Widgets, die QTextDocument verwenden, wie z.B. QLabel und QTextEdit, sind in der Lage, auf diese Weise spezifizierten Rich-Text anzuzeigen.

Verwendung von HTML-Markup in Text-Widgets

Widgets erkennen automatisch HTML-Auszeichnungen und zeigen Rich-Text entsprechend an. Wenn Sie zum Beispiel die Eigenschaft text eines Labels mit der Zeichenkette "<b>Hello</b> <i>Qt!</i>" festlegen, wird das Label folgenden Text anzeigen: Hallo Qt!

Wenn HTML-Markup für Text verwendet wird, folgt Qt den Regeln, die in der HTML 4-Spezifikation definiert sind. Dies beinhaltet Standardeigenschaften für das Textlayout, wie die Richtung des Textflusses (von links nach rechts), die durch die Anwendung 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. Nicht alle Attribute werden unterstützt, siehe Kommentare zu den einzelnen Tags.

TagBeschreibungKommentar
aAnker oder LinkUnterstützt die Attribute href und name.
addressAdresse
bFettschrift
bigGrößere Schrift
blockquoteEingerückter Absatz
bodyDokumentkörperUnterstützt das Attribut bgcolor, das eine Qt color name oder eine #RRGGBB Farbspezifikation sein kann.
brZeilenumbruch
centerZentrierter Absatz
citeInline-ZitatGleich wie i.
codeCodeWie tt.
ddDefinitionsdaten
dfnDefinitionWie i.
divDokumententeilungUnterstützt die Standard-Blockattribute.
dlDefinitionslisteUnterstützt die Standard-Blockattribute.
dtDefinition BegriffUnterstützt die Standard-Blockattribute.
emHervorgehobenDasselbe wie i.
fontSchriftgröße, -familie und/oder -farbeUnterstützt die folgenden Attribute: size, face, und color (Qt color names oder #RRGGBB).
h1Level 1 ÜberschriftUnterstützt die Standard-Blockattribute.
h2Level 2 ÜberschriftUnterstützt die Standard-Blockattribute.
h3Level 3 ÜberschriftUnterstützt die Standard-Blockattribute.
h4Level 4 ÜberschriftUnterstützt die Standard-Blockattribute.
h5Level 5 ÜberschriftUnterstützt die Standard-Blockattribute.
h6Stufe 6 ÜberschriftUnterstützt die Standard-Blockattribute.
headDokumentenkopf
hrHorizontale LinieUnterstützt das Attribut width, das als absoluter oder relativer Wert (%) angegeben werden kann.
htmlHTML-Dokument
iKursiv
imgBildUnterstützt die Attribute src, source (für Qt 3 Kompatibilität), width und height.
kbdVom Benutzer eingegebener Text
metaMeta-InformationenWenn eine Textkodierung mit dem meta Tag angegeben wird, wird sie von Qt::codecForHtml() übernommen. Wenn eine Kodierung mit QTextDocument::toHtml() angegeben wird, wird die Kodierung z. B. mit dem Tag meta gespeichert: <meta http-equiv="Content-Type" content="text/html; charset=EUC-JP" />
liListenelement
nobrUnzerbrechlicher Text
olGeordnete ListeUnterstützt die Standard-Listenattribute.
pAbsatzStandardmäßig linksbündig. Unterstützt die Standard-Blockattribute.
preVorformatierter Text
qtQt-Rich-Text-DokumentSynonym für html. Wird aus Kompatibilitätsgründen mit früheren Qt-Versionen bereitgestellt.
sDurchgestrichen
sampBeispiel-CodeGleich wie tt.
smallKleine Schrift
spanGruppierte Elemente
strongStarkWie b.
subTiefgestellt
supHochgestellt
tableTabelleUnterstützt die folgenden Attribute: border, bgcolor (Qt color names oder #RRGGBB), cellspacing, cellpadding, width (absolut oder relativ), und height.
tbodyTabellenkörperMacht nichts.
tdTabelle DatenzelleUnterstützt die Standardattribute für Tabellenzellen.
tfootTabelle FußzeileFührt nichts aus.
thTabellenkopfzelleUnterstützt die Standardattribute für Tabellenzellen.
theadTabellenkopfWenn das Tag thead angegeben ist, wird es beim Drucken von Tabellen verwendet, die sich über mehrere Seiten erstrecken.
titleDokumententitelDer mit dem Tag title angegebene Wert ist über QTextDocument::metaInformation() verfügbar.
trTabellenzeileUnterstützt das bgcolor -Attribut, das eine Qt color name - oder eine #RRGGBB -Farbspezifikation sein kann.
ttTypewrite-Schriftart
uUnterstrichen
ulUngeordnete ListeUnterstützt die Standard-Listenattribute.
varVariableDasselbe wie i.

Block-Attribute

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

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

Listen-Attribute

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

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

Tabellenzellen-Attribute

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

  • width (absolut, relativ, oder kein Wert)
  • bgcolor (Qt color names oder #RRGGBB)
  • colspan
  • rowspan
  • align (left, right, center, justify)
  • valign (top, middle, bottom)

CSS-Eigenschaften

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

EigenschaftWerteBeschreibung
background-color<Farbe>Hintergrundfarbe für Elemente
background-image<uri>Hintergrundbild für Elemente
color<color>Textvordergrundfarbe
font-family<Familienname>Name der Schriftfamilie
font-size[ klein | mittel | groß | x-groß | xx-groß ] | <size>pt | <size>pxSchriftgröße relativ zur Dokumentschrift, oder angegeben in Punkt oder Pixel
font-style[ normal | kursiv | schräg ]
font-weight[ normal | fett | 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900 ]Gibt die für Text verwendete Schriftstärke an, wobei normal und bold auf die entsprechenden QFont Schriftstärken abgebildet werden. Numerische Werte sind das 8-fache der entsprechenden QFont Gewichtswerte.
text-decorationnone | [ underline || overline || line-through ]Zusätzliche Texteffekte
font[ [ [ <'font-style'> || <'font-weight'> ]? <'font-size'> <'font-family'> ]Shorthand-Eigenschaft der Schriftart
text-indent<Länge>pxTexteinzug der ersten Zeile in Pixel
white-spacenormal | pre | nowrap | pre-wrapLegt fest, wie Leerraum in HTML behandelt wird.
margin-top<Länge>pxOberer Absatzrand in Pixeln
margin-bottom<Länge>pxUnterer Absatzrand in Pixeln
margin-left<Länge>pxLinker Absatzrand in Pixeln
margin-right<Länge>pxRechter Absatzrand in Pixeln
padding-top<Länge>pxFüllung der oberen Tabellenzelle in Pixeln
padding-bottom<Länge>pxFüllung der unteren Tabellenzelle in Pixeln
padding-left<Länge>pxFüllung der linken Tabellenzelle in Pixeln
padding-right<Länge>pxFüllung der rechten Tabellenzelle in Pixeln
padding<Länge>pxKurzform für die Einstellung aller Padding-Eigenschaften auf einmal.
vertical-alignbaseline | sub | super | middle | top | bottomVertikale Textausrichtung. Für die vertikale Ausrichtung in Texttabellenzellen gelten nur Mitte, oben und unten.
border-collapsekollabieren | trennenModus für das Zusammenklappen des Rahmens bei Texttabellen. Bei der Einstellung collapse werden die Zellenabstände nicht angewendet.
border-color<Farbe>Farbe des Rahmens für Texttabellen und Tabellenzellen.
border-top-color<Farbe>Farbe des oberen Rahmens für Tabellenzellen.
border-bottom-color<Farbe>Farbe des unteren Randes für Tabellenzellen.
border-left-color<Farbe>Farbe des linken Rahmens für Tabellenzellen.
border-right-color<Farbe>Farbe des rechten Rahmens für Tabellenzellen.
border-stylekeine | gepunktet | gestrichelt | punktiert | punktiert-gestrichelt | punktiert-gestrichelt | vollflächig | doppelt | Rille | Steg | eingefügt | abgesetztUmrandungsstil für Texttabellen und Tabellenzellen.
border-top-style<border-style>Oberer Rahmenstil für Tabellenzellen.
border-bottom-style<border-style>Unterer Rahmenstil für Tabellenzellen.
border-left-style<border-style>Linker Rahmenstil für Tabellenzellen.
border-right-style<border-style>Stil für den rechten Rand von Tabellenzellen.
border-width<Breite>pxBreite des Rahmens der Tabelle oder Zelle
border-top-width<Länge>pxBreite des oberen Rahmens für Tabellenzellen.
border-bottom-width<Länge>pxBreite des unteren Randes für Tabellenzellen.
border-left-width<Länge>pxLinke Randbreite für Tabellenzellen.
border-right-width<Länge>pxBreite des rechten Randes für Tabellenzellen.
border-top<width>px <border-style> <border-color>Kurzzeichen für die Einstellung von Breite, Stil und Farbe des oberen Rahmens
border-bottom<width>px <border-style> <border-color>Kurzzeichen für die Einstellung von Breite, Stil und Farbe des unteren Rahmens
border-left<Breite>px <Bordüren-Stil> <Bordüren-Farbe>Kurzzeichen für die Einstellung von Breite, Stil und Farbe des linken Randes
border-right<Breite>px <Bordüren-Stil> <Bordüren-Farbe>Kurzzeichen für die Einstellung von Breite, Stil und Farbe des rechten Rahmens
border-top<Breite>px <Bordüren-Stil> <Bordüren-Farbe>Kurzzeichen für die Einstellung von Breite, Stil und Farbe des oberen Rahmens
border-bottom<Breite>px <Bordüren-Stil> <Bordüren-Farbe>Kurzzeichen für die Einstellung von Breite, Stil und Farbe des unteren Rahmens
border<Breite>px <Rahmen-Stil> <Rahmen-Farbe>Kurzzeichen für die Einstellung der Breite, des Stils und der Farbe für alle vier Ränder
background[ <'background-color'> || <'background-image'> ]Shorthand-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 es, einen Seitenumbruch nach dem Absatz/der Tabelle zu erzwingen
float[ links | rechts | keine ]Gibt an, wo ein Bild oder ein Text in einem anderen Element platziert werden soll. Beachten Sie, dass die Eigenschaft float nur für Tabellen und Bilder unterstützt wird.
text-transform[ Großbuchstaben | Kleinbuchstaben ]Legt fest, wie der Text vor der Anzeige umgewandelt werden soll.
font-kerning[ normal | keine ]Aktiviert oder deaktiviert das Kerning zwischen Textzeichen.
font-variantkleingeschriebenFührt die Smallcaps-Transformation für den Text durch, bevor er angezeigt wird.
word-spacing<Breite>pxLegt einen alternativen Abstand zwischen den einzelnen Wörtern fest.
line-height<Zahl>[% | px | pt | cm]Legt die Höhe einer Zeile fest. Sie kann eine der folgenden Angaben sein:
  • eine feste Zeilenhöhe in Pixeln, Punkten oder Zentimetern.
  • ein Prozentsatz der aktuellen Schriftgröße.

Qt-spezifische CSS-Eigenschaften

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

EigenschaftWerteBeschreibung
-qt-block-indent<number>Richtet 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>Stellt die angegebene Zeichenkette der Listennummer in einer geordneten HTML-Liste voran.
-qt-list-number-suffix<Zeichenkette>Suffixiert die angegebene Zeichenfolge an die Listennummer in einer geordneten HTML-Liste.
-qt-paragraph-typeemptyBlendet den Textblock aus.
-qt-table-typeroot | frameroot gibt die Textblöcke inline ohne Rahmen und Einrückung aus, während frame sie in einer neuen Zeile mit einem Rahmen ausgibt.
-qt-user-state<number>Fügt sie als Benutzerdaten für den Textblock hinzu.

Unterstützte CSS-Selektoren

Es werden alle CSS 2.1-Selektorklassen unterstützt, mit Ausnahme von Pseudoklassen-Selektoren wie :first-child, :visited und :hover.

© 2025 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.