TextField QML Type

Einzeiliges Texteingabefeld. Mehr...

Import Statement:	`import QtQuick.Controls`
Inherits:	TextInput

Liste aller Mitglieder, einschließlich geerbter 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))

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

TextField ist ein einzeiliger Texteditor. TextField erweitert TextInput mit einer placeholder text Funktionalität und fügt Dekoration hinzu.

	Ein Textfeld in seinem normalen Zustand.
	Ein Textfeld, das den aktiven Fokus hat.
	Ein Textfeld, das deaktiviert ist.

TextField {
    placeholderText: qsTr("Enter name")
}

Siehe auch TextArea, TextField anpassen 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 TextField 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.

Konstante	Beschreibung
`Qt.MouseFocusReason`	Eine Mausaktion ist aufgetreten.
`Qt.TabFocusReason`	Die Tabulatortaste wurde gedrückt.
`Qt.BacktabFocusReason`	Ein Backtab ist aufgetreten. Die Eingabe hierfür kann die Umschalt- oder Steuerungstaste umfassen, z. B. Umschalt+Tab.
`Qt.ActiveWindowFocusReason`	Das Fenstersystem hat dieses Fenster entweder aktiv oder inaktiv gemacht.
`Qt.PopupFocusReason`	Die Anwendung öffnete/schloss ein Pop-up, das den Tastaturfokus aufnahm/freigab.
`Qt.ShortcutFocusReason`	Der Benutzer tippte das Tastaturkürzel eines Etiketts ein.
`Qt.MenuBarFocusReason`	Die Menüleiste erhielt den Fokus.
`Qt.OtherFocusReason`	Ein 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 das Textfeld Schwebeereignisse akzeptiert. Der Standardwert ist false.

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 das Textfeld 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 Hinweis, der in TextField angezeigt wird, bevor der Benutzer Text 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 Einschub für den 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 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.

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 das Textfeld vom Benutzer gedrückt wird. Der Parameter event liefert Informationen über die Betätigung, einschließlich der x- und y-Koordinaten der Betätigung 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 das Textfeld 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.