| /**************************************************************************** |
| ** |
| ** Copyright (C) 2016 The Qt Company Ltd. |
| ** Contact: https://www.qt.io/licensing/ |
| ** |
| ** This file is part of the QtQuick module of the Qt Toolkit. |
| ** |
| ** $QT_BEGIN_LICENSE:LGPL$ |
| ** Commercial License Usage |
| ** Licensees holding valid commercial Qt licenses may use this file in |
| ** accordance with the commercial license agreement provided with the |
| ** Software or, alternatively, in accordance with the terms contained in |
| ** a written agreement between you and The Qt Company. For licensing terms |
| ** and conditions see https://www.qt.io/terms-conditions. For further |
| ** information use the contact form at https://www.qt.io/contact-us. |
| ** |
| ** GNU Lesser General Public License Usage |
| ** Alternatively, this file may be used under the terms of the GNU Lesser |
| ** General Public License version 3 as published by the Free Software |
| ** Foundation and appearing in the file LICENSE.LGPL3 included in the |
| ** packaging of this file. Please review the following information to |
| ** ensure the GNU Lesser General Public License version 3 requirements |
| ** will be met: https://www.gnu.org/licenses/lgpl-3.0.html. |
| ** |
| ** GNU General Public License Usage |
| ** Alternatively, this file may be used under the terms of the GNU |
| ** General Public License version 2.0 or (at your option) the GNU General |
| ** Public license version 3 or any later version approved by the KDE Free |
| ** Qt Foundation. The licenses are as published by the Free Software |
| ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3 |
| ** included in the packaging of this file. Please review the following |
| ** information to ensure the GNU General Public License requirements will |
| ** be met: https://www.gnu.org/licenses/gpl-2.0.html and |
| ** https://www.gnu.org/licenses/gpl-3.0.html. |
| ** |
| ** $QT_END_LICENSE$ |
| ** |
| ****************************************************************************/ |
| |
| #ifndef QQUICKTEXTINPUT_P_H |
| #define QQUICKTEXTINPUT_P_H |
| |
| // |
| // W A R N I N G |
| // ------------- |
| // |
| // This file is not part of the Qt API. It exists purely as an |
| // implementation detail. This header file may change from version to |
| // version without notice, or even be removed. |
| // |
| // We mean it. |
| // |
| |
| #include "qquickimplicitsizeitem_p.h" |
| #include <QtGui/qtextoption.h> |
| #include <QtGui/qvalidator.h> |
| |
| QT_BEGIN_NAMESPACE |
| |
| class QQuickTextInputPrivate; |
| class QValidator; |
| class Q_QUICK_PRIVATE_EXPORT QQuickTextInput : public QQuickImplicitSizeItem |
| { |
| Q_OBJECT |
| |
| Q_PROPERTY(QString text READ text WRITE setText NOTIFY textChanged) |
| Q_PROPERTY(int length READ length NOTIFY textChanged) |
| Q_PROPERTY(QColor color READ color WRITE setColor NOTIFY colorChanged) |
| Q_PROPERTY(QColor selectionColor READ selectionColor WRITE setSelectionColor NOTIFY selectionColorChanged) |
| Q_PROPERTY(QColor selectedTextColor READ selectedTextColor WRITE setSelectedTextColor NOTIFY selectedTextColorChanged) |
| Q_PROPERTY(QFont font READ font WRITE setFont NOTIFY fontChanged) |
| Q_PROPERTY(HAlignment horizontalAlignment READ hAlign WRITE setHAlign RESET resetHAlign NOTIFY horizontalAlignmentChanged) |
| Q_PROPERTY(HAlignment effectiveHorizontalAlignment READ effectiveHAlign NOTIFY effectiveHorizontalAlignmentChanged) |
| Q_PROPERTY(VAlignment verticalAlignment READ vAlign WRITE setVAlign NOTIFY verticalAlignmentChanged) |
| Q_PROPERTY(WrapMode wrapMode READ wrapMode WRITE setWrapMode NOTIFY wrapModeChanged) |
| |
| Q_PROPERTY(bool readOnly READ isReadOnly WRITE setReadOnly NOTIFY readOnlyChanged) |
| Q_PROPERTY(bool cursorVisible READ isCursorVisible WRITE setCursorVisible NOTIFY cursorVisibleChanged) |
| Q_PROPERTY(int cursorPosition READ cursorPosition WRITE setCursorPosition NOTIFY cursorPositionChanged) |
| Q_PROPERTY(QRectF cursorRectangle READ cursorRectangle NOTIFY cursorRectangleChanged) |
| Q_PROPERTY(QQmlComponent *cursorDelegate READ cursorDelegate WRITE setCursorDelegate NOTIFY cursorDelegateChanged) |
| Q_PROPERTY(bool overwriteMode READ overwriteMode WRITE setOverwriteMode NOTIFY overwriteModeChanged) |
| Q_PROPERTY(int selectionStart READ selectionStart NOTIFY selectionStartChanged) |
| Q_PROPERTY(int selectionEnd READ selectionEnd NOTIFY selectionEndChanged) |
| Q_PROPERTY(QString selectedText READ selectedText NOTIFY selectedTextChanged) |
| |
| Q_PROPERTY(int maximumLength READ maxLength WRITE setMaxLength NOTIFY maximumLengthChanged) |
| Q_PROPERTY(QValidator* validator READ validator WRITE setValidator NOTIFY validatorChanged) |
| Q_PROPERTY(QString inputMask READ inputMask WRITE setInputMask NOTIFY inputMaskChanged) |
| Q_PROPERTY(Qt::InputMethodHints inputMethodHints READ inputMethodHints WRITE setInputMethodHints NOTIFY inputMethodHintsChanged) |
| |
| Q_PROPERTY(bool acceptableInput READ hasAcceptableInput NOTIFY acceptableInputChanged) |
| Q_PROPERTY(EchoMode echoMode READ echoMode WRITE setEchoMode NOTIFY echoModeChanged) |
| Q_PROPERTY(bool activeFocusOnPress READ focusOnPress WRITE setFocusOnPress NOTIFY activeFocusOnPressChanged) |
| Q_PROPERTY(QString passwordCharacter READ passwordCharacter WRITE setPasswordCharacter NOTIFY passwordCharacterChanged) |
| Q_PROPERTY(int passwordMaskDelay READ passwordMaskDelay WRITE setPasswordMaskDelay RESET resetPasswordMaskDelay NOTIFY passwordMaskDelayChanged REVISION 4) |
| Q_PROPERTY(QString displayText READ displayText NOTIFY displayTextChanged) |
| Q_PROPERTY(QString preeditText READ preeditText NOTIFY preeditTextChanged REVISION 7) |
| Q_PROPERTY(bool autoScroll READ autoScroll WRITE setAutoScroll NOTIFY autoScrollChanged) |
| Q_PROPERTY(bool selectByMouse READ selectByMouse WRITE setSelectByMouse NOTIFY selectByMouseChanged) |
| Q_PROPERTY(SelectionMode mouseSelectionMode READ mouseSelectionMode WRITE setMouseSelectionMode NOTIFY mouseSelectionModeChanged) |
| Q_PROPERTY(bool persistentSelection READ persistentSelection WRITE setPersistentSelection NOTIFY persistentSelectionChanged) |
| Q_PROPERTY(bool canPaste READ canPaste NOTIFY canPasteChanged) |
| Q_PROPERTY(bool canUndo READ canUndo NOTIFY canUndoChanged) |
| Q_PROPERTY(bool canRedo READ canRedo NOTIFY canRedoChanged) |
| Q_PROPERTY(bool inputMethodComposing READ isInputMethodComposing NOTIFY inputMethodComposingChanged) |
| Q_PROPERTY(qreal contentWidth READ contentWidth NOTIFY contentSizeChanged) |
| Q_PROPERTY(qreal contentHeight READ contentHeight NOTIFY contentSizeChanged) |
| Q_PROPERTY(RenderType renderType READ renderType WRITE setRenderType NOTIFY renderTypeChanged) |
| |
| Q_PROPERTY(qreal padding READ padding WRITE setPadding RESET resetPadding NOTIFY paddingChanged REVISION 6) |
| Q_PROPERTY(qreal topPadding READ topPadding WRITE setTopPadding RESET resetTopPadding NOTIFY topPaddingChanged REVISION 6) |
| Q_PROPERTY(qreal leftPadding READ leftPadding WRITE setLeftPadding RESET resetLeftPadding NOTIFY leftPaddingChanged REVISION 6) |
| Q_PROPERTY(qreal rightPadding READ rightPadding WRITE setRightPadding RESET resetRightPadding NOTIFY rightPaddingChanged REVISION 6) |
| Q_PROPERTY(qreal bottomPadding READ bottomPadding WRITE setBottomPadding RESET resetBottomPadding NOTIFY bottomPaddingChanged REVISION 6) |
| |
| public: |
| QQuickTextInput(QQuickItem * parent=nullptr); |
| ~QQuickTextInput(); |
| |
| void componentComplete() override; |
| |
| enum EchoMode {//To match QLineEdit::EchoMode |
| Normal, |
| NoEcho, |
| Password, |
| PasswordEchoOnEdit |
| }; |
| Q_ENUM(EchoMode) |
| |
| enum HAlignment { |
| AlignLeft = Qt::AlignLeft, |
| AlignRight = Qt::AlignRight, |
| AlignHCenter = Qt::AlignHCenter |
| }; |
| Q_ENUM(HAlignment) |
| |
| enum VAlignment { |
| AlignTop = Qt::AlignTop, |
| AlignBottom = Qt::AlignBottom, |
| AlignVCenter = Qt::AlignVCenter |
| }; |
| Q_ENUM(VAlignment) |
| |
| enum WrapMode { |
| NoWrap = QTextOption::NoWrap, |
| WordWrap = QTextOption::WordWrap, |
| WrapAnywhere = QTextOption::WrapAnywhere, |
| WrapAtWordBoundaryOrAnywhere = QTextOption::WrapAtWordBoundaryOrAnywhere, // COMPAT |
| Wrap = QTextOption::WrapAtWordBoundaryOrAnywhere |
| }; |
| Q_ENUM(WrapMode) |
| |
| enum SelectionMode { |
| SelectCharacters, |
| SelectWords |
| }; |
| Q_ENUM(SelectionMode) |
| |
| enum CursorPosition { |
| CursorBetweenCharacters, |
| CursorOnCharacter |
| }; |
| Q_ENUM(CursorPosition) |
| |
| enum RenderType { QtRendering, |
| NativeRendering |
| }; |
| Q_ENUM(RenderType) |
| |
| //Auxilliary functions needed to control the TextInput from QML |
| Q_INVOKABLE void positionAt(QQmlV4Function *args) const; |
| Q_INVOKABLE QRectF positionToRectangle(int pos) const; |
| Q_INVOKABLE void moveCursorSelection(int pos); |
| Q_INVOKABLE void moveCursorSelection(int pos, SelectionMode mode); |
| |
| RenderType renderType() const; |
| void setRenderType(RenderType renderType); |
| |
| QString text() const; |
| void setText(const QString &); |
| |
| int length() const; |
| |
| QFont font() const; |
| void setFont(const QFont &font); |
| |
| QColor color() const; |
| void setColor(const QColor &c); |
| |
| QColor selectionColor() const; |
| void setSelectionColor(const QColor &c); |
| |
| QColor selectedTextColor() const; |
| void setSelectedTextColor(const QColor &c); |
| |
| HAlignment hAlign() const; |
| void setHAlign(HAlignment align); |
| void resetHAlign(); |
| HAlignment effectiveHAlign() const; |
| |
| VAlignment vAlign() const; |
| void setVAlign(VAlignment align); |
| |
| WrapMode wrapMode() const; |
| void setWrapMode(WrapMode w); |
| |
| bool isReadOnly() const; |
| void setReadOnly(bool); |
| |
| bool isCursorVisible() const; |
| void setCursorVisible(bool on); |
| |
| int cursorPosition() const; |
| void setCursorPosition(int cp); |
| |
| QRectF cursorRectangle() const; |
| |
| int selectionStart() const; |
| int selectionEnd() const; |
| |
| QString selectedText() const; |
| |
| int maxLength() const; |
| void setMaxLength(int ml); |
| |
| QValidator * validator() const; |
| void setValidator(QValidator* v); |
| |
| QString inputMask() const; |
| void setInputMask(const QString &im); |
| |
| EchoMode echoMode() const; |
| void setEchoMode(EchoMode echo); |
| |
| QString passwordCharacter() const; |
| void setPasswordCharacter(const QString &str); |
| |
| int passwordMaskDelay() const; |
| void setPasswordMaskDelay(int delay); |
| void resetPasswordMaskDelay(); |
| |
| QString displayText() const; |
| Q_REVISION(7) QString preeditText() const; |
| |
| QQmlComponent* cursorDelegate() const; |
| void setCursorDelegate(QQmlComponent*); |
| |
| bool overwriteMode() const; |
| void setOverwriteMode(bool overwrite); |
| |
| bool focusOnPress() const; |
| void setFocusOnPress(bool); |
| |
| bool autoScroll() const; |
| void setAutoScroll(bool); |
| |
| bool selectByMouse() const; |
| void setSelectByMouse(bool); |
| |
| SelectionMode mouseSelectionMode() const; |
| void setMouseSelectionMode(SelectionMode mode); |
| |
| bool persistentSelection() const; |
| void setPersistentSelection(bool persist); |
| |
| bool hasAcceptableInput() const; |
| |
| #if QT_CONFIG(im) |
| QVariant inputMethodQuery(Qt::InputMethodQuery property) const override; |
| Q_REVISION(4) Q_INVOKABLE QVariant inputMethodQuery(Qt::InputMethodQuery query, const QVariant &argument) const; |
| #endif |
| |
| QRectF boundingRect() const override; |
| QRectF clipRect() const override; |
| |
| bool canPaste() const; |
| |
| bool canUndo() const; |
| bool canRedo() const; |
| |
| bool isInputMethodComposing() const; |
| |
| Qt::InputMethodHints inputMethodHints() const; |
| void setInputMethodHints(Qt::InputMethodHints hints); |
| |
| Q_INVOKABLE QString getText(int start, int end) const; |
| |
| qreal contentWidth() const; |
| qreal contentHeight() const; |
| |
| qreal padding() const; |
| void setPadding(qreal padding); |
| void resetPadding(); |
| |
| qreal topPadding() const; |
| void setTopPadding(qreal padding); |
| void resetTopPadding(); |
| |
| qreal leftPadding() const; |
| void setLeftPadding(qreal padding); |
| void resetLeftPadding(); |
| |
| qreal rightPadding() const; |
| void setRightPadding(qreal padding); |
| void resetRightPadding(); |
| |
| qreal bottomPadding() const; |
| void setBottomPadding(qreal padding); |
| void resetBottomPadding(); |
| |
| Q_SIGNALS: |
| void textChanged(); |
| void cursorPositionChanged(); |
| void cursorRectangleChanged(); |
| void selectionStartChanged(); |
| void selectionEndChanged(); |
| void selectedTextChanged(); |
| void accepted(); |
| void acceptableInputChanged(); |
| Q_REVISION(2) void editingFinished(); |
| Q_REVISION(9) void textEdited(); |
| void colorChanged(); |
| void selectionColorChanged(); |
| void selectedTextColorChanged(); |
| void fontChanged(const QFont &font); |
| void horizontalAlignmentChanged(QQuickTextInput::HAlignment alignment); |
| void verticalAlignmentChanged(QQuickTextInput::VAlignment alignment); |
| void wrapModeChanged(); |
| void readOnlyChanged(bool isReadOnly); |
| void cursorVisibleChanged(bool isCursorVisible); |
| void cursorDelegateChanged(); |
| void overwriteModeChanged(bool overwriteMode); |
| void maximumLengthChanged(int maximumLength); |
| void validatorChanged(); |
| void inputMaskChanged(const QString &inputMask); |
| void echoModeChanged(QQuickTextInput::EchoMode echoMode); |
| void passwordCharacterChanged(); |
| Q_REVISION(4) void passwordMaskDelayChanged(int delay); |
| void displayTextChanged(); |
| Q_REVISION(7) void preeditTextChanged(); |
| void activeFocusOnPressChanged(bool activeFocusOnPress); |
| void autoScrollChanged(bool autoScroll); |
| void selectByMouseChanged(bool selectByMouse); |
| void mouseSelectionModeChanged(QQuickTextInput::SelectionMode mode); |
| void persistentSelectionChanged(); |
| void canPasteChanged(); |
| void canUndoChanged(); |
| void canRedoChanged(); |
| void inputMethodComposingChanged(); |
| void effectiveHorizontalAlignmentChanged(); |
| void contentSizeChanged(); |
| void inputMethodHintsChanged(); |
| void renderTypeChanged(); |
| Q_REVISION(6) void paddingChanged(); |
| Q_REVISION(6) void topPaddingChanged(); |
| Q_REVISION(6) void leftPaddingChanged(); |
| Q_REVISION(6) void rightPaddingChanged(); |
| Q_REVISION(6) void bottomPaddingChanged(); |
| |
| private: |
| void invalidateFontCaches(); |
| void ensureActiveFocus(); |
| |
| protected: |
| QQuickTextInput(QQuickTextInputPrivate &dd, QQuickItem *parent = nullptr); |
| |
| void geometryChanged(const QRectF &newGeometry, |
| const QRectF &oldGeometry) override; |
| |
| void mousePressEvent(QMouseEvent *event) override; |
| void mouseMoveEvent(QMouseEvent *event) override; |
| void mouseReleaseEvent(QMouseEvent *event) override; |
| void mouseDoubleClickEvent(QMouseEvent *event) override; |
| void keyPressEvent(QKeyEvent* ev) override; |
| #if QT_CONFIG(im) |
| void inputMethodEvent(QInputMethodEvent *) override; |
| #endif |
| void mouseUngrabEvent() override; |
| bool event(QEvent *e) override; |
| void focusOutEvent(QFocusEvent *event) override; |
| void focusInEvent(QFocusEvent *event) override; |
| void timerEvent(QTimerEvent *event) override; |
| QSGNode *updatePaintNode(QSGNode *oldNode, UpdatePaintNodeData *data) override; |
| void updatePolish() override; |
| |
| public Q_SLOTS: |
| void selectAll(); |
| void selectWord(); |
| void select(int start, int end); |
| void deselect(); |
| bool isRightToLeft(int start, int end); |
| #if QT_CONFIG(clipboard) |
| void cut(); |
| void copy(); |
| void paste(); |
| #endif |
| void undo(); |
| void redo(); |
| void insert(int position, const QString &text); |
| void remove(int start, int end); |
| Q_REVISION(4) void ensureVisible(int position); |
| Q_REVISION(7) void clear(); |
| |
| private Q_SLOTS: |
| void selectionChanged(); |
| void createCursor(); |
| void updateCursorRectangle(bool scroll = true); |
| void q_canPasteChanged(); |
| void q_updateAlignment(); |
| void triggerPreprocess(); |
| |
| #if QT_CONFIG(validator) |
| void q_validatorChanged(); |
| #endif |
| |
| private: |
| friend class QQuickTextUtil; |
| |
| Q_DECLARE_PRIVATE(QQuickTextInput) |
| }; |
| |
| QT_END_NAMESPACE |
| |
| QML_DECLARE_TYPE(QQuickTextInput) |
| |
| #endif // QQUICKTEXTINPUT_P_H |