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.
| Tag | Beschreibung | Kommentar |
|---|---|---|
a | Anker oder Link | Unterstützt die Attribute href und name. |
address | Adresse | |
b | Fettschrift | |
big | Größere Schrift | |
blockquote | Eingerückter Absatz | |
body | Dokumentkörper | Unterstützt das Attribut bgcolor, das eine Qt color name oder eine #RRGGBB Farbspezifikation sein kann. |
br | Zeilenumbruch | |
center | Zentrierter Absatz | |
cite | Inline-Zitat | Gleich wie i. |
code | Code | Wie tt. |
dd | Definitionsdaten | |
dfn | Definition | Wie i. |
div | Dokumententeilung | Unterstützt die Standard-Blockattribute. |
dl | Definitionsliste | Unterstützt die Standard-Blockattribute. |
dt | Definition Begriff | Unterstützt die Standard-Blockattribute. |
em | Hervorgehoben | Dasselbe wie i. |
font | Schriftgröße, -familie und/oder -farbe | Unterstützt die folgenden Attribute: size, face, und color (Qt color names oder #RRGGBB). |
h1 | Level 1 Überschrift | Unterstützt die Standard-Blockattribute. |
h2 | Level 2 Überschrift | Unterstützt die Standard-Blockattribute. |
h3 | Level 3 Überschrift | Unterstützt die Standard-Blockattribute. |
h4 | Level 4 Überschrift | Unterstützt die Standard-Blockattribute. |
h5 | Level 5 Überschrift | Unterstützt die Standard-Blockattribute. |
h6 | Stufe 6 Überschrift | Unterstützt die Standard-Blockattribute. |
head | Dokumentenkopf | |
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, source (für Qt 3 Kompatibilität), width und height. |
kbd | Vom Benutzer eingegebener Text | |
meta | Meta-Informationen | Wenn 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" /> |
li | Listenelement | |
nobr | Unzerbrechlicher Text | |
ol | Geordnete Liste | Unterstützt die Standard-Listenattribute. |
p | Absatz | Standardmäßig linksbündig. Unterstützt die Standard-Blockattribute. |
pre | Vorformatierter Text | |
qt | Qt-Rich-Text-Dokument | Synonym für html. Wird aus Kompatibilitätsgründen mit früheren Qt-Versionen bereitgestellt. |
s | Durchgestrichen | |
samp | Beispiel-Code | Gleich wie tt. |
small | Kleine Schrift | |
span | Gruppierte Elemente | |
strong | Stark | Wie b. |
sub | Tiefgestellt | |
sup | Hochgestellt | |
table | Tabelle | Unterstützt die folgenden Attribute: border, bgcolor (Qt color names oder #RRGGBB), cellspacing, cellpadding, width (absolut oder relativ), und height. |
tbody | Tabellenkörper | Macht nichts. |
td | Tabelle Datenzelle | Unterstützt die Standardattribute für Tabellenzellen. |
tfoot | Tabelle Fußzeile | Führt nichts aus. |
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 | Dokumententitel | Der mit dem Tag title angegebene Wert ist über QTextDocument::metaInformation() verfügbar. |
tr | Tabellenzeile | Unterstützt das bgcolor -Attribut, das eine Qt color name - oder eine #RRGGBB -Farbspezifikation sein kann. |
tt | Typewrite-Schriftart | |
u | Unterstrichen | |
ul | Ungeordnete Liste | Unterstützt die Standard-Listenattribute. |
var | Variable | Dasselbe 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)colspanrowspanalign(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:
| Eigenschaft | Werte | Beschreibung |
|---|---|---|
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>px | Schriftgröß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-decoration | none | [ underline || overline || line-through ] | Zusätzliche Texteffekte |
font | [ [ [ <'font-style'> || <'font-weight'> ]? <'font-size'> <'font-family'> ] | Shorthand-Eigenschaft der Schriftart |
text-indent | <Länge>px | Texteinzug der ersten Zeile in Pixel |
white-space | normal | pre | nowrap | pre-wrap | Legt fest, wie Leerraum in HTML behandelt wird. |
margin-top | <Länge>px | Oberer Absatzrand in Pixeln |
margin-bottom | <Länge>px | Unterer Absatzrand in Pixeln |
margin-left | <Länge>px | Linker Absatzrand in Pixeln |
margin-right | <Länge>px | Rechter Absatzrand in Pixeln |
padding-top | <Länge>px | Füllung der oberen Tabellenzelle in Pixeln |
padding-bottom | <Länge>px | Füllung der unteren Tabellenzelle in Pixeln |
padding-left | <Länge>px | Füllung der linken Tabellenzelle in Pixeln |
padding-right | <Länge>px | Füllung der rechten Tabellenzelle in Pixeln |
padding | <Länge>px | Kurzform für die Einstellung aller Padding-Eigenschaften auf einmal. |
vertical-align | baseline | sub | super | middle | top | bottom | Vertikale Textausrichtung. Für die vertikale Ausrichtung in Texttabellenzellen gelten nur Mitte, oben und unten. |
border-collapse | kollabieren | trennen | Modus 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-style | keine | gepunktet | gestrichelt | punktiert | punktiert-gestrichelt | punktiert-gestrichelt | vollflächig | doppelt | Rille | Steg | eingefügt | abgesetzt | Umrandungsstil 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>px | Breite des Rahmens der Tabelle oder Zelle |
border-top-width | <Länge>px | Breite des oberen Rahmens für Tabellenzellen. |
border-bottom-width | <Länge>px | Breite des unteren Randes für Tabellenzellen. |
border-left-width | <Länge>px | Linke Randbreite für Tabellenzellen. |
border-right-width | <Länge>px | Breite 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-variant | kleingeschrieben | Führt die Smallcaps-Transformation für den Text durch, bevor er angezeigt wird. |
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. Sie kann eine der folgenden Angaben sein:
|
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:
| Eigenschaft | Werte | Beschreibung |
|---|---|---|
-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-type | empty | Blendet den Textblock aus. |
-qt-table-type | root | frame | root 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.
