TextArea QML Type

Mehrzeiliges Texteingabefeld. Mehr...

• Liste aller Mitglieder, einschließlich vererbter Mitglieder

Eigenschaften

• background : Item
• bottomInset : real (since QtQuick.Controls 2.5 (Qt 5.12))
• focusReason : enumeration
• hoverEnabled : bool (since QtQuick.Controls 2.1 (Qt 5.8))
• hovered : bool (since QtQuick.Controls 2.1 (Qt 5.8))
• implicitBackgroundHeight : real (since QtQuick.Controls 2.5 (Qt 5.12))
• implicitBackgroundWidth : real (since QtQuick.Controls 2.5 (Qt 5.12))
• leftInset : real (since QtQuick.Controls 2.5 (Qt 5.12))
• placeholderText : string
• placeholderTextColor : color (since QtQuick.Controls 2.5 (Qt 5.12))
• rightInset : real (since QtQuick.Controls 2.5 (Qt 5.12))
• topInset : real (since QtQuick.Controls 2.5 (Qt 5.12))

Zugehörige Eigenschaften

• flickable : TextArea

Signale

• pressAndHold(MouseEvent event)
• pressed(MouseEvent event) (since QtQuick.Controls 2.1 (Qt 5.8))
• released(MouseEvent event) (since QtQuick.Controls 2.1 (Qt 5.8))

Ausführliche Beschreibung

TextArea ist ein mehrzeiliger Texteditor. TextArea erweitert „ TextEdit “ um eine „ placeholder text “-Funktionalität und fügt Gestaltungselemente hinzu.

TextArea {
    placeholderText: qsTr("Enter description")
}

TextArea ist von sich aus nicht scrollbar. Insbesondere auf Plattformen mit begrenzter Bildschirmgröße ist es oft vorteilhaft, ganze Anwendungsseiten scrollbar zu gestalten. Auf einer solchen scrollbaren Seite verhält sich ein nicht scrollbares TextArea möglicherweise besser als verschachtelte scrollbare Steuerelemente. Beachten Sie jedoch, dass in einem solchen Szenario die Hintergrunddekoration des TextArea zusammen mit dem restlichen scrollbaren Inhalt mitläuft.

Scrollbares TextArea

Wenn Sie ein TextArea-Feld scrollbar machen möchten, beispielsweise wenn es eine gesamte Anwendungsseite einnimmt, kann es in ein ` ScrollView`-Element eingefügt werden.

ScrollView {
    id: view
    anchors.fill: parent

    TextArea {
        text: "TextArea\n...\n...\n...\n...\n...\n...\n"
    }
}

Ein TextArea, der in einem „ ScrollView “ platziert ist, verhält sich wie folgt:

• Passt die Inhaltsgröße automatisch an
• Stellt sicher, dass die Hintergrunddekoration an Ort und Stelle bleibt
• Schneidet den Inhalt zu

Tab-Fokus

Standardmäßig führt das Drücken der Tabulatortaste, während das TextArea-Steuerelement ein „ active focus “ enthält, dazu, dass ein Tabulatorzeichen in das Steuerelement selbst eingegeben wird. Damit die Tabulatortaste den aktiven Fokus an ein anderes Element weitergibt, verwenden Sie die folgenden „ KeyNavigation “-Eigenschaften:

TextField {
    id: textField
}

TextArea {
    KeyNavigation.priority: KeyNavigation.BeforeItem
    KeyNavigation.tab: textField
}

Siehe auch „ TextField“ , „Anpassen von TextArea“ und „Eingabesteuerelemente“.

Dokumentation zu den Eigenschaften

background : Item

Diese Eigenschaft enthält das Hintergrundelement.

Siehe auch „Anpassen von TextArea“.

bottomInset : real [since QtQuick.Controls 2.5 (Qt 5.12)]

Diese Eigenschaft legt den unteren Rand des Hintergrunds fest.

Diese Eigenschaft wurde in QtQuick.Controls 2.5 (Qt 5.12) eingeführt.

Siehe auch Control Layout und topInset.

focusReason : enumeration

Diese Eigenschaft enthält den Grund für die letzte Fokusänderung.

hoverEnabled : bool [since QtQuick.Controls 2.1 (Qt 5.8)]

Diese Eigenschaft legt fest, ob der Textbereich Hover-Ereignisse akzeptiert. Der Standardwert ist „ true “.

Diese Eigenschaft wurde in QtQuick.Controls 2.1 (Qt 5.8) eingeführt.

Siehe auch „ hovered “.

hovered : bool [read-only, since QtQuick.Controls 2.1 (Qt 5.8)]

Diese Eigenschaft gibt an, ob der Mauszeiger über dem Textfeld schwebt.

Diese Eigenschaft wurde in QtQuick.Controls 2.1 (Qt 5.8) eingeführt.

Siehe auch hoverEnabled.

implicitBackgroundHeight : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]

Diese Eigenschaft enthält die implizite Hintergrundhöhe.

Der Wert entspricht ` background ? background.implicitHeight : 0`.

Diese Eigenschaft wurde in QtQuick.Controls 2.5 (Qt 5.12) eingeführt.

Siehe auch „ implicitBackgroundWidth “.

implicitBackgroundWidth : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]

Diese Eigenschaft enthält die implizite Hintergrundbreite.

Der Wert entspricht „ background ? background.implicitWidth : 0 “.

Diese Eigenschaft wurde in QtQuick.Controls 2.5 (Qt 5.12) eingeführt.

Siehe auch „ implicitBackgroundHeight “.

leftInset : real [since QtQuick.Controls 2.5 (Qt 5.12)]

Diese Eigenschaft legt den linken Abstand zum Hintergrund fest.

Diese Eigenschaft wurde in QtQuick.Controls 2.5 (Qt 5.12) eingeführt.

Siehe auch Control Layout und rightInset.

placeholderText : string

Diese Eigenschaft enthält den kurzen Hinweis, der im Textfeld angezeigt wird, bevor der Benutzer einen Wert eingibt.

placeholderTextColor : color [since QtQuick.Controls 2.5 (Qt 5.12)]

Diese Eigenschaft enthält die Farbe von „ placeholderText “.

Diese Eigenschaft wurde in QtQuick.Controls 2.5 (Qt 5.12) eingeführt.

Siehe auch „ placeholderText “.

rightInset : real [since QtQuick.Controls 2.5 (Qt 5.12)]

Diese Eigenschaft legt den rechten Abstand zum Hintergrund fest.

Diese Eigenschaft wurde in QtQuick.Controls 2.5 (Qt 5.12) eingeführt.

Siehe auch Control Layout und leftInset.

topInset : real [since QtQuick.Controls 2.5 (Qt 5.12)]

Diese Eigenschaft legt den oberen Rand des Hintergrunds fest.

Diese Eigenschaft wurde in QtQuick.Controls 2.5 (Qt 5.12) eingeführt.

Siehe auch Control Layout und bottomInset.

Dokumentation zu den angehängten Eigenschaften

TextArea.flickable : TextArea [attached]

Diese Eigenschaft fügt einem „ Flickable “ ein Textfeld hinzu.

Siehe auch „ ScrollBar “, „ ScrollIndicator “ und „ Scrollable TextArea “.

Signal-Dokumentation

pressAndHold(MouseEvent event)

Dieses Signal wird bei einem langen Tastendruck ausgelöst (die Verzögerung hängt vom Plattform-Plugin ab). Der Parameter „ event “ liefert Informationen zum Tastendruck, darunter die x- und y-Koordinaten des Druckpunkts sowie die betätigte Taste.

Siehe auch „ pressed “ und „ released “.

[since QtQuick.Controls 2.1 (Qt 5.8)] pressed(MouseEvent event)

Dieses Signal wird ausgelöst, wenn der Benutzer auf den Textbereich drückt. Der Parameter „ event “ liefert Informationen zum Druckvorgang, darunter die x- und y-Koordinaten des Druckpunkts sowie die betätigte Taste.

Dieses Signal wurde in QtQuick.Controls 2.1 (Qt 5.8) eingeführt.

Siehe auch „ released “ und „ pressAndHold “.

[since QtQuick.Controls 2.1 (Qt 5.8)] released(MouseEvent event)

Dieses Signal wird ausgelöst, wenn der Benutzer den Textbereich loslässt. Der Parameter „ event “ liefert Informationen zum Loslassen, darunter die x- und y-Koordinaten des Klicks sowie die gedrückte Taste.

Dieses Signal wurde in QtQuick.Controls 2.1 (Qt 5.8) eingeführt.

Siehe auch „ pressed “ und „ pressAndHold “.