/**************************************************************************** ** ** Copyright (C) 2016 The Qt Company Ltd. ** Contact: https://www.qt.io/licensing/ ** ** This file is part of the QtWidgets 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 QPLAINTEXTEDIT_H #define QPLAINTEXTEDIT_H #include #include #include #include #include #include #include #include QT_REQUIRE_CONFIG(textedit); QT_BEGIN_NAMESPACE class QStyleSheet; class QTextDocument; class QMenu; class QPlainTextEditPrivate; class QMimeData; class QPagedPaintDevice; class QRegularExpression; class Q_WIDGETS_EXPORT QPlainTextEdit : public QAbstractScrollArea { Q_OBJECT Q_DECLARE_PRIVATE(QPlainTextEdit) Q_PROPERTY(bool tabChangesFocus READ tabChangesFocus WRITE setTabChangesFocus) Q_PROPERTY(QString documentTitle READ documentTitle WRITE setDocumentTitle) Q_PROPERTY(bool undoRedoEnabled READ isUndoRedoEnabled WRITE setUndoRedoEnabled) Q_PROPERTY(LineWrapMode lineWrapMode READ lineWrapMode WRITE setLineWrapMode) QDOC_PROPERTY(QTextOption::WrapMode wordWrapMode READ wordWrapMode WRITE setWordWrapMode) Q_PROPERTY(bool readOnly READ isReadOnly WRITE setReadOnly) Q_PROPERTY(QString plainText READ toPlainText WRITE setPlainText NOTIFY textChanged USER true) Q_PROPERTY(bool overwriteMode READ overwriteMode WRITE setOverwriteMode) #if QT_DEPRECATED_SINCE(5, 10) Q_PROPERTY(int tabStopWidth READ tabStopWidth WRITE setTabStopWidth) #endif Q_PROPERTY(qreal tabStopDistance READ tabStopDistance WRITE setTabStopDistance) Q_PROPERTY(int cursorWidth READ cursorWidth WRITE setCursorWidth) Q_PROPERTY(Qt::TextInteractionFlags textInteractionFlags READ textInteractionFlags WRITE setTextInteractionFlags) Q_PROPERTY(int blockCount READ blockCount) Q_PROPERTY(int maximumBlockCount READ maximumBlockCount WRITE setMaximumBlockCount) Q_PROPERTY(bool backgroundVisible READ backgroundVisible WRITE setBackgroundVisible) Q_PROPERTY(bool centerOnScroll READ centerOnScroll WRITE setCenterOnScroll) Q_PROPERTY(QString placeholderText READ placeholderText WRITE setPlaceholderText) public: enum LineWrapMode { NoWrap, WidgetWidth }; Q_ENUM(LineWrapMode) explicit QPlainTextEdit(QWidget *parent = nullptr); explicit QPlainTextEdit(const QString &text, QWidget *parent = nullptr); virtual ~QPlainTextEdit(); void setDocument(QTextDocument *document); QTextDocument *document() const; void setPlaceholderText(const QString &placeholderText); QString placeholderText() const; void setTextCursor(const QTextCursor &cursor); QTextCursor textCursor() const; bool isReadOnly() const; void setReadOnly(bool ro); void setTextInteractionFlags(Qt::TextInteractionFlags flags); Qt::TextInteractionFlags textInteractionFlags() const; void mergeCurrentCharFormat(const QTextCharFormat &modifier); void setCurrentCharFormat(const QTextCharFormat &format); QTextCharFormat currentCharFormat() const; bool tabChangesFocus() const; void setTabChangesFocus(bool b); inline void setDocumentTitle(const QString &title) { document()->setMetaInformation(QTextDocument::DocumentTitle, title); } inline QString documentTitle() const { return document()->metaInformation(QTextDocument::DocumentTitle); } inline bool isUndoRedoEnabled() const { return document()->isUndoRedoEnabled(); } inline void setUndoRedoEnabled(bool enable) { document()->setUndoRedoEnabled(enable); } inline void setMaximumBlockCount(int maximum) { document()->setMaximumBlockCount(maximum); } inline int maximumBlockCount() const { return document()->maximumBlockCount(); } LineWrapMode lineWrapMode() const; void setLineWrapMode(LineWrapMode mode); QTextOption::WrapMode wordWrapMode() const; void setWordWrapMode(QTextOption::WrapMode policy); void setBackgroundVisible(bool visible); bool backgroundVisible() const; void setCenterOnScroll(bool enabled); bool centerOnScroll() const; bool find(const QString &exp, QTextDocument::FindFlags options = QTextDocument::FindFlags()); #ifndef QT_NO_REGEXP bool find(const QRegExp &exp, QTextDocument::FindFlags options = QTextDocument::FindFlags()); #endif #if QT_CONFIG(regularexpression) bool find(const QRegularExpression &exp, QTextDocument::FindFlags options = QTextDocument::FindFlags()); #endif inline QString toPlainText() const { return document()->toPlainText(); } void ensureCursorVisible(); virtual QVariant loadResource(int type, const QUrl &name); #ifndef QT_NO_CONTEXTMENU QMenu *createStandardContextMenu(); QMenu *createStandardContextMenu(const QPoint &position); #endif QTextCursor cursorForPosition(const QPoint &pos) const; QRect cursorRect(const QTextCursor &cursor) const; QRect cursorRect() const; QString anchorAt(const QPoint &pos) const; bool overwriteMode() const; void setOverwriteMode(bool overwrite); #if QT_DEPRECATED_SINCE(5, 10) QT_DEPRECATED int tabStopWidth() const; QT_DEPRECATED void setTabStopWidth(int width); #endif qreal tabStopDistance() const; void setTabStopDistance(qreal distance); int cursorWidth() const; void setCursorWidth(int width); void setExtraSelections(const QList &selections); QList extraSelections() const; void moveCursor(QTextCursor::MoveOperation operation, QTextCursor::MoveMode mode = QTextCursor::MoveAnchor); bool canPaste() const; void print(QPagedPaintDevice *printer) const; int blockCount() const; QVariant inputMethodQuery(Qt::InputMethodQuery property) const override; Q_INVOKABLE QVariant inputMethodQuery(Qt::InputMethodQuery query, QVariant argument) const; public Q_SLOTS: void setPlainText(const QString &text); #ifndef QT_NO_CLIPBOARD void cut(); void copy(); void paste(); #endif void undo(); void redo(); void clear(); void selectAll(); void insertPlainText(const QString &text); void appendPlainText(const QString &text); void appendHtml(const QString &html); void centerCursor(); void zoomIn(int range = 1); void zoomOut(int range = 1); Q_SIGNALS: void textChanged(); void undoAvailable(bool b); void redoAvailable(bool b); void copyAvailable(bool b); void selectionChanged(); void cursorPositionChanged(); void updateRequest(const QRect &rect, int dy); void blockCountChanged(int newBlockCount); void modificationChanged(bool); protected: virtual bool event(QEvent *e) override; virtual void timerEvent(QTimerEvent *e) override; virtual void keyPressEvent(QKeyEvent *e) override; virtual void keyReleaseEvent(QKeyEvent *e) override; virtual void resizeEvent(QResizeEvent *e) override; virtual void paintEvent(QPaintEvent *e) override; virtual void mousePressEvent(QMouseEvent *e) override; virtual void mouseMoveEvent(QMouseEvent *e) override; virtual void mouseReleaseEvent(QMouseEvent *e) override; virtual void mouseDoubleClickEvent(QMouseEvent *e) override; virtual bool focusNextPrevChild(bool next) override; #ifndef QT_NO_CONTEXTMENU virtual void contextMenuEvent(QContextMenuEvent *e) override; #endif #if QT_CONFIG(draganddrop) virtual void dragEnterEvent(QDragEnterEvent *e) override; virtual void dragLeaveEvent(QDragLeaveEvent *e) override; virtual void dragMoveEvent(QDragMoveEvent *e) override; virtual void dropEvent(QDropEvent *e) override; #endif virtual void focusInEvent(QFocusEvent *e) override; virtual void focusOutEvent(QFocusEvent *e) override; virtual void showEvent(QShowEvent *) override; virtual void changeEvent(QEvent *e) override; #if QT_CONFIG(wheelevent) virtual void wheelEvent(QWheelEvent *e) override; #endif virtual QMimeData *createMimeDataFromSelection() const; virtual bool canInsertFromMimeData(const QMimeData *source) const; virtual void insertFromMimeData(const QMimeData *source); virtual void inputMethodEvent(QInputMethodEvent *) override; QPlainTextEdit(QPlainTextEditPrivate &dd, QWidget *parent); virtual void scrollContentsBy(int dx, int dy) override; virtual void doSetTextCursor(const QTextCursor &cursor); QTextBlock firstVisibleBlock() const; QPointF contentOffset() const; QRectF blockBoundingRect(const QTextBlock &block) const; QRectF blockBoundingGeometry(const QTextBlock &block) const; QAbstractTextDocumentLayout::PaintContext getPaintContext() const; void zoomInF(float range); private: Q_DISABLE_COPY(QPlainTextEdit) Q_PRIVATE_SLOT(d_func(), void _q_repaintContents(const QRectF &r)) Q_PRIVATE_SLOT(d_func(), void _q_textChanged()) Q_PRIVATE_SLOT(d_func(), void _q_adjustScrollbars()) Q_PRIVATE_SLOT(d_func(), void _q_verticalScrollbarActionTriggered(int)) Q_PRIVATE_SLOT(d_func(), void _q_cursorPositionChanged()) friend class QPlainTextEditControl; }; class QPlainTextDocumentLayoutPrivate; class Q_WIDGETS_EXPORT QPlainTextDocumentLayout : public QAbstractTextDocumentLayout { Q_OBJECT Q_DECLARE_PRIVATE(QPlainTextDocumentLayout) Q_PROPERTY(int cursorWidth READ cursorWidth WRITE setCursorWidth) public: QPlainTextDocumentLayout(QTextDocument *document); ~QPlainTextDocumentLayout(); void draw(QPainter *, const PaintContext &) override; int hitTest(const QPointF &, Qt::HitTestAccuracy ) const override; int pageCount() const override; QSizeF documentSize() const override; QRectF frameBoundingRect(QTextFrame *) const override; QRectF blockBoundingRect(const QTextBlock &block) const override; void ensureBlockLayout(const QTextBlock &block) const; void setCursorWidth(int width); int cursorWidth() const; void requestUpdate(); protected: void documentChanged(int from, int /*charsRemoved*/, int charsAdded) override; private: void setTextWidth(qreal newWidth); qreal textWidth() const; void layoutBlock(const QTextBlock &block); qreal blockWidth(const QTextBlock &block); QPlainTextDocumentLayoutPrivate *priv() const; friend class QPlainTextEdit; friend class QPlainTextEditPrivate; }; QT_END_NAMESPACE #endif // QPLAINTEXTEDIT_H