EnterKeyAction QML Type

Provides attached properties for customizing the enter key. More...

Import Statement: import QtQuick.VirtualKeyboard 2.0

Attached Properties

Detailed Description

The EnterKeyAction type provides attached properties which allows customizing the enter key button of the keyboard.

The EnterKeyAction must be used directly inside the item receiving input focus, e.g. TextInput.

For example:

TextInput {
    id: myInput
    EnterKeyAction.enabled: myInput.text.length > 0 || myInput.inputMethodComposing
    EnterKeyAction.label: "Next"
    Keys.onReleased: {
        if (event.key === Qt.Key_Return) {
            // execute action
        }
    }
}

Attached Property Documentation

EnterKeyAction.actionId : int

Sets the action id for the enter key in virtual keyboard. When the action id is set, it takes preference over the label and sets the icon for the enter key.

  • EnterKeyAction.None No action defined.
  • EnterKeyAction.Go Action performs go operation. For example taking user to the entered url.
  • EnterKeyAction.Search Action performs search operation.
  • EnterKeyAction.Send Action sends the entered text.
  • EnterKeyAction.Next Action moves the input focus to the next field accepting text input.
  • EnterKeyAction.Done Same as EnterKeyAction.Next, except all the text input is done.

EnterKeyAction.enabled : bool

Enables or disables the enter key button in virtual keyboard.


EnterKeyAction.label : string

Sets the label for the enter key in virtual keyboard.


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