// Copyright (C) 2025 The Qt Company Ltd. // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GPL-3.0-only WITH Qt-GPL-exception-1.0 #pragma once #include "inputcontrol.h" #include #include #include #include QT_BEGIN_NAMESPACE class QTextCursor; class QTextCharFormat; QT_END_NAMESPACE namespace Utils { class WidgetTextControlPrivate; class WidgetTextControl : public InputControl { Q_OBJECT #ifndef QT_NO_TEXTHTMLPARSER Q_PROPERTY(QString html READ toHtml WRITE setHtml NOTIFY textChanged USER true) #endif Q_PROPERTY(bool overwriteMode READ overwriteMode WRITE setOverwriteMode) Q_PROPERTY(bool acceptRichText READ acceptRichText WRITE setAcceptRichText) Q_PROPERTY(int cursorWidth READ cursorWidth WRITE setCursorWidth) Q_PROPERTY(Qt::TextInteractionFlags textInteractionFlags READ textInteractionFlags WRITE setTextInteractionFlags) Q_PROPERTY(bool openExternalLinks READ openExternalLinks WRITE setOpenExternalLinks) Q_PROPERTY(bool ignoreUnusedNavigationEvents READ ignoreUnusedNavigationEvents WRITE setIgnoreUnusedNavigationEvents) public: explicit WidgetTextControl(QObject *parent = nullptr); explicit WidgetTextControl(const QString &text, QObject *parent = nullptr); explicit WidgetTextControl(QTextDocument *doc, QObject *parent = nullptr); virtual ~WidgetTextControl(); void setDocument(QTextDocument *document); QTextDocument *document() const; void setTextCursor(const QTextCursor &cursor, bool selectionClipboard = false); QTextCursor textCursor() const; void setTextInteractionFlags(Qt::TextInteractionFlags flags); Qt::TextInteractionFlags textInteractionFlags() const; void mergeCurrentCharFormat(const QTextCharFormat &modifier); void setCurrentCharFormat(const QTextCharFormat &format); QTextCharFormat currentCharFormat() const; bool find(const QString &exp, QTextDocument::FindFlags options = { }); #if QT_CONFIG(regularexpression) bool find(const QRegularExpression &exp, QTextDocument::FindFlags options = { }); #endif QString toPlainText() const; #ifndef QT_NO_TEXTHTMLPARSER QString toHtml() const; #endif #if QT_CONFIG(textmarkdownwriter) QString toMarkdown(QTextDocument::MarkdownFeatures features = QTextDocument::MarkdownDialectGitHub) const; #endif virtual void ensureCursorVisible(); Q_INVOKABLE virtual QVariant loadResource(int type, const QUrl &name); #ifndef QT_NO_CONTEXTMENU QMenu *createStandardContextMenu(const QPointF &pos, QWidget *parent); #endif QTextCursor cursorForPosition(const QPointF &pos) const; QRectF cursorRect(const QTextCursor &cursor) const; QRectF cursorRect() const; QRectF selectionRect(const QTextCursor &cursor) const; QRectF selectionRect() const; virtual QString anchorAt(const QPointF &pos) const; QPointF anchorPosition(const QString &name) const; QString anchorAtCursor() const; QTextBlock blockWithMarkerAt(const QPointF &pos) const; bool overwriteMode() const; void setOverwriteMode(bool overwrite); int cursorWidth() const; void setCursorWidth(int width); bool acceptRichText() const; void setAcceptRichText(bool accept); #if QT_CONFIG(textedit) void setExtraSelections(const QList &selections); QList extraSelections() const; #endif void setTextWidth(qreal width); qreal textWidth() const; QSizeF size() const; void setOpenExternalLinks(bool open); bool openExternalLinks() const; void setIgnoreUnusedNavigationEvents(bool ignore); bool ignoreUnusedNavigationEvents() const; void moveCursor(QTextCursor::MoveOperation op, QTextCursor::MoveMode mode = QTextCursor::MoveAnchor); bool canPaste() const; void setCursorIsFocusIndicator(bool b); bool cursorIsFocusIndicator() const; void setDragEnabled(bool enabled); bool isDragEnabled() const; bool isWordSelectionEnabled() const; void setWordSelectionEnabled(bool enabled); bool isPreediting(); void print(QPagedPaintDevice *printer) const; virtual int hitTest(const QPointF &point, Qt::HitTestAccuracy accuracy) const; virtual QRectF blockBoundingRect(const QTextBlock &block) const; virtual qreal mainLayoutOffset(const QTextBlock &block) const; QAbstractTextDocumentLayout::PaintContext getPaintContext(QWidget *widget) const; public Q_SLOTS: void setPlainText(const QString &text); #if QT_CONFIG(textmarkdownreader) void setMarkdown(const QString &text); #endif void setHtml(const QString &text); #ifndef QT_NO_CLIPBOARD void cut(); void copy(); void paste(QClipboard::Mode mode = QClipboard::Clipboard); #endif void undo(); void redo(); void clear(); void selectAll(); void insertPlainText(const QString &text); #ifndef QT_NO_TEXTHTMLPARSER void insertHtml(const QString &text); #endif void append(const QString &text); void appendHtml(const QString &html); void appendPlainText(const QString &text); void adjustSize(); Q_SIGNALS: void textChanged(); void undoAvailable(bool b); void redoAvailable(bool b); void currentCharFormatChanged(const QTextCharFormat &format); void copyAvailable(bool b); void selectionChanged(); void cursorPositionChanged(); // control signals void updateRequest(const QRectF &rect = QRectF()); void documentSizeChanged(const QSizeF &); void blockCountChanged(int newBlockCount); void visibilityRequest(const QRectF &rect); void microFocusChanged(); void linkActivated(const QString &link); void linkHovered(const QString &); void blockMarkerHovered(const QTextBlock &block); void modificationChanged(bool m); public: // control properties QPalette palette() const; void setPalette(const QPalette &pal); virtual void processEvent(QEvent *e, const QTransform &transform, QWidget *contextWidget = nullptr); void processEvent(QEvent *e, const QPointF &coordinateOffset = QPointF(), QWidget *contextWidget = nullptr); // control methods void drawContents(QPainter *painter, const QRectF &rect = QRectF(), QWidget *widget = nullptr); void setFocus(bool focus, Qt::FocusReason = Qt::OtherFocusReason); virtual QVariant inputMethodQuery(Qt::InputMethodQuery property, QVariant argument) const; virtual QMimeData *createMimeDataFromSelection() const; virtual bool canInsertFromMimeData(const QMimeData *source) const; virtual void insertFromMimeData(const QMimeData *source); bool setFocusToAnchor(const QTextCursor &newCursor); bool setFocusToNextOrPreviousAnchor(bool next); bool findNextPrevAnchor(const QTextCursor& from, bool next, QTextCursor& newAnchor); virtual QAbstractTextDocumentLayout *layout() const; protected: virtual void timerEvent(QTimerEvent *e) override; virtual bool event(QEvent *e) override; private: Q_DISABLE_COPY_MOVE(WidgetTextControl) std::unique_ptr d; }; } // namespace Utils