TextInput

component fbx.ui.control.TextInput
property text

A string corresponding to the entered text. This property is updated upon validation of input value.

../../../_images/textinput_focus.png

TextInput editing a text

property displayText

Text string the user is supposed to see. If control is in password mode, this contains a star character string.

property placeholderText

Text visible in the control when it has no text entered. This should be used as an invite message for user input.

../../../_images/textinput_empty.png

TextInput placeholder text:

TextInput {
    placeholderText: "Username"
    text: ""
    onAccepted: console.log("Entered username '" + text + "'");
}
signal accepted()

Raised when text got accepted by user and validator.

property echoMode

Specifies how the text should be displayed in the TextInput.

  • TextInput.Normal - Displays the text as it is. (Default)

  • TextInput.Password - Displays asterixes instead of characters.

  • TextInput.NoEcho - Displays nothing.

  • TextInput.PasswordEchoOnEdit - Displays characters as they are entered while editing, otherwise displays asterisks.

property font

Usual text font attributes.

property maximumLength

Maximal number of allowed characters in the input line. Defaults to 32767.

property editing

Whether user is currently editing the widget. This may change to false without the text actually changing, if user cancels its input.

property enabled

Whether the widget accepts user interaction.

property cursorPosition

Current cursor position in the input line.

property inputMethodHints

Hint for virtual keyboard presentation. Can take a value from:

  • Qt.ImhDigitsOnly

  • Qt.ImhUrlCharactersOnly

  • Qt.ImhEmailCharactersOnly

When using Qt.ImhDigitsOnly, virtual keyboard may not appear at all.