TextEdit QML Type

Zeigt mehrere Zeilen editierbaren, formatierten Text an. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• activeFocusOnPress : bool
• baseUrl : url
• bottomPadding : real
• canPaste : bool
• canRedo : bool
• canUndo : bool
• color : color
• contentHeight : real
• contentWidth : real
• cursorDelegate : Component
• cursorPosition : int
• cursorRectangle : rectangle
• cursorSelection : QtQuick::TextSelection (preliminary)
• cursorVisible : bool
• effectiveHorizontalAlignment : enumeration
• font.bold : bool
• font.capitalization : enumeration
• font.contextFontMerging : bool (since 6.8)
• font.family : string
• font.features : object (since 6.6)
• font.hintingPreference : enumeration
• font.italic : bool
• font.kerning : bool
• font.letterSpacing : real
• font.pixelSize : int
• font.pointSize : real
• font.preferShaping : bool
• font.preferTypoLineMetrics : bool (since 6.8)
• font.strikeout : bool
• font.styleName : string
• font.underline : bool
• font.variableAxes : object (since 6.7)
• font.weight : int
• font.wordSpacing : real
• horizontalAlignment : enumeration
• hoveredLink : string
• inputMethodComposing : bool
• inputMethodHints : enumeration
• leftPadding : real
• length : int
• lineCount : int
• mouseSelectionMode : enumeration
• overwriteMode : bool
• padding : real
• persistentSelection : bool
• preeditText : string
• readOnly : bool
• renderType : enumeration
• rightPadding : real
• selectByKeyboard : bool
• selectByMouse : bool
• selectedText : string
• selectedTextColor : color
• selectionColor : color
• selectionEnd : int
• selectionStart : int
• tabStopDistance : real
• text : string
• textDocument : TextDocument
• textFormat : enumeration
• textMargin : real
• topPadding : real
• verticalAlignment : enumeration
• wrapMode : enumeration

Signale

• editingFinished()
• linkActivated(string link)
• linkHovered(string link)
• textEdited() (since 6.9)

Methoden

• void append(string text)
• void clear()
• void copy()
• void cut()
• void deselect()
• string getFormattedText(int start, int end)
• string getText(int start, int end)
• void insert(int position, string text)
• bool isRightToLeft(int start, int end)
• string linkAt(real x, real y)
• void moveCursorSelection(int position, SelectionMode mode)
• void paste()
• int positionAt(int x, int y)
• rectangle positionToRectangle(position)
• void redo()
• string remove(int start, int end)
• void select(int start, int end)
• void selectAll()
• void selectWord()
• void undo()

Detaillierte Beschreibung

Das TextEdit-Element zeigt einen Block mit editierbarem, formatiertem Text an.

Es kann sowohl einfachen als auch Rich-Text anzeigen. Ein Beispiel:

TextEdit {
    width: 240
    text: "<b>Hello</b> <i>World!</i>"
    font.family: "Helvetica"
    font.pointSize: 20
    color: "blue"
    focus: true
}

Wenn Sie focus auf true setzen, kann das TextEdit-Element den Tastaturfokus erhalten.

Beachten Sie, dass TextEdit keinen Bildlauf, kein Verfolgen des Cursors und keine anderen Verhaltensweisen implementiert, die für ein bestimmtes Look and Feel spezifisch sind. Zum Beispiel, um einen flackernden Bildlauf hinzuzufügen, der dem Cursor folgt:

Flickable {
     id: flick

     width: 300; height: 200;
     contentWidth: edit.contentWidth
     contentHeight: edit.contentHeight
     clip: true

     function ensureVisible(r)
     {
         if (contentX >= r.x)
             contentX = r.x;
         else if (contentX+width <= r.x+r.width)
             contentX = r.x+r.width-width;
         if (contentY >= r.y)
             contentY = r.y;
         else if (contentY+height <= r.y+r.height)
             contentY = r.y+r.height-height;
     }

     TextEdit {
         id: edit
         width: flick.width
         focus: true
         wrapMode: TextEdit.Wrap
         onCursorRectangleChanged: flick.ensureVisible(cursorRectangle)
     }
 }

Ein bestimmtes Look and Feel könnte einen sanften Bildlauf verwenden (z. B. mit SmoothedAnimation), könnte eine sichtbare Bildlaufleiste haben oder eine Bildlaufleiste, die eingeblendet wird, um die Position anzuzeigen, usw.

Die Zwischenablage wird von den Funktionen cut(), copy() und paste() unterstützt. Text kann wie üblich mit der Maus ausgewählt werden, es sei denn, selectByMouse ist auf false gesetzt, und mit der Tastatur mit den Tastenkombinationen Shift+arrow, es sei denn, selectByKeyboard ist auf false gesetzt. Um Text programmatisch auszuwählen, können Sie die Eigenschaften selectionStart und selectionEnd setzen oder selectAll() oder selectWord() verwenden.

Mit positionAt() und positionToRectangle() können Sie zwischen Cursorpositionen (Zeichen vom Dokumentanfang) und Pixelpunkten übersetzen.

Siehe auch Text, TextInput, TextArea, und Qt Quick Steuerelemente - Texteditor.

Dokumentation der Eigenschaften

activeFocusOnPress : bool

Ob die TextEdit bei einem Mausklick den aktiven Fokus erhalten soll. Standardmäßig ist dies auf true gesetzt.

baseUrl : url

Diese Eigenschaft gibt eine Basis-URL an, die zur Auflösung von relativen URLs innerhalb des Textes verwendet wird.

Der Standardwert ist die URL der QML-Datei, die das Element TextEdit instanziiert.

Diese Eigenschaften enthalten die Füllung um den Inhalt. Dieser Platz ist zusätzlich zu contentWidth und contentHeight reserviert.

canPaste : bool [read-only]

Gibt true zurück, wenn die TextEdit beschreibbar ist und der Inhalt der Zwischenablage zum Einfügen in die TextEdit geeignet ist.

canRedo : bool [read-only]

Gibt true zurück, wenn TextEdit beschreibbar ist und es undone Operationen gibt, die erneut ausgeführt werden können.

canUndo : bool [read-only]

Gibt true zurück, wenn TextEdit beschreibbar ist und frühere Operationen rückgängig gemacht werden können.

color : color

Die Textfarbe.

// green text using hexadecimal notation
TextEdit { color: "#00FF00" }

// steelblue text using SVG color name
TextEdit { color: "steelblue" }

contentHeight : real [read-only]

Gibt die Höhe des Textes zurück, einschließlich der Höhe über der Höhe, die abgedeckt wird, wenn der Text nicht in die eingestellte Höhe passt.

contentWidth : real [read-only]

Gibt die Breite des Textes zurück, einschließlich der Breite über die Breite hinaus, die durch einen unzureichenden Umbruch verdeckt wird, wenn wrapMode gesetzt ist.

cursorDelegate : Component

Der Delegat für den Cursor im TextEdit.

Wenn Sie einen cursorDelegate für eine TextEdit festlegen, wird dieser Delegat zum Zeichnen des Cursors anstelle des Standardcursors verwendet. Eine Instanz des Delegaten wird erstellt und von der Textbearbeitung verwaltet, wenn ein Cursor benötigt wird, und die x- und y-Eigenschaften der Delegateninstanz werden so eingestellt, dass sie ein Pixel vor dem oberen linken Rand des aktuellen Zeichens liegen.

Beachten Sie, dass das Stammelement der Delegatenkomponente ein QQuickItem oder QQuickItem abgeleitetes Element sein muss.

cursorPosition : int

Die Position des Cursors in TextEdit. Der Cursor wird zwischen den Zeichen positioniert.

cursorRectangle : rectangle [read-only]

Das Rechteck, in dem der Standardtextcursor innerhalb der Textbearbeitung dargestellt wird. Schreibgeschützt.

Die Position und Höhe eines benutzerdefinierten cursorDelegate werden automatisch aktualisiert, um dem cursorRectangle zu folgen, wenn es sich ändert. Die Breite des Delegaten wird durch Änderungen des Cursor-Rechtecks nicht beeinflusst.

cursorSelection : QtQuick::TextSelection [read-only, preliminary]

Diese Eigenschaft befindet sich in der Entwicklung und kann geändert werden.

Bei dieser Eigenschaft handelt es sich um ein Objekt, das die Eigenschaften des aktuell ausgewählten Textes, falls vorhanden, neben dem Textcursor bereitstellt.

Diese Eigenschaft wurde in Qt 6.7 eingeführt.

Siehe auch selectedText, selectionStart, und selectionEnd.

cursorVisible : bool

Bei true zeigt die Texteingabe einen Cursor.

Diese Eigenschaft wird gesetzt und aufgehoben, wenn die Texteingabe den aktiven Fokus erhält, aber sie kann auch direkt gesetzt werden (nützlich, zum Beispiel, wenn ein KeyProxy Tasten an sie weiterleiten könnte).

Legt die horizontale und vertikale Ausrichtung des Textes innerhalb der Breite und Höhe des Elements TextEdit fest. Standardmäßig folgt die Textausrichtung der natürlichen Ausrichtung des Textes, z. B. wird Text, der von links nach rechts gelesen wird, links ausgerichtet.

Gültige Werte für horizontalAlignment sind:

Gültige Werte für verticalAlignment sind:

Wenn Sie die angehängte Eigenschaft LayoutMirroring::enabled verwenden, um Anwendungslayouts zu spiegeln, wird auch die horizontale Ausrichtung des Textes gespiegelt. Die Eigenschaft horizontalAlignment bleibt jedoch unverändert. Um die effektive horizontale Ausrichtung von TextEdit abzufragen, verwenden Sie die schreibgeschützte Eigenschaft effectiveHorizontalAlignment.

font.bold : bool

Legt fest, ob der Schriftschnitt fett ist.

font.capitalization : enumeration

Legt die Großschreibung für den Text fest.

TextEdit { text: "Hello"; font.capitalization: Font.AllLowercase }

font.contextFontMerging : bool [since 6.8]

Wenn die ausgewählte Schriftart ein bestimmtes Zeichen nicht enthält, wählt Qt automatisch eine ähnlich aussehende Ersatzschriftart, die das Zeichen enthält. Standardmäßig geschieht dies auf einer Zeichen-für-Zeichen-Basis.

Das bedeutet, dass in einigen ungewöhnlichen Fällen viele verschiedene Schriftarten verwendet werden können, um einen Text zu repräsentieren, auch wenn er im selben Skript steht. Wenn Sie contextFontMerging auf true setzen, wird stattdessen versucht, die Ersatzschriftart zu finden, die der größten Teilmenge der Eingabezeichenkette entspricht. Dies ist teurer für Zeichenketten, in denen Glyphen fehlen, kann aber konsistentere Ergebnisse liefern. Standardmäßig ist contextFontMerging false .

Diese Eigenschaft wurde in Qt 6.8 eingeführt.

Siehe auch QFont::StyleStrategy.

font.family : string

Legt den Familiennamen der Schriftart fest.

Der Familienname unterscheidet nicht zwischen Groß- und Kleinschreibung und kann optional den Namen eines Herstellers enthalten, z. B. "Helvetica [Cronyx]". Wenn die Familie von mehr als einer Gießerei verfügbar ist und die Gießerei nicht angegeben wird, wird eine beliebige Gießerei ausgewählt. Wenn die Familie nicht verfügbar ist, wird eine Familie mit Hilfe des Algorithmus zum Abgleich der Schriften festgelegt.

font.features : object [since 6.6]

Wendet ganzzahlige Werte auf bestimmte OpenType-Merkmale an, wenn der Text basierend auf den Inhalten in features geformt wird. Dies bietet einen erweiterten Zugriff auf den Schriftformungsprozess und kann zur Unterstützung von Schriftmerkmalen verwendet werden, die sonst nicht von der API abgedeckt werden.

Die Schriftmerkmale werden durch eine Zuordnung von Tags mit vier Buchstaben zu Ganzzahlwerten dargestellt. Dieser Integer-Wert, der zusammen mit dem Tag übergeben wird, stellt in den meisten Fällen einen booleschen Wert dar: Ein Nullwert bedeutet, dass die Funktion deaktiviert ist, und ein Wert ungleich Null bedeutet, dass sie aktiviert ist. Bei bestimmten Schriftfunktionen kann er jedoch auch anders interpretiert werden. Bei der Anwendung auf das Merkmal salt ist der Wert beispielsweise ein Index, der die zu verwendende stilistische Alternative angibt.

Das Schriftmerkmal frac konvertiert zum Beispiel diagonale Brüche, die durch einen Schrägstrich getrennt sind (wie 1/2), in eine andere Darstellung. In der Regel wird dabei der gesamte Bruch in eine einzelne Zeichenbreite umgewandelt (z. B. ½).

Wenn eine Schriftart das Merkmal frac unterstützt, kann es im Shaper wie im folgenden Code aktiviert werden:

Text {
    text: "One divided by two is 1/2"
    font.family: "MyFractionFont"
    font.features: { "frac": 1 }
}

Mehrere Merkmale können in derselben Zuordnung mit Werten belegt werden. Wenn Sie zum Beispiel auch das Kerning für die Schriftart deaktivieren möchten, können Sie dies wie folgt explizit deaktivieren:

Text {
    text: "One divided by two is 1/2"
    font.family: "MyFractionFont"
    font.features: { "frac": 1, "kern": 0 }
}

Sie können die Schrifteigenschaften auch in einem Objekt sammeln:

Text {
    text: "One divided by two is 1/2"
    font: {
        family: "MyFractionFont"
        features: { "frac": 1, "kern": 0 }
    }
}

Diese Eigenschaft wurde in Qt 6.6 eingeführt.

Siehe auch QFont::setFeature().

font.hintingPreference : enumeration

Legt das bevorzugte Hinting für den Text fest. Dies ist ein Hinweis an das zugrundeliegende Textwiedergabesystem, ein bestimmtes Maß an Hinting zu verwenden, und wird von verschiedenen Plattformen unterschiedlich unterstützt. Weitere Einzelheiten finden Sie in der Tabelle in der Dokumentation zu QFont::HintingPreference.

TextEdit { text: "Hello"; renderType: TextEdit.NativeRendering; font.hintingPreference: Font.PreferVerticalHinting }

font.italic : bool

Legt fest, ob die Schrift einen kursiven Stil hat.

font.kerning : bool

Aktiviert oder deaktiviert die Kerning-OpenType-Funktion bei der Gestaltung des Textes. Die Deaktivierung dieser Funktion kann die Leistung beim Erstellen oder Ändern des Textes verbessern, allerdings auf Kosten einiger kosmetischer Merkmale. Der Standardwert ist true.

TextEdit { text: "OATS FLAVOUR WAY"; kerning: font.false }

font.letterSpacing : real

Legt die Buchstabenabstände für die Schriftart fest.

Der Buchstabenabstand ändert den Standardabstand zwischen einzelnen Buchstaben in der Schriftart. Ein positiver Wert vergrößert den Buchstabenabstand um die entsprechenden Pixel, ein negativer Wert verkleinert den Abstand.

font.pixelSize : int

Legt die Schriftgröße in Pixeln fest.

Die Verwendung dieser Funktion macht die Schrift geräteabhängig. Verwenden Sie TextEdit::font.pointSize, um die Größe der Schrift geräteunabhängig einzustellen.

font.pointSize : real

Legt die Schriftgröße in Punkt fest. Die Punktgröße muss größer als Null sein.

font.preferShaping : bool

Manchmal wendet eine Schriftart komplexe Regeln auf eine Reihe von Zeichen an, um sie korrekt darzustellen. In einigen Schriftsystemen, wie z. B. den brahmanischen Schriften, ist dies für die Lesbarkeit des Textes erforderlich, aber z. B. in der lateinischen Schrift ist es lediglich ein kosmetisches Merkmal. Wenn Sie die Eigenschaft preferShaping auf false setzen, werden alle diese Funktionen deaktiviert, wenn sie nicht benötigt werden, was in den meisten Fällen die Leistung verbessert.

Der Standardwert ist true.

TextEdit { text: "Some text"; font.preferShaping: false }

font.preferTypoLineMetrics : bool [since 6.8]

konkurrierende Sätze der vertikalen Linienmetriken, die die ascent, descent und leading der Schriftart liefern. Diese werden oft als win (Windows)-Metriken und typo (typografische) Metriken bezeichnet. Obwohl die Spezifikation die Verwendung der typo -Metriken für den Zeilenabstand empfiehlt, bevorzugen viele Anwendungen die win -Metriken, es sei denn, das USE_TYPO_METRICS -Flag ist im fsSelection-Feld der Schriftart gesetzt. Aus Gründen der Rückwärtskompatibilität ist dies auch bei Qt-Anwendungen der Fall. Dies ist kein Problem für Schriften, die das USE_TYPO_METRICS -Flag setzen, um anzuzeigen, dass die typo -Metriken gültig sind, oder für Schriften, bei denen die win -Metriken und typo -Metriken übereinstimmen. Bei bestimmten Schriftarten können die win -Metriken jedoch größer sein als der bevorzugte Zeilenabstand und das USE_TYPO_METRICS -Flag kann versehentlich nicht gesetzt werden. Bei solchen Schriftarten kann die Einstellung font.preferTypoLineMetrics zu besseren Ergebnissen führen.

Standardmäßig ist preferTypoLineMetrics auf false gesetzt.

Diese Eigenschaft wurde in Qt 6.8 eingeführt.

Siehe auch QFont::StyleStrategy.

font.strikeout : bool

Legt fest, ob die Schrift einen Durchstreichungsstil hat.

font.styleName : string

Legt den Stilnamen der Schriftart fest.

Beim Stilnamen wird die Groß- und Kleinschreibung nicht berücksichtigt. Wenn festgelegt, wird die Schrift mit dem Stilnamen anstelle der Schrifteigenschaften font.weight, font.bold und font.italic abgeglichen.

font.underline : bool

Legt fest, ob der Text unterstrichen ist.

font.variableAxes : object [since 6.7]

Wendet Fließkommawerte auf variable Achsen in variablen Schriftarten an.

Variable Schriftarten bieten die Möglichkeit, mehrere Varianten (mit unterschiedlichen Gewichten, Breiten oder Stilen) in derselben Schriftdatei zu speichern. Die Variationen werden als Fließkommawerte für einen vordefinierten Satz von Parametern angegeben, die als "variable Achsen" bezeichnet werden. Spezifische Instanzen werden typischerweise vom Fontdesigner mit Namen versehen, und in Qt können diese mit setStyleName() genau wie traditionelle Unterfamilien ausgewählt werden.

In manchen Fällen ist es auch nützlich, beliebige Werte für die verschiedenen Achsen anzugeben. Wenn zum Beispiel eine Schriftart eine Unterfamilie Regular und Bold hat, möchten Sie vielleicht ein Gewicht dazwischen haben. Sie könnten dies dann manuell anfordern, indem Sie einen benutzerdefinierten Wert für die Achse "wght" in der Schriftart angeben.

Text {
    text: "Foobar"
    font.family: "MyVariableFont"
    font.variableAxes: { "wght": (Font.Normal + Font.Bold) / 2.0 }
}

Wenn die "wght"-Achse von der Schriftart unterstützt wird und der angegebene Wert innerhalb des definierten Bereichs liegt, wird eine Schriftart mit dem Gewicht 550,0 bereitgestellt.

Es gibt einige Standardachsen, die von vielen Schriftarten unterstützt werden, z. B. "wght" (Gewicht), "wdth" (Breite), "ital" (kursiv) und "opsz" (optische Größe). Sie haben jeweils eigene Bereiche, die in der Schriftart selbst definiert sind. Zum Beispiel kann "wght" von 100 bis 900 reichen (QFont::Thin bis QFont::Black), während "ital" von 0 bis 1 reichen kann (von nicht kursiv bis vollständig kursiv).

Eine Schriftart kann auch benutzerdefinierte Achsen definieren; die einzige Einschränkung besteht darin, dass der Name die Anforderungen für QFont::Tag (Folge von vier lateinischen-1 Zeichen) erfüllen muss.

Standardmäßig sind keine variablen Achsen festgelegt.

Diese Eigenschaft wurde in Qt 6.7 eingeführt.

Siehe auch QFont::setVariableAxis().

font.weight : int

Das gewünschte Gewicht der Schrift. Das gewünschte Gewicht muss eine ganze Zahl zwischen 1 und 1000 oder einer der vordefinierten Werte sein:

TextEdit { text: "Hello"; font.weight: Font.DemiBold }

font.wordSpacing : real

Legt den Wortabstand für die Schriftart fest.

Der Wortabstand ändert den Standardabstand zwischen den einzelnen Wörtern. Ein positiver Wert vergrößert den Wortabstand um eine entsprechende Anzahl von Pixeln, während ein negativer Wert den Abstand zwischen den Wörtern entsprechend verkleinert.

hoveredLink : string [read-only]

Diese Eigenschaft enthält den Link-String, wenn der Benutzer den Mauszeiger über einen im Text eingebetteten Link bewegt. Der Link muss im Rich-Text- oder HTML-Format vorliegen, und der Link-String ermöglicht den Zugriff auf den jeweiligen Link.

Siehe auch linkHovered und linkAt().

inputMethodComposing : bool [read-only]

Diese Eigenschaft gibt an, ob die TextEdit eine partielle Texteingabe durch eine Eingabemethode hat.

Während eine Eingabemethode komponiert wird, kann sie auf Maus- oder Tastenereignisse von TextEdit angewiesen sein, um den Teiltext zu bearbeiten oder zu bestätigen. Diese Eigenschaft kann verwendet werden, um zu bestimmen, wann Ereignis-Handler deaktiviert werden sollen, die den korrekten Betrieb einer Eingabemethode stören könnten.

inputMethodHints : enumeration

Gibt der Eingabemethode Hinweise über den erwarteten Inhalt der Texteingabe und wie sie funktionieren soll.

Der Wert ist eine bitweise Kombination von Flags oder Qt.ImhNone, wenn keine Hinweise gesetzt sind.

Flags, die das Verhalten verändern, sind:

Flags, die die Eingabe einschränken (Exklusivflags), sind:

Masken:

length : int [read-only]

Gibt die Gesamtzahl der Klartextzeichen im Element TextEdit zurück.

Da diese Zahl keine Formatierungsauszeichnungen enthält, stimmt sie möglicherweise nicht mit der Länge der Zeichenkette überein, die von der Eigenschaft text zurückgegeben wird.

Diese Eigenschaft kann schneller sein als die Abfrage der Länge der Eigenschaft text, da sie kein Kopieren oder Konvertieren der internen String-Daten von TextEdit erfordert.

lineCount : int [read-only]

Gibt die Gesamtzahl der Zeilen im Element TextEdit zurück.

mouseSelectionMode : enumeration

Gibt an, wie der Text mit der Maus ausgewählt werden soll.

Diese Eigenschaft gilt nur, wenn selectByMouse wahr ist.

overwriteMode : bool

Ob der vom Benutzer eingegebene Text den vorhandenen Text überschreiben soll.

Wie bei vielen Texteditoren kann auch das Texteditor-Widget so konfiguriert werden, dass vorhandener Text durch neuen, vom Benutzer eingegebenen Text eingefügt oder überschrieben wird.

Wenn diese Eigenschaft true lautet, wird der vorhandene Text Zeichen für Zeichen mit dem neuen Text überschrieben; andernfalls wird der Text an der Cursorposition eingefügt und der vorhandene Text verdrängt.

Standardmäßig lautet diese Eigenschaft false (neuer Text überschreibt den vorhandenen Text nicht).

persistentSelection : bool

Ob TextEdit die Auswahl sichtbar halten soll, wenn sie den aktiven Fokus an ein anderes Element in der Szene verliert. Standardmäßig ist dies auf false gesetzt.

preeditText : string [read-only]

Diese Eigenschaft enthält Teiltexteingaben aus einer Eingabemethode.

Um Teiltext, der aus Vorhersagen resultiert, auszuschalten, setzen Sie das Qt.ImhNoPredictiveText Flag in inputMethodHints.

Siehe auch inputMethodHints.

readOnly : bool

Ob der Benutzer mit dem Element TextEdit interagieren kann. Wenn diese Eigenschaft auf true gesetzt ist, kann der Text nicht durch Benutzerinteraktion bearbeitet werden.

Standardmäßig ist diese Eigenschaft auf false gesetzt.

renderType : enumeration

Überschreiben Sie den Standard-Rendering-Typ für diese Komponente.

Unterstützte Rendertypen sind:

Wählen Sie TextEdit.NativeRendering, wenn Sie es bevorzugen, dass der Text auf der Zielplattform nativ aussieht und Sie keine erweiterten Funktionen wie die Transformation des Textes benötigen. Die Verwendung solcher Funktionen in Kombination mit dem Rendering-Typ NativeRendering führt zu schlechten und manchmal pixeligen Ergebnissen.

Sowohl TextEdit.QtRendering als auch TextEdit.CurveRendering sind hardwarebeschleunigte Techniken. QtRendering ist die schnellere der beiden Techniken, verbraucht aber mehr Speicher und führt bei großen Formaten zu Rendering-Artefakten. CurveRendering sollte als Alternative in Betracht gezogen werden, wenn QtRendering keine guten visuellen Ergebnisse liefert oder wenn die Verringerung des Grafikspeicherverbrauchs eine Priorität ist.

Der Standard-Rendering-Typ wird durch QQuickWindow::textRenderType() bestimmt.

selectByKeyboard : bool

Der Standardwert ist true, wenn der Editor bearbeitbar ist, und false, wenn er schreibgeschützt ist.

Wenn true, kann der Benutzer mit der Tastatur Text auswählen, auch wenn der Editor schreibgeschützt ist. Bei false kann der Benutzer keinen Text mit der Tastatur auswählen, auch wenn der Editor bearbeitbar ist.

Siehe auch readOnly.

selectByMouse : bool

Standardmäßig ist true seit Qt 6.4 eingestellt.

Wenn true eingestellt ist, kann der Benutzer die Maus verwenden, um Text auf die übliche Weise auszuwählen.

selectedText : string [read-only]

Diese schreibgeschützte Eigenschaft liefert den derzeit in der Textbearbeitung ausgewählten Text.

Sie entspricht dem folgenden Schnipsel, ist aber schneller und einfacher zu verwenden.

//myTextEdit is the id of the TextEdit
myTextEdit.text.toString().substring(myTextEdit.selectionStart,
        myTextEdit.selectionEnd);

selectedTextColor : color

Die ausgewählte Textfarbe, die in Auswahlen verwendet wird.

selectionColor : color

Die Farbe der Texthervorhebung, die hinter Markierungen verwendet wird.

selectionEnd : int [read-only]

Die Cursorposition nach dem letzten Zeichen in der aktuellen Auswahl.

Diese Eigenschaft ist schreibgeschützt. Um die Auswahl zu ändern, verwenden Sie select(start,end), selectAll(), oder selectWord().

Siehe auch selectionStart, cursorPosition, und selectedText.

selectionStart : int [read-only]

Die Cursorposition vor dem ersten Zeichen in der aktuellen Auswahl.

Diese Eigenschaft ist schreibgeschützt. Um die Auswahl zu ändern, verwenden Sie select(start,end), selectAll(), oder selectWord().

Siehe auch selectionEnd, cursorPosition, und selectedText.

tabStopDistance : real

Der Standardabstand zwischen den Tabulatorstopps, in Geräteeinheiten.

Siehe auch QTextOption::setTabStopDistance().

text : string

Der anzuzeigende Text. Wenn das Textformat AutoText ist, bestimmt die Textbearbeitung automatisch, ob der Text als Rich Text behandelt werden soll. Diese Entscheidung wird mit Qt::mightBeRichText() getroffen. Die Erkennung von Markdown erfolgt jedoch nicht automatisch.

Die text-Eigenschaft eignet sich vor allem für die Festlegung des ursprünglichen Inhalts und die Bearbeitung von Änderungen an relativ kleinen Textinhalten. Die Methoden append(), insert() und remove() bieten eine feinkörnigere Steuerung und eine deutlich bessere Leistung bei der Änderung von besonders umfangreichen Textinhalten.

Beachten Sie, dass einige Tastaturen eine Vorhersagefunktion verwenden. In diesem Fall ist der Text, der von der Eingabemethode zusammengesetzt wird, nicht Teil dieser Eigenschaft. Der Teil des Textes, der sich auf die Vorhersagen bezieht, wird unterstrichen und in der Eigenschaft preeditText gespeichert.

Wenn Sie TextDocument::source zum Laden von Text verwendet haben, können Sie den geladenen Text über diese Eigenschaft abrufen. In diesem Fall können Sie dann textFormat ändern, um Formatkonvertierungen vorzunehmen, die den Wert der Eigenschaft text ändern. Wenn textFormat beispielsweise RichText oder AutoText ist und Sie eine HTML-Datei laden und anschließend textFormat auf MarkdownText setzen, enthält die Eigenschaft text die Umwandlung von HTML in Markdown.

Siehe auch clear(), preeditText, und textFormat.

textDocument : TextDocument [read-only]

Gibt die QQuickTextDocument dieser TextEdit zurück. Seit Qt 6.7 hat es Funktionen zum Laden und Speichern von Dateien. Sie kann auch in C++ als Mittel zum Zugriff auf die zugrundeliegende QTextDocument Instanz verwendet werden, zum Beispiel um eine QSyntaxHighlighter zu installieren.

Siehe auch QQuickTextDocument.

textFormat : enumeration

Die Art und Weise, wie die Eigenschaft text angezeigt werden soll.

Unterstützte Textformate sind:

Die Standardeinstellung ist TextEdit.PlainText. Wenn das Textformat auf TextEdit.AutoText gesetzt ist, wird bei der Textbearbeitung automatisch ermittelt, ob der Text als Rich Text behandelt werden soll. Wenn die Eigenschaft text eingestellt ist, wird diese Bestimmung mit Qt::mightBeRichText() vorgenommen, das das Vorhandensein eines HTML-Tags in der ersten Textzeile erkennen kann, aber nicht zwischen Markdown und einfachem Text unterscheiden kann. Wenn die Eigenschaft TextDocument::source gesetzt ist, wird diese Bestimmung anhand der mime type of the file vorgenommen.

Column {
    TextEdit {
        font.pointSize: 24
        textFormat: TextEdit.AutoText
        text: "<b>Hello</b> <i>World!</i>"
    }
    TextEdit {
        font.pointSize: 24
        textFormat: TextEdit.RichText
        text: "<b>Hello</b> <i>World!</i>"
    }
    TextEdit {
        font.pointSize: 24
        textFormat: TextEdit.PlainText
        text: "<b>Hello</b> <i>World!</i>"
    }
    TextEdit {
        font.pointSize: 24
        textFormat: TextEdit.MarkdownText
        text: "**Hello** *World!*"
    }
}

Mit TextEdit.MarkdownText sind Kontrollkästchen, die aus der Verwendung der GitHub-Kontrollkästchenerweiterung resultieren, interaktiv anklickbar.

Wenn die Eigenschaft TextDocument::source gesetzt ist, bewirkt eine Änderung der Eigenschaft textFormat nach dem Laden eine Konvertierung vom erkannten Format in das gewünschte Format. Sie können zum Beispiel zwischen HTML und Markdown konvertieren. Wenn jedoch eines dieser "reichen" Formate geladen wird und Sie dann textFormat auf PlainText setzen, wird TextEdit das rohe Markup anzeigen. Geeignete Bindungen (z. B. an ein ankreuzbares Steuerelement) können es dem Benutzer also ermöglichen, zwischen der "rohen" und der WYSIWYG-Bearbeitung hin und her zu wechseln.

• Code-Blöcke verwenden die default monospace font, aber ohne umgebende Highlight-Box
• Blockanführungszeichen werden eingerückt, aber es gibt keine vertikale Linie entlang des Anführungszeichens

textMargin : real

Der Rand in Pixeln um den Text in TextEdit.

wrapMode : enumeration

Setzen Sie diese Eigenschaft, um den Text auf die Breite des Elements TextEdit umzubrechen. Der Text wird nur umbrochen, wenn eine explizite Breite festgelegt wurde.

Die Vorgabe ist TextEdit.NoWrap. Wenn Sie eine Breite festlegen, sollten Sie TextEdit.Wrap verwenden.

Signal-Dokumentation

editingFinished()

Dieses Signal wird ausgegeben, wenn die Textbearbeitung den Fokus verliert.

linkActivated(string link)

Dieses Signal wird ausgegeben, wenn der Benutzer auf einen im Text eingebetteten Link klickt. Der Link muss im Rich-Text- oder HTML-Format vorliegen, und die Zeichenfolge link ermöglicht den Zugriff auf den jeweiligen Link.

linkHovered(string link)

Dieses Signal wird ausgegeben, wenn der Benutzer den Mauszeiger über einen im Text eingebetteten Link bewegt. Der Link muss im Rich-Text- oder HTML-Format vorliegen und die Zeichenfolge link ermöglicht den Zugriff auf den jeweiligen Link.

Siehe auch hoveredLink und linkAt().

[since 6.9] textEdited()

Dieses Signal wird immer dann ausgegeben, wenn der Text bearbeitet wird. Im Gegensatz zu textChanged() wird dieses Signal nicht ausgegeben, wenn der Text programmatisch geändert wird, z. B. durch Änderung des Werts der Eigenschaft text oder durch Aufruf von clear().

Dieses Signal wurde in Qt 6.9 eingeführt.

Dokumentation der Methode

void append(string text)

Hängt einen neuen Absatz mit text an das Ende von TextEdit an.

Wenn Sie anhängen möchten, ohne einen neuen Absatz einzufügen, rufen Sie stattdessen myTextEdit.insert(myTextEdit.length, text) auf.

void clear()

Löscht den Inhalt der Texteingabe und setzt partielle Texteingaben aus einer Eingabemethode zurück.

Verwenden Sie diese Methode, anstatt die Eigenschaft text auf eine leere Zeichenkette zu setzen.

Siehe auch QInputMethod::reset().

void copy()

Kopiert den aktuell ausgewählten Text in die Zwischenablage des Systems.

void cut()

Verschiebt den aktuell ausgewählten Text in die Zwischenablage des Systems.

void deselect()

Entfernt die aktive Textauswahl.

string getFormattedText(int start, int end)

Gibt den Textabschnitt zurück, der sich zwischen den Positionen start und end befindet.

Der zurückgegebene Text wird entsprechend der Eigenschaft textFormat formatiert.

string getText(int start, int end)

Gibt den Textabschnitt zurück, der sich zwischen den Positionen start und end befindet.

Der zurückgegebene Text enthält keine Rich-Text-Formatierung.

void insert(int position, string text)

Fügt text in die TextEdit unter position ein.

bool isRightToLeft(int start, int end)

Gibt true zurück, wenn die natürliche Leserichtung des zwischen den Positionen start und end gefundenen Editortextes von rechts nach links ist.

string linkAt(real x, real y)

Gibt den Link-String am Punkt x, y in Inhaltskoordinaten zurück oder einen leeren String, wenn an diesem Punkt kein Link existiert.

Siehe auch hoveredLink.

void moveCursorSelection(int position, SelectionMode mode)

Bewegt den Cursor zu position und aktualisiert die Auswahl entsprechend dem optionalen Parameter mode. (Um nur den Cursor zu verschieben, setzen Sie die Eigenschaft cursorPosition.)

Wenn diese Methode aufgerufen wird, setzt sie zusätzlich entweder selectionStart oder selectionEnd (je nachdem, was sich an der vorherigen Cursorposition befand) auf die angegebene Position. Auf diese Weise können Sie den ausgewählten Textbereich leicht erweitern und verkleinern.

Der Auswahlmodus gibt an, ob die Auswahl pro Zeichen oder pro Wort aktualisiert werden soll. Wenn nichts angegeben wird, ist der Auswahlmodus standardmäßig auf TextEdit.SelectCharacters eingestellt.

Nehmen Sie zum Beispiel diese Folge von Aufrufen:

cursorPosition = 5
moveCursorSelection(9, TextEdit.SelectCharacters)
moveCursorSelection(7, TextEdit.SelectCharacters)

Der Cursor wird an die Position 5 bewegt, das Markierungsende wird von 5 bis 9 verlängert und dann von 9 bis 7 zurückgezogen, so dass der Text von Position 5 bis 7 ausgewählt bleibt (das 6. und 7. Zeichen).

Die gleiche Sequenz mit TextEdit.SelectWords erweitert den Auswahlanfang bis zu einer Wortgrenze vor oder auf Position 5 und erweitert das Auswahlende bis zu einer Wortgrenze auf oder nach Position 9.

void paste()

Ersetzt den aktuell markierten Text durch den Inhalt der Systemzwischenablage.

int positionAt(int x, int y)

Gibt die Textposition zurück, die der Pixelposition (x, y) am nächsten liegt.

Position 0 liegt vor dem ersten Zeichen, Position 1 liegt nach dem ersten Zeichen, aber vor dem zweiten, und so weiter bis zur Position text.length, die nach allen Zeichen liegt.

rectangle positionToRectangle(position)

Gibt das Rechteck an der angegebenen position im Text zurück. Die Eigenschaften x, y und height entsprechen dem Cursor, der diese Position beschreiben würde.

void redo()

Wiederholt den letzten Vorgang, wenn redo available ist.

string remove(int start, int end)

Entfernt den Textabschnitt, der zwischen den Positionen start und end liegt, aus TextEdit.

void select(int start, int end)

Bewirkt, dass der Text von start bis end ausgewählt wird.

Wenn entweder Anfang oder Ende außerhalb des Bereichs liegen, wird die Auswahl nicht geändert.

Nach dem Aufruf dieser Methode wird selectionStart zum kleineren und selectionEnd zum größeren Text (unabhängig von der Reihenfolge der Übergabe an diese Methode).

Siehe auch selectionStart und selectionEnd.

void selectAll()

Bewirkt, dass der gesamte Text ausgewählt wird.

void selectWord()

Das Wort, das der aktuellen Cursorposition am nächsten liegt, wird ausgewählt.

void undo()

Macht den letzten Vorgang rückgängig, wenn Rückgängig available ist. Deselektiert die aktuelle Auswahl und aktualisiert den Auswahlanfang auf die aktuelle Cursorposition.