Back to Qt.io
Contact Us Blog Download Qt

TextArea QML Type

Mehrzeiliger Texteingabebereich. Mehr...

Import Statement: import QtQuick.Controls
Inherits:

TextEdit

Eigenschaften

Beigefügte Eigenschaften

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

Detaillierte Beschreibung

TextArea ist ein mehrzeiliger Texteditor. TextArea erweitert TextEdit mit einer placeholder text Funktionalität und fügt Dekoration hinzu.

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

TextArea selbst ist nicht scrollbar. Besonders auf Plattformen mit eingeschränkter Bildschirmgröße ist es oft besser, ganze Anwendungsseiten scrollbar zu machen. Auf einer solchen scrollbaren Seite kann sich eine nicht scrollbare TextArea besser verhalten als verschachtelte scrollbare Steuerelemente. Beachten Sie jedoch, dass in einem solchen Szenario die Hintergrunddekoration der TextArea zusammen mit dem Rest des scrollbaren Inhalts scrollt.

Scrollbare TextArea

Wenn Sie eine TextArea scrollbar machen wollen, z. B. wenn sie sich über eine ganze Anwendungsseite erstreckt, kann sie innerhalb einer ScrollView platziert werden.

ScrollView {
    id: view
    anchors.fill: parent

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

Ein TextArea, das innerhalb eines ScrollView platziert wird, bewirkt Folgendes:

  • Stellt die Größe des Inhalts automatisch ein
  • stellt sicher, dass die Hintergrunddekoration an ihrem Platz bleibt
  • Beschneidet den Inhalt

Tabulator-Fokus

Wenn Sie die Tabulatortaste drücken, während das TextArea active focus hat, wird standardmäßig ein Tabulatorzeichen in das Steuerelement selbst eingegeben. Um den aktiven Fokus der Tabulatortaste an ein anderes Element weiterzugeben, verwenden Sie die beigefügten KeyNavigation Eigenschaften:

TextField {
    id: textField
}

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

Siehe auch TextField, Customizing TextArea und Input Controls.

Eigenschaft Dokumentation

background : Item

Diese Eigenschaft enthält das Hintergrundelement.

Hinweis: Wenn für das Hintergrundelement keine explizite Größe angegeben ist, folgt es automatisch der Größe des Steuerelements. In den meisten Fällen ist es nicht notwendig, Breite oder Höhe für ein Hintergrundelement anzugeben.

Hinweis: Die meisten Steuerelemente verwenden die implizite Größe des Hintergrundelements, um die implizite Größe des Steuerelements selbst zu berechnen. Wenn Sie das Hintergrundelement durch ein benutzerdefiniertes Element ersetzen, sollten Sie auch eine sinnvolle implizite Größe für dieses Element vorsehen (es sei denn, es handelt sich um ein Element wie Image, das seine eigene implizite Größe hat).

Siehe auch TextArea anpassen.


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

Diese Eigenschaft enthält den unteren Einschub für den Hintergrund.

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 den letzten Fokuswechsel.

Hinweis: Diese Eigenschaft zeigt nicht an, ob das Element active focus ist, sondern den Grund, warum das Element den Fokus entweder erhalten oder verloren hat.

KonstanteBeschreibung
Qt.MouseFocusReasonEine Mausaktion ist aufgetreten.
Qt.TabFocusReasonDie Tabulatortaste wurde gedrückt.
Qt.BacktabFocusReasonEin Backtab ist aufgetreten. Die Eingabe hierfür kann die Umschalt- oder Steuerungstaste umfassen, z. B. Umschalt+Tab.
Qt.ActiveWindowFocusReasonDas Fenstersystem hat dieses Fenster entweder aktiv oder inaktiv gemacht.
Qt.PopupFocusReasonDie Anwendung öffnete/schloss ein Popup-Fenster, das den Tastaturfokus aufnahm/freigab.
Qt.ShortcutFocusReasonDer Benutzer tippte das Tastaturkürzel eines Etiketts ein.
Qt.MenuBarFocusReasonDie Menüleiste erhielt den Fokus.
Qt.OtherFocusReasonEin anderer Grund, normalerweise anwendungsspezifisch.

Hinweis: Bevorzugen Sie QtQuick.Controls::Control::focusReason für diese Eigenschaft.


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

Diese Eigenschaft bestimmt, ob der Textbereich Schwebeereignisse 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 Textbereich mit dem Mauszeiger bewegt wird.

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 ist gleich 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 ist gleich 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 enthält den linken Einschub für den Hintergrund.

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 Textbereich 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 enthält den rechten Einschub für den Hintergrund.

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 enthält den oberen Einschub für den Hintergrund.

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

Siehe auch Control Layout und bottomInset.


Dokumentation der Eigenschaft Attached

TextArea.flickable : TextArea

Mit dieser Eigenschaft wird ein Textbereich an ein Flickable angehängt.

Siehe auch ScrollBar, ScrollIndicator, und Scrollable TextArea.


Signal Dokumentation

pressAndHold(MouseEvent event)

Dieses Signal wird ausgegeben, wenn ein langer Druck erfolgt (die Verzögerung hängt vom Plattform-Plugin ab). Der Parameter event liefert Informationen über den Druck, einschließlich der x- und y-Koordinaten des Drucks und der gedrückten Taste.

Hinweis: Der entsprechende Handler ist onPressAndHold.

Siehe auch pressed und released.


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

Dieses Signal wird ausgegeben, wenn der Textbereich vom Benutzer gedrückt wird. Der Parameter event liefert Informationen über die Betätigung, einschließlich der x- und y-Koordinaten des Drucks und der gedrückten Schaltfläche.

Hinweis: Der entsprechende Handler ist onPressed.

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 ausgegeben, wenn der Textbereich durch den Benutzer losgelassen wird. Der Parameter event liefert Informationen über das Loslassen, einschließlich der x- und y-Koordinaten des Drucks und der gedrückten Taste.

Hinweis: Der entsprechende Handler ist onReleased.

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

Siehe auch pressed und pressAndHold.


© 2025 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.