TextInput QML Type

Zeigt eine bearbeitbare Textzeile an. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• acceptableInput : bool
• activeFocusOnPress : bool
• autoScroll : bool
• bottomPadding : real
• canPaste : bool
• canRedo : bool
• canUndo : bool
• color : color
• contentHeight : real
• contentWidth : real
• cursorDelegate : Component
• cursorPosition : int
• cursorRectangle : rectangle
• cursorVisible : bool
• displayText : string
• echoMode : enumeration
• 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
• inputMask : string
• inputMethodComposing : bool
• inputMethodHints : enumeration
• leftPadding : real
• length : int
• maximumLength : int
• mouseSelectionMode : enumeration
• overwriteMode : bool
• padding : real
• passwordCharacter : string
• passwordMaskDelay : int
• persistentSelection : bool
• preeditText : string
• readOnly : bool
• renderType : enumeration
• rightPadding : real
• selectByMouse : bool
• selectedText : string
• selectedTextColor : color
• selectionColor : color
• selectionEnd : int
• selectionStart : int
• text : string
• topPadding : real
• validator : Validator
• verticalAlignment : enumeration
• wrapMode : enumeration

Signale

• accepted()
• editingFinished()
• textEdited()

Methoden

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

Ausführliche Beschreibung

Der Typ „TextInput“ zeigt eine einzelne Zeile bearbeitbaren Klartextes an.

„TextInput“ wird verwendet, um die Eingabe einer Textzeile zu ermöglichen. Für ein „TextInput“-Element können Eingabebeschränkungen festgelegt werden (beispielsweise über „ validator “ oder „ inputMask “), und durch Setzen von „ echoMode “ auf einen geeigneten Wert kann „TextInput“ als Passworteingabefeld verwendet werden.

Um auf die Texteingabe des Benutzers über die Return- oder Enter-Taste zu reagieren, verarbeiten Sie das Signal „ accepted()“. Wenn die Return- oder Enter-Taste gedrückt wird und die Texteingabe den Fokus verliert, wird „ editingFinished()“ ausgelöst. Wenn der Text vom Benutzer in irgendeiner Weise bearbeitet wird, wird „ textEdited()“ ausgelöst. Diese Signale sollten in den meisten Fällen gegenüber „ textChanged() “ bevorzugt werden.

Unter macOS sind die Tastenbelegungen „Aufwärts-/Abwärts-Taste“ für „Home/End“ explizit deaktiviert. Wenn Sie solche Belegungen (auf einer beliebigen Plattform) wünschen, müssen Sie diese in QML selbst erstellen.

Siehe auch TextEdit und Text.

Dokumentation zu Eigenschaften

acceptableInput : bool [read-only]

Diese Eigenschaft ist immer wahr, es sei denn, es wurde ein Validator oder eine Eingabemaske festgelegt. Wenn ein Validator oder eine Eingabemaske festgelegt wurde, ist diese Eigenschaft nur dann wahr, wenn der aktuelle Text für den Validator oder die Eingabemaske als endgültige Zeichenfolge (nicht als Zwischenzeichenfolge) zulässig ist.

activeFocusOnPress : bool

Ob der „ TextInput “ bei einem Mausklick aktiv in den Fokus rücken soll. Standardmäßig ist diese Option auf „true“ gesetzt.

autoScroll : bool

Gibt an, ob der „ TextInput “ scrollen soll, wenn der Text länger als die Breite ist. Standardmäßig ist diese Option auf „true“ gesetzt.

Siehe auch ensureVisible().

Diese Eigenschaften legen den Abstand um den Inhalt herum fest. Dieser Abstand wird zusätzlich zu den Eigenschaften „ contentWidth “ und „ contentHeight “ reserviert.

Die einzelnen Padding-Eigenschaften übernehmen den Wert der Eigenschaft „ padding “, sofern sie nicht explizit festgelegt werden. Wenn beispielsweise „ padding “ auf „ 4 “ und „ leftPadding “ auf „ 8 “ gesetzt ist, wird „ 8 “ als linkes Padding verwendet.

canPaste : bool [read-only]

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

canRedo : bool [read-only]

Gibt „true“ zurück, wenn die „ TextInput “ beschreibbar ist und „ undone “-Operationen vorhanden sind, die rückgängig gemacht werden können.

canUndo : bool [read-only]

Gibt „true“ zurück, wenn die „ TextInput “ beschreibbar ist und frühere Vorgänge vorhanden sind, die rückgängig gemacht werden können.

color : color

Die Textfarbe.

contentHeight : real [read-only]

Gibt die Höhe des Textes zurück, einschließlich des Teils, der über die festgelegte Höhe hinausragt, falls der Text nicht in die festgelegte Höhe passt.

contentWidth : real [read-only]

Gibt die Breite des Textes zurück, einschließlich des Teils, der über die Breite hinausragt, der aufgrund unzureichender Zeilenumbrüche abgedeckt wird, wenn „ wrapMode “ gesetzt ist.

cursorDelegate : Component

Der Delegat für den Cursor im ` TextInput`.

Wenn Sie für ein „ TextInput “ einen „cursorDelegate“ festlegen, wird dieser Delegat anstelle des Standardcursors zum Zeichnen des Cursors verwendet. Eine Instanz des Delegaten wird vom „ TextInput “ erstellt und verwaltet, sobald ein Cursor benötigt wird, und die Eigenschaft „x“ der Delegat-Instanz wird so gesetzt, dass sie sich einen Pixel vor der oberen linken Ecke des aktuellen Zeichens befindet.

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

cursorPosition : int

Die Position des Cursors im „ TextInput “. Der Cursor befindet sich zwischen Zeichen.

displayText ist anders, wenn „ echoMode “ auf „ TextInput.Password “ gesetzt ist: Dann ist jedes „ passwordCharacter “ ein „schmales“ Zeichen (die „cursorPosition“ verschiebt sich immer um 1), auch wenn der Text im „ TextInput “ dies nicht ist.

cursorRectangle : rectangle [read-only]

Das Rechteck, in dem der Standard-Textcursor innerhalb des Texteingabefelds dargestellt wird. Nur-Lese-Zugriff.

Die Position und Höhe eines benutzerdefinierten „ cursorDelegate “ werden automatisch an das „cursorRectangle“ angepasst, sobald sich dieses ändert. Die Breite des Delegaten wird von Änderungen am Cursor-Rechteck nicht beeinflusst.

cursorVisible : bool

Wird auf „true“ gesetzt, wenn das „ TextInput “ einen Cursor anzeigt.

Diese Eigenschaft wird gesetzt und zurückgesetzt, wenn das „ TextInput “ den aktiven Fokus erhält, sodass andere Eigenschaften davon abhängig gemacht werden können, ob der Cursor gerade angezeigt wird. Da sie automatisch gesetzt und zurückgesetzt wird, müssen Sie beim manuellen Festlegen des Werts berücksichtigen, dass Ihr Wert möglicherweise überschrieben wird.

Sie kann direkt im Skript gesetzt werden, beispielsweise wenn ein „KeyProxy“ Tastenbefehle an sie weiterleitet und Sie möchten, dass sie in diesem Fall aktiv aussieht (ohne ihr jedoch tatsächlich den aktiven Fokus zu geben).

Es sollte nicht direkt am Element gesetzt werden, wie im folgenden QML-Code, da der angegebene Wert bei Fokuswechseln überschrieben wird und verloren geht.

TextInput {
    text: "Text"
    cursorVisible: false
}

Im obigen Codeausschnitt wird der Cursor weiterhin sichtbar, wenn das „ TextInput “ den aktiven Fokus erhält.

displayText : string [read-only]

Dies ist der Text, der unter „ TextInput “ angezeigt wird.

Wenn „ echoMode “ auf „TextInput::Normal“ gesetzt ist, hat diese Eigenschaft denselben Wert wie die Eigenschaft „ TextInput::text “. Andernfalls enthält diese Eigenschaft den für den Benutzer sichtbaren Text, während die Eigenschaft „ text “ den tatsächlich eingegebenen Text enthält.

Siehe auch „ preeditText “.

echoMode : enumeration

Legt fest, wie der Text im „ TextInput “ angezeigt werden soll.

effectiveHorizontalAlignment : enumeration [read-only]

Bei Verwendung der Eigenschaft „ LayoutMirroring::enabled “ zum Spiegeln von Anwendungslayouts wird auch die horizontale Ausrichtung des Textes gespiegelt. Die Eigenschaft „ horizontalAlignment “ bleibt jedoch unverändert. Um die tatsächlich geltende horizontale Ausrichtung von „ TextInput “ abzufragen, verwenden Sie die schreibgeschützte Eigenschaft „ effectiveHorizontalAlignment “.

font.bold : bool

Legt fest, ob die Schrift fett formatiert ist.

font.capitalization : enumeration

Legt die Großschreibung des Textes fest.

Text { 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 aus, die dieses Zeichen enthält. Standardmäßig erfolgt dies Zeichen für Zeichen.

Das bedeutet, dass in bestimmten seltenen Fällen viele verschiedene Schriftarten zur Darstellung einer Textzeichenfolge verwendet werden können, selbst wenn diese in derselben Schriftart geschrieben ist. Wenn „ contextFontMerging “ auf „true“ gesetzt wird, wird stattdessen versucht, die Ersatzschriftart zu finden, die mit der größten Teilmenge der Eingabezeichenfolge übereinstimmt. Dies ist bei Zeichenfolgen, in denen fehlende Glyphen vorkommen, rechenintensiver, kann jedoch zu konsistenteren Ergebnissen führen. Standardmäßig ist „ contextFontMerging “ auf „ false “ gesetzt.

Diese Eigenschaft wurde in Qt 6.8 eingeführt.

Siehe auch „ QFont::StyleStrategy “.

font.family : string

Legt den Familiennamen der Schriftart fest.

Bei der Schriftfamilie wird die Groß-/Kleinschreibung nicht berücksichtigt, und der Name kann optional einen Herstellerangabe enthalten, zum Beispiel „Helvetica [Cronyx]“. Wenn die Schriftfamilie von mehr als einem Hersteller angeboten wird und kein Hersteller angegeben ist, wird ein beliebiger Hersteller ausgewählt. Ist die Schriftfamilie nicht verfügbar, wird mithilfe des Algorithmus zur Schriftartzuordnung eine Schriftfamilie festgelegt.

font.features : object [since 6.6]

Wendet bei der inhaltsbasierten Textgestaltung ganzzahlige Werte auf bestimmte OpenType-Funktionen an. Dies ermöglicht einen erweiterten Zugriff auf den Prozess der Schriftgestaltung und kann zur Unterstützung von Schriftfunktionen genutzt werden, die ansonsten nicht von der API abgedeckt sind.

Die Schriftfunktionen werden durch eine Zuordnung von vierbuchstabigen Tags zu ganzzahligen Werten dargestellt. Dieser ganzzahlige Wert, der in den meisten Fällen zusammen mit dem Tag übergeben wird, stellt einen booleschen Wert dar: Der Wert Null bedeutet, dass die Funktion deaktiviert ist, und ein Wert ungleich Null bedeutet, dass sie aktiviert ist. Bei bestimmten Schriftfunktionen kann dies jedoch auch anders interpretiert werden. Wird der Wert beispielsweise auf die Funktion „ salt “ angewendet, handelt es sich um einen Index, der die zu verwendende stilistische Alternative angibt.

Die Schriftfunktion „ frac “ wandelt beispielsweise diagonale Brüche, die durch einen Schrägstrich getrennt sind (wie z. B. „ 1/2 “), in eine andere Darstellung um. In der Regel wird dabei der gesamte Bruch in eine einzige Zeichenbreite zusammengefasst (wie z. B. „ ½ “).

Wenn eine Schriftart die Funktion „ frac “ unterstützt, kann sie im Shaper wie im folgenden Code aktiviert werden:

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

In derselben Zuordnung können mehreren Funktionen Werte zugewiesen werden. Wenn Sie beispielsweise 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 Schriftarteneigenschaften auch in einem Objekt zusammenfassen:

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

dlig, hlig) werden deaktiviert, wenn „ font.letterSpacing “ gesetzt ist, jedoch nur für Schriftsysteme, in denen die Verwendung von Ligaturen rein kosmetischer Natur ist. Bei Schriftsystemen, in denen Ligaturen erforderlich sind, bleiben die Funktionen in ihrem Standardzustand. Die mit „ font.features “ festgelegten Werte überschreiben das Standardverhalten. Ist beispielsweise „ "kern" “ auf 1 gesetzt, wird das Kerning immer aktiviert, unabhängig davon, ob die Eigenschaft „ font::kerning “ auf „false“ gesetzt ist. Ebenso

wenn der Wert auf „ 0 “ gesetzt ist, ist es immer deaktiviert.

Diese Eigenschaft wurde in Qt 6.6 eingeführt.

Siehe auch „ QFont::setFeature()“.

font.hintingPreference : enumeration

Legt die bevorzugte Hinting-Einstellung für den Text fest.

Dies ist ein Hinweis an das zugrunde liegende Text-Rendering-System, einen bestimmten Hinting-Grad zu verwenden, und wird von den verschiedenen Plattformen unterschiedlich unterstützt. Weitere Details finden Sie in der Tabelle in der Dokumentation zu „ QFont::HintingPreference “.

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

font.italic : bool

Legt fest, ob die Schriftart einen kursiven Stil hat.

font.kerning : bool

Aktiviert oder deaktiviert die OpenType-Funktion „Kerning“ bei der Gestaltung des Textes. Die Deaktivierung dieser Funktion kann die Leistung beim Erstellen oder Ändern des Textes verbessern, geht jedoch zu Lasten einiger optischer Merkmale. Der Standardwert lautet „ true “.

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

font.letterSpacing : real

Legt den Zeichenabstand für die Schriftart fest.

Der Buchstabenabstand verändert den Standardabstand zwischen den einzelnen Buchstaben der Schriftart. Ein positiver Wert vergrößert den Buchstabenabstand um die entsprechende Pixelanzahl; ein negativer Wert verringert den Abstand.

font.pixelSize : int

Legt die Schriftgröße in Pixeln fest.

Die Verwendung dieser Funktion macht die Schriftart geräteabhängig. Verwenden Sie „ pointSize “, um die Schriftgröße geräteunabhängig festzulegen.

font.pointSize : real

Legt die Schriftgröße in Punkten 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 diese korrekt darzustellen. In einigen Schriftsystemen, wie beispielsweise den brahmischen Schriften, ist dies erforderlich, damit der Text lesbar ist, während es beispielsweise bei der lateinischen Schrift lediglich ein kosmetisches Merkmal ist. Durch Setzen der Eigenschaft „ preferShaping “ auf „false“ werden alle derartigen Funktionen deaktiviert, wenn sie nicht benötigt werden, was in den meisten Fällen zu einer Leistungssteigerung führt.

Der Standardwert ist „ true “.

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

font.preferTypoLineMetrics : bool [since 6.8]

Konkurrierende Sätze vertikaler Linienmetriken, die die Werte „ ascent “, „ descent “ und „ leading “ der Schriftart liefern. Diese werden oft als „Win-Metriken“ (Windows) und „Typo-Metriken“ (typografische Metriken) bezeichnet. Während die Spezifikation die Verwendung der „ typo “-Metriken für den Zeilenabstand empfiehlt, bevorzugen viele Anwendungen die „ win “-Metriken, es sei denn, das Flag „ USE_TYPO_METRICS “ ist im Feld „fsSelection“ der Schriftart gesetzt. Aus Gründen der Abwärtskompatibilität gilt dies auch für Qt-Anwendungen. Dies ist kein Problem für Schriftarten, bei denen das Flag „ USE_TYPO_METRICS “ gesetzt ist, um anzugeben, dass die „ typo “-Metriken gültig sind, und auch nicht für Schriftarten, bei denen die „ win “-Metriken und die „ typo “-Metriken übereinstimmen. Bei bestimmten Schriftarten können die „ win “-Metriken jedoch größer sein als der bevorzugte Zeilenabstand, und das Flag „ USE_TYPO_METRICS “ kann versehentlich nicht gesetzt sein. Bei solchen Schriftarten kann das Setzen von „ 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 Schriftart einen Durchgestrichen-Stil aufweist.

font.styleName : string

Legt den Stilnamen der Schriftart fest.

Bei der Eingabe des Stilnamens wird die Groß-/Kleinschreibung nicht berücksichtigt. Wenn dieser festgelegt ist, wird die Schriftart anhand des Stilnamens statt anhand der Schriftart-Eigenschaften „ font.weight “, „ font.bold “ und „ font.italic “ zugeordnet.

font.underline : bool

Legt fest, ob der Text unterstrichen ist.

font.variableAxes : object [since 6.7]

Wendet Gleitkommawerte auf variable Achsen in variablen Schriftarten an.

Variable Schriftarten bieten die Möglichkeit, mehrere Varianten (mit unterschiedlichen Strichstärken, Breiten oder Stilen) in derselben Schriftdatei zu speichern. Die Varianten werden als Gleitkommawerte für einen vordefinierten Satz von Parametern angegeben, die als „variable Achsen“ bezeichnet werden. Bestimmte Instanzen werden in der Regel vom Schriftdesigner benannt, und in Qt können diese genau wie herkömmliche Unterfamilien mit setStyleName() ausgewählt werden.

In manchen Fällen ist es auch sinnvoll, beliebige Werte für die verschiedenen Achsen anzugeben. Wenn eine Schriftart beispielsweise die Unterfamilien „Regular“ und „Bold“ hat, möchten Sie vielleicht eine Strichstärke dazwischen. Dies könnten Sie 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 bereitgestellt, die der Stärke 550,0 entspricht.

Es gibt einige Standardachsen, die von vielen Schriftarten bereitgestellt werden, wie beispielsweise „wght“ (Strichstärke), „wdth“ (Breite), „ital“ (kursiv) und „opsz“ (optische Größe). Für jede dieser Achsen sind in der Schriftart selbst individuelle Bereiche definiert. Beispielsweise 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 festlegen; die einzige Einschränkung besteht darin, dass der Name die Anforderungen an eine „ QFont::Tag “ (eine Folge von vier Latin-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

Die gewünschte Schriftstärke. Die angegebene Schriftstärke muss eine ganze Zahl zwischen 1 und 1000 sein oder einem der vordefinierten Werte entsprechen:

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

font.wordSpacing : real

Legt den Wortabstand für die Schriftart fest.

Der Wortabstand verändert den Standardabstand zwischen einzelnen Wörtern. Ein positiver Wert vergrößert den Wortabstand um die entsprechende Pixelanzahl, während ein negativer Wert den Wortabstand entsprechend verringert.

Legt die horizontale Ausrichtung des Textes innerhalb der Breite und Höhe des „ TextInput “-Elements fest. Standardmäßig folgt die Textausrichtung der natürlichen Ausrichtung des Textes; so wird beispielsweise Text, der von links nach rechts gelesen wird, linksbündig ausgerichtet.

TextInput Eine vertikale Ausrichtung gibt es nicht, da die natürliche Höhe genau der Höhe der einzelnen Textzeile entspricht. Wenn Sie die Höhe manuell auf einen größeren Wert festlegen, wird „ TextInput “ vertikal immer oben ausgerichtet. Sie können Anker verwenden, um es innerhalb eines anderen Elements nach Belieben auszurichten.

Die gültigen Werte für „ horizontalAlignment “ sind „ TextInput.AlignLeft “, „ TextInput.AlignRight “ und „ TextInput.AlignHCenter “.

Gültige Werte für „ verticalAlignment “ sind „ TextInput.AlignTop “ (Standard), „ TextInput.AlignBottom “ und „ TextInput.AlignVCenter “.

Bei Verwendung der angehängten Eigenschaft „ LayoutMirroring::enabled “ zum Spiegeln von Anwendungslayouts wird auch die horizontale Ausrichtung von Text gespiegelt. Die Eigenschaft „ horizontalAlignment “ bleibt jedoch unverändert. Um die tatsächlich geltende horizontale Ausrichtung von „ TextInput “ abzufragen, verwenden Sie die schreibgeschützte Eigenschaft „ effectiveHorizontalAlignment “.

inputMask : string

Ermöglicht es Ihnen, eine Eingabemaske für TextInput festzulegen und so die zulässigen Texteingaben einzuschränken. Weitere Informationen finden Sie unter QLineEdit::inputMask, da genau dieselben Maskenzeichenfolgen auch von TextInput verwendet werden.

Siehe auch acceptableInput und validator.

inputMethodComposing : bool [read-only]

Diese Eigenschaft gibt an, ob im „ TextInput “ eine Teileingabe über eine Eingabemethode vorliegt.

Während der Erstellung einer Eingabe kann sich eine Eingabemethode auf Maus- oder Tastenereignisse des „ TextInput “ stützen, um den Teiltext zu bearbeiten oder zu übernehmen. Diese Eigenschaft kann verwendet werden, um zu bestimmen, wann Ereignisbehandler deaktiviert werden sollen, die den korrekten Betrieb einer Eingabemethode beeinträchtigen könnten.

inputMethodHints : enumeration

Liefert der Eingabemethode Hinweise zum erwarteten Inhalt der Texteingabe und dazu, wie sie verfahren soll.

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

Flagge, die das Verhalten beeinflussen, sind:

Beachten Sie, dass Android-IMEs in Passwortfeldern bewusst nur die Eingabe lateinischer/ASCII-Zeichen zulassen.

Beachten Sie, dass das Qt-Framework dies als sichtbares Passwort behandelt und Android-IME in diesem Fall bewusst nur die Eingabe lateinischer/ASCII-Zeichen zulassen.

Flagge, die die Eingabe einschränken (exklusive Flagge), sind:

Masken:

length : int [read-only]

Gibt die Gesamtanzahl der Zeichen im Element „ TextInput “ zurück.

Wenn das Element „ TextInput “ eine „ inputMask “ enthält, umfasst die Länge auch die Maskierungszeichen und kann von der Länge der Zeichenkette abweichen, die von der Eigenschaft „ text “ zurückgegeben wird.

Diese Eigenschaft kann schneller sein als die Abfrage der Länge über die Eigenschaft „ text “, da sie kein Kopieren oder Konvertieren der internen Zeichenfolgendaten des „ TextInput “ erfordert.

maximumLength : int

Die maximal zulässige Länge des Textes in der TextInput.

Ist der Text zu lang, wird er an der Grenze abgeschnitten.

Standardmäßig ist diese Eigenschaft auf den Wert 32767 gesetzt.

mouseSelectionMode : enumeration

Legt fest, wie Text mit der Maus ausgewählt werden soll.

Diese Eigenschaft gilt nur, wenn „ selectByMouse “ auf „true“ gesetzt ist.

overwriteMode : bool

Ob der vom Benutzer eingegebene Text den vorhandenen Text überschreibt.

Wie bei vielen Texteditoren kann das Texteditor-Widget so konfiguriert werden, dass der vom Benutzer eingegebene neue Text in den vorhandenen Text eingefügt oder diesen überschreibt.

Wenn diese Eigenschaft auf „ true “ gesetzt ist, wird der vorhandene Text Zeichen für Zeichen durch den neuen Text überschrieben; andernfalls wird der Text an der Cursorposition eingefügt und verdrängt dabei den vorhandenen Text.

Standardmäßig ist diese Eigenschaft auf „ false “ gesetzt (neuer Text überschreibt keinen vorhandenen Text).

passwordCharacter : string

Dies ist das Zeichen, das angezeigt wird, wenn „ echoMode “ auf „Password“ oder „PasswordEchoOnEdit“ gesetzt ist. Standardmäßig ist dies das Passwortzeichen, das vom Plattform-Design verwendet wird.

Wenn diese Eigenschaft auf eine Zeichenkette mit mehr als einem Zeichen gesetzt wird, wird das erste Zeichen verwendet. Ist die Zeichenkette leer, wird der Wert ignoriert und die Eigenschaft nicht gesetzt.

passwordMaskDelay : int

Legt die Verzögerung in Millisekunden fest, bevor ein sichtbares Zeichen durch ein Passwortzeichen verdeckt wird.

Die Reset-Methode wird durch die Zuweisung von „undefined“ aufgerufen.

persistentSelection : bool

Ob das „ TextInput “ seine Auswahl beibehalten soll, wenn der Fokus auf ein anderes Element in der Szene wechselt. Standardmäßig ist diese Option auf „false“ gesetzt;

preeditText : string [read-only]

Diese Eigenschaft enthält einen Teiltext, der über eine Eingabemethode eingegeben wurde.

Um die durch Vorhersagen erzeugten Teilsätze zu deaktivieren, setzen Sie das Flag „ Qt.ImhNoPredictiveText “ in „ inputMethodHints “.

Siehe auch „ displayText “ und „ inputMethodHints “.

readOnly : bool

Legt fest, ob Benutzereingaben den Inhalt von „ TextInput “ ändern können.

Wenn „readOnly“ auf „true“ gesetzt ist, haben Benutzereingaben keinen Einfluss auf die „text“-Eigenschaft. Alle Bindungen oder Versuche, die „text“-Eigenschaft zu setzen, funktionieren weiterhin.

renderType : enumeration

Den Standard-Rendering-Typ für diese Komponente überschreiben.

Unterstützte Darstellungsarten sind:

Wählen Sie „ TextInput.NativeRendering “, wenn Sie möchten, dass der Text auf der Zielplattform nativ dargestellt wird, und 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 verpixelten Ergebnissen.

Sowohl „ TextInput.QtRendering “ als auch „ TextInput.CurveRendering “ sind hardwarebeschleunigte Verfahren. „ QtRendering “ ist das schnellere der beiden, beansprucht jedoch mehr Speicher und weist bei großen Abmessungen Darstellungsartefakte auf. „ CurveRendering “ sollte als Alternative in Betracht gezogen werden, wenn „ QtRendering “ keine guten visuellen Ergebnisse liefert oder die Reduzierung des Grafikspeicherverbrauchs Priorität hat.

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

selectByMouse : bool

Standardmäßig ist „ true “ eingestellt.

Wenn „true“, kann der Benutzer Text wie gewohnt mit der Maus auswählen.

selectedText : string [read-only]

Diese schreibgeschützte Eigenschaft liefert den Text, der derzeit im Texteingabefeld ausgewählt ist.

Sie entspricht dem folgenden Codeausschnitt, ist jedoch schneller und einfacher zu verwenden.

myTextInput.text.toString().substring(myTextInput.selectionStart,
    myTextInput.selectionEnd);

selectedTextColor : color

Die Farbe des hervorgehobenen Textes, die bei Markierungen verwendet wird.

selectionColor : color

Die Farbe der Textmarkierung, die hinter ausgewählten Textstellen angezeigt wird.

selectionEnd : int [read-only]

Die Cursorposition nach dem letzten Zeichen 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 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`.

text : string

Der Text in der Eigenschaft „ TextInput “.

Beachten Sie, dass einige Tastaturen eine Vorhersagefunktion verwenden. In diesem Fall ist der von der Eingabemethode erstellte Text nicht Teil dieser Eigenschaft. Der Teil des Textes, der sich auf die Vorhersagen bezieht, wird unterstrichen und in der Eigenschaft „ preeditText “ gespeichert. Um den gesamten Text anzuzeigen, der in der Eigenschaft „ TextInput “ enthalten ist, verwenden Sie die Eigenschaft „ displayText “.

Siehe auch „ clear()“, „ displayText “, „ preeditText “, „ accepted()“, „ editingFinished()“ und „ textEdited()“.

validator : Validator

Ermöglicht es Ihnen, einen Validator für das TextInput festzulegen. Wenn ein Validator festgelegt ist, akzeptiert das TextInput nur Eingaben, die die Eigenschaft „text“ in einem zulässigen oder Zwischenzustand belassen. Das Signal „accepted“ wird nur gesendet, wenn sich der Text beim Drücken der Eingabetaste in einem zulässigen Zustand befindet.

Derzeit werden folgende Validatoren unterstützt: „ IntValidator “, „ DoubleValidator “ und „ RegularExpressionValidator “. Nachfolgend finden Sie ein Beispiel für die Verwendung von Validatoren, das die Eingabe von Ganzzahlen zwischen 11 und 31 in das Texteingabefeld ermöglicht:

import QtQuick 2.0
TextInput{
    validator: IntValidator{bottom: 11; top: 31;}
    focus: true
}

Siehe auch acceptableInput und inputMask.

wrapMode : enumeration

Setzen Sie diese Eigenschaft, um den Text an die Breite des Elements „ TextInput “ anzupassen. Der Text wird nur umgebrochen, wenn eine explizite Breite festgelegt wurde.

Die Standardeinstellung ist ` TextInput.NoWrap`. Wenn Sie eine Breite festlegen, sollten Sie die Verwendung von ` TextInput.Wrap` in Betracht ziehen.

Signal-Dokumentation

accepted()

Dieses Signal wird ausgelöst, wenn die Return- oder Enter-Taste gedrückt wird. Beachten Sie: Wenn für die Texteingabe ein validator oder inputMask festgelegt ist, wird das Signal nur ausgelöst, wenn sich die Eingabe in einem zulässigen Zustand befindet.

Siehe auch editingFinished() und textEdited().

editingFinished()

Dieses Signal wird ausgelöst, wenn die Return- oder Enter-Taste gedrückt wird oder das Textfeld den Fokus verliert. Beachten Sie: Wenn für das Textfeld ein Validator oder ein „ inputMask “ festgelegt ist und die Enter- oder Return-Taste gedrückt wird, wird dieses Signal nur ausgelöst, wenn das Textfeld den „ inputMask “ erfüllt und der Validator einen zulässigen Status zurückgibt.

Siehe auch ` accepted()` und ` textEdited()`.

textEdited()

Dieses Signal wird immer dann ausgelöst, wenn der Text bearbeitet wird. Im Gegensatz zu „ textChanged() “ wird dieses Signal nicht ausgelöst, wenn der Text programmgesteuert geändert wird, beispielsweise durch Ändern des Werts der Eigenschaft „ text “ oder durch Aufruf von „ clear() “.

Siehe auch „ accepted()“ und „ editingFinished()“.

Methodendokumentation

void clear()

Löscht den Inhalt des Texteingabefelds und setzt die teilweise eingegebenen Zeichen aus einer Eingabemethode zurück.

Verwenden Sie diese Methode anstelle der Einstellung der Eigenschaft „ text “ auf eine leere Zeichenfolge.

Siehe auch „ QInputMethod::reset()“.

void copy()

Kopiert den aktuell ausgewählten Text in die System-Zwischenablage.

void cut()

Kopiert den aktuell ausgewählten Text in die System-Zwischenablage.

void deselect()

Hebt die aktive Textauswahl auf.

void ensureVisible(int position)

Blättert den Inhalt des Texteingabefelds so, dass das angegebene Zeichen position innerhalb der Grenzen des Texteingabefelds sichtbar ist.

Siehe auch „ autoScroll “.

string getText(int start, int end)

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

Wenn der TextInput einen inputMask enthält, umfasst die Länge auch die Maskierungszeichen.

void insert(int position, string text)

Fügt „ text “ in die „ TextInput “ unter position ein.

bool isRightToLeft(int start, int end)

Gibt „ true “ zurück, wenn die natürliche Leserichtung des Editortextes zwischen den Positionen start und end von rechts nach links verläuft.

void moveCursorSelection(int position, SelectionMode mode)

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

Wenn diese Methode aufgerufen wird, wird zusätzlich entweder der „ selectionStart “ oder der „ selectionEnd “ (je nachdem, welcher sich an der vorherigen Cursorposition befand) auf die angegebene Position gesetzt. Auf diese Weise können Sie den ausgewählten Textbereich ganz einfach erweitern oder verkleinern.

Der Auswahlmodus legt fest, ob die Auswahl zeichenweise oder wortweise aktualisiert wird. Wird kein Auswahlmodus angegeben, wird standardmäßig „ TextInput.SelectCharacters “ verwendet.

Nehmen wir zum Beispiel folgende Abfolge von Aufrufen:

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

Dadurch wird der Cursor auf Position 5 verschoben, das Ende der Auswahl von 5 auf 9 erweitert und anschließend das Ende der Auswahl von 9 auf 7 zurückgesetzt, sodass der Text von Position 5 bis 7 ausgewählt bleibt (das 6. und 7. Zeichen).

Die gleiche Abfolge mit ` TextInput.SelectWords` erweitert den Auswahlanfang bis zu einer Wortgrenze vor oder an Position 5 und den Auswahlende bis zu einer Wortgrenze an oder nach Position 9.

void paste()

Ersetzt den aktuell ausgewählten Text durch den Inhalt der System-Zwischenablage.

int positionAt(real x, real y, CursorPosition position)

Diese Funktion gibt die Zeichenposition bei x und y Pixel vom linken oberen Rand des textInput zurück. Position 0 liegt vor dem ersten Zeichen, Position 1 liegt nach dem ersten, aber vor dem zweiten Zeichen und so weiter bis zur Position text.length, die hinter allen Zeichen liegt.

Das bedeutet, dass diese Funktion für alle x-Werte vor dem ersten Zeichen 0 und für alle x-Werte nach dem letzten Zeichen text.length zurückgibt. Liegt der y-Wert oberhalb des Textes, entspricht die Position der des nächstgelegenen Zeichens in der ersten Zeile; liegt er unterhalb des Textes, wird die Position des nächstgelegenen Zeichens in der letzten Zeile zurückgegeben.

Der Parameter „ position “ legt fest, wie die Cursorposition ermittelt werden soll:

rect positionToRectangle(int pos)

Diese Funktion nimmt ein Zeichenposition- pos e entgegen und gibt das Rechteck zurück, das der Cursor einnehmen würde, wenn er an dieser Zeichenposition platziert wäre.

Dies ähnelt dem Setzen des cursorPosition und dem anschließenden Abfragen des Cursor-Rechtecks, jedoch wird der cursorPosition dabei nicht geändert.

void redo()

Führt die letzte Operation erneut aus, wenn „redo“ auf „ available “ gesetzt ist.

void remove(int start, int end)

Entfernt den Textabschnitt, der sich zwischen den Positionen „ start “ und „ end “ in der Datei „ TextInput “ befindet.

void select(int start, int end)

Bewirkt, dass der Text von start bis end markiert wird.

Liegt entweder der Start- oder der Endpunkt außerhalb des zulässigen Bereichs, wird die Auswahl nicht geändert.

Nach dem Aufruf dieser Methode wird selectionStart zum kleineren und selectionEnd zum größeren Wert (unabhängig von der Reihenfolge, in der die Parameter an diese Methode übergeben wurden).

Siehe auch „ selectionStart “ und „ selectionEnd “.

void selectAll()

Der gesamte Text wird ausgewählt.

void selectWord()

Wählt das Wort aus, das der aktuellen Cursorposition am nächsten liegt.

void undo()

Macht den letzten Vorgang rückgängig, sofern „undo“ auf „ available “ gesetzt ist. Hebt die aktuelle Auswahl auf und setzt den Auswahlbeginn auf die aktuelle Cursorposition.