Auf dieser Seite

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
        }
    }
}

Text, der in verschiedenen Stilen angezeigt wird, darunter Überschrift, Fließtext und Kursivschrift

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.