Anzeige von Text
Zur Anzeige von Text wird der Typ „Text“ vom Qt Quick Modul bereitgestellt. Für ähnliche Anwendungsfälle bieten die Typen „ TextInput “ und „ TextEdit “ bearbeitbare Text-Steuerelemente. Für vollständiges HTML-Markup siehe das Modul „ Qt WebEngine “.
Anzeigen und Formatieren von Text
Um Text in QML anzuzeigen, erstellen Sie ein „Text“-Element und setzen Sie die Eigenschaft „text“ auf den Text, den Sie anzeigen möchten. Das „Text“-Element zeigt nun diesen Text an.
Für das „Text“-Element können verschiedene Eigenschaften festgelegt werden, um den gesamten Textblock zu formatieren. Dazu gehören Farbe, Schriftart, Schriftgröße, Fettdruck und Kursivschrift. Eine vollständige Liste der Eigenschaften finden Sie in der Dokumentation zum Typ „ Text “.
Rich-Text-Markup kann verwendet werden, um bestimmte Textabschnitte eines „Text“-Elements gezielt zu gestalten. Setzen Sie „ Text::textFormat “ auf „Text.StyledText“, um diese Funktion zu nutzen. Weitere Details finden Sie in der Dokumentation zum Typ „ Text “.
Textlayout
Standardmäßig zeigt „Text“ den Text als einzelne Zeile an, sofern er keine eingebetteten Zeilenumbrüche enthält. Um den Text umbrechen zu lassen, legen Sie die Eigenschaft „wrapMode“ fest und weisen Sie dem Text eine explizite Breite zu, bei deren Erreichen der Zeilenumbruch erfolgen soll. Wenn die Breite oder Höhe nicht explizit festgelegt ist, geben diese Eigenschaften die Parameter des Begrenzungsrechtecks des Texts zurück (wenn Sie Breite oder Höhe explizit festgelegt haben, können Sie weiterhin `paintedWidth` und `paintedHeight` verwenden). Unter Berücksichtigung dieser Parameter kann das `Text`-Element wie jedes andere `Item` positioniert werden.
Beispielcode
import QtQuick
Item {
id: root
width: 480
height: 320
Rectangle {
color: "#272822"
width: 480
height: 320
}
Column {
spacing: 20
Text {
text: 'I am the very model of a modern major general!'
// color can be set on the entire element with this property
color: "yellow"
}
Text {
// For text to wrap, a width has to be explicitly provided
width: root.width
// This setting makes the text wrap at word boundaries when it goes
// past the width of the Text object
wrapMode: Text.WordWrap
// You can use \ to escape quotation marks, or to add new lines (\n).
// Use \\ to get a \ in the string
text: 'I am the very model of a modern major general. I\'ve information \
vegetable, animal and mineral. I know the kings of england and I \
quote the fights historical; from Marathon to Waterloo in order categorical.'
// color can be set on the entire element with this property
color: "white"
}
Text {
text: 'I am the very model of a modern major general!'
// color can be set on the entire element with this property
color: "yellow"
// font properties can be set effciently on the whole string at once
font { family: 'Courier'; pixelSize: 20; italic: true; capitalization: Font.SmallCaps }
}
Text {
// HTML like markup can also be used
text: '<font color="white">I am the <b>very</b> model of a modern <i>major general</i>!</font>'
// This could also be written font { pointSize: 14 }. Both syntaxes are valid.
font.pointSize: 14
// StyledText format supports fewer tags, but is more efficient than RichText
textFormat: Text.StyledText
}
}
}
Internationalisierung und Skalierbarkeit
Beim Umgang mit Texten müssen Anwendungen verschiedene Aspekte berücksichtigen, wie beispielsweise die Ausrichtung des Geräts und die Spracheinstellungen.
Auf den folgenden Seiten werden diese verschiedenen Aspekte näher erläutert.
© 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.