TextField QML Type
Einzeiliges Texteingabefeld. Mehr...
| Import Statement: | import QtQuick.Controls |
| Inherits: |
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))
Ausführliche Beschreibung
„TextField“ ist ein einzeiliger Texteditor. „TextField“ erweitert „ TextInput “ um eine „ placeholder text “-Funktionalität und fügt eine Dekoration hinzu.
| Ein Textfeld im Normalzustand. |
| Ein Textfeld, das den Fokus hat. |
| Ein Textfeld, das deaktiviert ist. |
TextField {
placeholderText: qsTr("Enter name")
}Siehe auch „ TextArea“ , „Anpassen von TextField“ und „Eingabesteuerelemente“.
Dokumentation zu den Eigenschaften
background : Item
Diese Eigenschaft enthält das Hintergrundelement.
Hinweis: Wenn für das Hintergrundelement keine explizite Größe angegeben ist, passt es sich automatisch an die Größe des Steuerelements an. In den meisten Fällen ist es nicht erforderlich, 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 ersetzen, sollten Sie auch eine sinnvolle implizite Größe dafür festlegen (es sei denn, es handelt sich um ein Element wie „ Image “, das über eine eigene implizite Größe verfügt).
Siehe auch „TextField anpassen“.
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 den letzten Fokuswechsel.
Hinweis: Diese Eigenschaft gibt nicht an, ob das Element über „ active focus “ verfügt, sondern den Grund, warum das Element den Fokus erhalten oder verloren hat.
| Konstante | Beschreibung |
|---|---|
Qt.MouseFocusReason | Es ist eine Mausaktion aufgetreten. |
Qt.TabFocusReason | Die Tabulatortaste wurde gedrückt. |
Qt.BacktabFocusReason | Es erfolgte ein „Backtab“. Die Eingabe hierfür kann die Umschalt- oder Strg-Taste beinhalten, z. B. Umschalt+Tab. |
Qt.ActiveWindowFocusReason | Das Fenstersystem hat dieses Fenster entweder aktiviert oder deaktiviert. |
Qt.PopupFocusReason | Die Anwendung hat ein Popup-Fenster geöffnet/geschlossen, das den Tastaturfokus übernommen/freigegeben hat. |
Qt.ShortcutFocusReason | Der Benutzer hat die Buddy-Tastenkombination einer Beschriftung eingegeben |
Qt.MenuBarFocusReason | Die Menüleiste hat den Fokus erhalten. |
Qt.OtherFocusReason | Ein anderer Grund, der in der Regel anwendungsspezifisch ist. Hinweis: Verwenden Sie vorzugsweise „ QtQuick.Controls::Control::focusReason “ anstelle dieser Eigenschaft. |
hoverEnabled : bool [since QtQuick.Controls 2.1 (Qt 5.8)]
Diese Eigenschaft legt fest, ob das Textfeld Hover-Ereignisse 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 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 Rand des Hintergrunds 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 Hinweis, der im Feld „ 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 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.
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 Information, welche Taste gedrückt wurde.
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 ausgelöst, wenn der Benutzer auf das Textfeld drückt. Der Parameter „ event “ liefert Informationen zum Druckvorgang, darunter die x- und y-Koordinaten des Druckpunkts sowie die Art der gedrückten Taste.
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 ausgelöst, wenn der Benutzer das Textfeld loslässt. Der Parameter „ event “ liefert Informationen zum Loslassen, darunter die x- und y-Koordinaten des Druckpunkts sowie die gedrückte Taste.
Hinweis: Der entsprechende Handler lautet „ onReleased “.
Dieses Signal wurde in QtQuick.Controls 2.1 (Qt 5.8) eingeführt.
Siehe auch „ pressed “ und „ pressAndHold “.
© 2026 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.
