Single-line text input field. 更多...
导入语句: | import QtQuick.Controls 2.2 |
Since: | Qt 5.7 |
继承: | TextInput |
TextField is a single line text editor. TextField extends TextInput 采用 placeholder text functionality, and adds decoration.
![]() |
A text field in its normal state. |
![]() |
A text field that has active focus. |
![]() |
A text field that is disabled. |
TextField {
placeholderText: qsTr("Enter name")
}
另请参阅 TextArea , Customizing TextField ,和 输入控件 .
background : Item |
此特性保持背景项。
注意: If the background item has no explicit size specified, it automatically follows the control's size. In most cases, there is no need to specify width or height for a background item.
注意: Most controls use the implicit size of the background item to calculate the implicit size of the control itself. If you replace the background item with a custom one, you should also consider providing a sensible implicit size for it (unless it is an item like 图像 which has its own implicit size).
另请参阅 Customizing TextField .
[since QtQuick.Controls 2.5 (Qt 5.12)] bottomInset : real |
This property holds the bottom inset for the background.
该特性在 QtQuick.Controls 2.5 (Qt 5.12) 引入。
另请参阅 Control Layout and topInset .
focusReason : enumeration |
此特性保持最后聚焦更改的原因。
注意: This property does not indicate whether the control has active focus , but the reason why the control either gained or lost focus.
常量 | 描述 |
---|---|
Qt.MouseFocusReason
|
发生鼠标动作。 |
Qt.TabFocusReason
|
按下 Tab 键。 |
Qt.BacktabFocusReason
|
发生 Backtab。输入可能包括 Shift 或 Control 键;如 Shift+Tab。 |
Qt.ActiveWindowFocusReason
|
窗口系统使此窗口活动或不活动。 |
Qt.PopupFocusReason
|
应用程序打开/关闭弹出窗口,抓取/释放键盘焦点。 |
Qt.ShortcutFocusReason
|
用户键入标签的好友快捷方式 |
Qt.MenuBarFocusReason
|
菜单栏获得聚焦。 |
Qt.OtherFocusReason
|
另一原因,通常特定于应用程序。 |
另请参阅 Item::activeFocus .
[since QtQuick.Controls 2.1 (Qt 5.8)] hoverEnabled : bool |
This property determines whether the text field accepts hover events. The default value is
false
.
该特性在 QtQuick.Controls 2.1 (Qt 5.8) 引入。
另请参阅 hovered .
[read-only, since QtQuick.Controls 2.1 (Qt 5.8)] hovered : bool |
This property holds whether the text field is hovered.
该特性在 QtQuick.Controls 2.1 (Qt 5.8) 引入。
另请参阅 hoverEnabled .
[read-only, since QtQuick.Controls 2.5 (Qt 5.12)] implicitBackgroundHeight : real |
This property holds the implicit background height.
值等于
background ? background.implicitHeight : 0
.
该特性在 QtQuick.Controls 2.5 (Qt 5.12) 引入。
另请参阅 implicitBackgroundWidth .
[read-only, since QtQuick.Controls 2.5 (Qt 5.12)] implicitBackgroundWidth : real |
This property holds the implicit background width.
值等于
background ? background.implicitWidth : 0
.
该特性在 QtQuick.Controls 2.5 (Qt 5.12) 引入。
另请参阅 implicitBackgroundHeight .
[since QtQuick.Controls 2.5 (Qt 5.12)] leftInset : real |
This property holds the left inset for the background.
该特性在 QtQuick.Controls 2.5 (Qt 5.12) 引入。
另请参阅 Control Layout and rightInset .
placeholderText : string |
This property holds the hint that is displayed in the TextField before the user enters text.
[since QtQuick.Controls 2.5 (Qt 5.12)] placeholderTextColor : color |
This property holds the color of placeholderText .
该特性在 QtQuick.Controls 2.5 (Qt 5.12) 引入。
另请参阅 placeholderText .
[since QtQuick.Controls 2.5 (Qt 5.12)] rightInset : real |
This property holds the right inset for the background.
该特性在 QtQuick.Controls 2.5 (Qt 5.12) 引入。
另请参阅 Control Layout and leftInset .
[since QtQuick.Controls 2.5 (Qt 5.12)] topInset : real |
This property holds the top inset for the background.
该特性在 QtQuick.Controls 2.5 (Qt 5.12) 引入。
另请参阅 Control Layout and bottomInset .
pressAndHold ( MouseEvent event ) |
This signal is emitted when there is a long press (the delay depends on the platform plugin). The event parameter provides information about the press, including the x and y coordinates of the press, and which button is pressed.
注意:
相应处理程序是
onPressAndHold
.
[since QtQuick.Controls 2.1 (Qt 5.8)]
pressed
(
MouseEvent
event
)
|
This signal is emitted when the text field is pressed by the user. The event parameter provides information about the press, including the x and y coordinates of the press, and which button is pressed.
注意:
相应处理程序是
onPressed
.
该信号在 QtQuick.Controls 2.1 (Qt 5.8) 引入。
另请参阅 released and pressAndHold .
[since QtQuick.Controls 2.1 (Qt 5.8)]
released
(
MouseEvent
event
)
|
This signal is emitted when the text field is released by the user. The event parameter provides information about the release, including the x and y coordinates of the press, and which button is pressed.
注意:
相应处理程序是
onReleased
.
该信号在 QtQuick.Controls 2.1 (Qt 5.8) 引入。
另请参阅 pressed and pressAndHold .