Qt Quick Text Input Handling and Validators

Text Visual Types

Qt Quick provides several types to display text onto the screen. The Text type will display formatted text onto the screen, the TextEdit type will place a multiline line edit onto the screen, and the TextInput will place a single editable line field onto the screen.

To learn more about their specific features and properties, visit their respective documentation.

Validating Input Text

The validator types enforce the type and format of TextInput objects.

Qt Quick Text Validators

Types that validate text input

Column {
    spacing: 10

    Text {
        text: "Enter a value from 0 to 2000"
    }
    TextInput {
        focus: true
        validator: IntValidator { bottom:0; top: 2000}
    }
}

The validator types bind to TextInput's validator property.

Column {
    spacing: 10

    Text {
        text: "Which basket?"
    }
    TextInput {
        focus: true
        validator: RegExpValidator { regExp: /fruit basket/ }
    }
}

The regular expression in the snippet will only allow the inputted text to be fruit basket.

Note that QML parses JavaScript regular expressions, while Qt's QRegExp class' regular expressions are based on Perl regular expressions.

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