| /**************************************************************************** |
| ** |
| ** 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 QQUICKTEXT_P_H |
| #define QQUICKTEXT_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 <private/qtquickglobal_p.h> |
| #include <QtGui/qtextoption.h> |
| |
| QT_BEGIN_NAMESPACE |
| |
| class QQuickTextPrivate; |
| class QQuickTextLine; |
| class Q_QUICK_PRIVATE_EXPORT QQuickText : public QQuickImplicitSizeItem |
| { |
| Q_OBJECT |
| |
| Q_PROPERTY(QString text READ text WRITE setText NOTIFY textChanged) |
| Q_PROPERTY(QFont font READ font WRITE setFont NOTIFY fontChanged) |
| Q_PROPERTY(QColor color READ color WRITE setColor NOTIFY colorChanged) |
| Q_PROPERTY(QColor linkColor READ linkColor WRITE setLinkColor NOTIFY linkColorChanged) |
| Q_PROPERTY(TextStyle style READ style WRITE setStyle NOTIFY styleChanged) |
| Q_PROPERTY(QColor styleColor READ styleColor WRITE setStyleColor NOTIFY styleColorChanged) |
| 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(int lineCount READ lineCount NOTIFY lineCountChanged) |
| Q_PROPERTY(bool truncated READ truncated NOTIFY truncatedChanged) |
| Q_PROPERTY(int maximumLineCount READ maximumLineCount WRITE setMaximumLineCount NOTIFY maximumLineCountChanged RESET resetMaximumLineCount) |
| |
| Q_PROPERTY(TextFormat textFormat READ textFormat WRITE setTextFormat NOTIFY textFormatChanged) |
| Q_PROPERTY(TextElideMode elide READ elideMode WRITE setElideMode NOTIFY elideModeChanged) //### elideMode? |
| Q_PROPERTY(qreal contentWidth READ contentWidth NOTIFY contentWidthChanged) |
| Q_PROPERTY(qreal contentHeight READ contentHeight NOTIFY contentHeightChanged) |
| Q_PROPERTY(qreal paintedWidth READ contentWidth NOTIFY contentWidthChanged) // Compatibility |
| Q_PROPERTY(qreal paintedHeight READ contentHeight NOTIFY contentHeightChanged) |
| Q_PROPERTY(qreal lineHeight READ lineHeight WRITE setLineHeight NOTIFY lineHeightChanged) |
| Q_PROPERTY(LineHeightMode lineHeightMode READ lineHeightMode WRITE setLineHeightMode NOTIFY lineHeightModeChanged) |
| Q_PROPERTY(QUrl baseUrl READ baseUrl WRITE setBaseUrl RESET resetBaseUrl NOTIFY baseUrlChanged) |
| Q_PROPERTY(int minimumPixelSize READ minimumPixelSize WRITE setMinimumPixelSize NOTIFY minimumPixelSizeChanged) |
| Q_PROPERTY(int minimumPointSize READ minimumPointSize WRITE setMinimumPointSize NOTIFY minimumPointSizeChanged) |
| Q_PROPERTY(FontSizeMode fontSizeMode READ fontSizeMode WRITE setFontSizeMode NOTIFY fontSizeModeChanged) |
| Q_PROPERTY(RenderType renderType READ renderType WRITE setRenderType NOTIFY renderTypeChanged) |
| Q_PROPERTY(QString hoveredLink READ hoveredLink NOTIFY linkHovered REVISION 2) |
| |
| 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) |
| |
| Q_PROPERTY(QJSValue fontInfo READ fontInfo NOTIFY fontInfoChanged REVISION 9) |
| Q_PROPERTY(QSizeF advance READ advance NOTIFY contentSizeChanged REVISION 10) |
| |
| public: |
| QQuickText(QQuickItem *parent=nullptr); |
| ~QQuickText() override; |
| |
| enum HAlignment { AlignLeft = Qt::AlignLeft, |
| AlignRight = Qt::AlignRight, |
| AlignHCenter = Qt::AlignHCenter, |
| AlignJustify = Qt::AlignJustify }; |
| Q_ENUM(HAlignment) |
| enum VAlignment { AlignTop = Qt::AlignTop, |
| AlignBottom = Qt::AlignBottom, |
| AlignVCenter = Qt::AlignVCenter }; |
| Q_ENUM(VAlignment) |
| enum TextStyle { Normal, |
| Outline, |
| Raised, |
| Sunken }; |
| Q_ENUM(TextStyle) |
| enum TextFormat { PlainText = Qt::PlainText, |
| RichText = Qt::RichText, |
| MarkdownText = Qt::MarkdownText, |
| AutoText = Qt::AutoText, |
| StyledText = 4 }; |
| Q_ENUM(TextFormat) |
| enum TextElideMode { ElideLeft = Qt::ElideLeft, |
| ElideRight = Qt::ElideRight, |
| ElideMiddle = Qt::ElideMiddle, |
| ElideNone = Qt::ElideNone }; |
| Q_ENUM(TextElideMode) |
| |
| enum WrapMode { NoWrap = QTextOption::NoWrap, |
| WordWrap = QTextOption::WordWrap, |
| WrapAnywhere = QTextOption::WrapAnywhere, |
| WrapAtWordBoundaryOrAnywhere = QTextOption::WrapAtWordBoundaryOrAnywhere, // COMPAT |
| Wrap = QTextOption::WrapAtWordBoundaryOrAnywhere |
| }; |
| Q_ENUM(WrapMode) |
| |
| enum RenderType { QtRendering, |
| NativeRendering |
| }; |
| Q_ENUM(RenderType) |
| |
| enum LineHeightMode { ProportionalHeight, FixedHeight }; |
| Q_ENUM(LineHeightMode) |
| |
| enum FontSizeMode { FixedSize = 0x0, HorizontalFit = 0x01, VerticalFit = 0x02, |
| Fit = HorizontalFit | VerticalFit }; |
| Q_ENUM(FontSizeMode) |
| |
| QString text() const; |
| void setText(const QString &); |
| |
| QFont font() const; |
| void setFont(const QFont &font); |
| |
| QColor color() const; |
| void setColor(const QColor &c); |
| |
| QColor linkColor() const; |
| void setLinkColor(const QColor &color); |
| |
| TextStyle style() const; |
| void setStyle(TextStyle style); |
| |
| QColor styleColor() const; |
| void setStyleColor(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); |
| |
| int lineCount() const; |
| bool truncated() const; |
| |
| int maximumLineCount() const; |
| void setMaximumLineCount(int lines); |
| void resetMaximumLineCount(); |
| |
| TextFormat textFormat() const; |
| void setTextFormat(TextFormat format); |
| |
| TextElideMode elideMode() const; |
| void setElideMode(TextElideMode); |
| |
| qreal lineHeight() const; |
| void setLineHeight(qreal lineHeight); |
| |
| LineHeightMode lineHeightMode() const; |
| void setLineHeightMode(LineHeightMode); |
| |
| |
| QUrl baseUrl() const; |
| void setBaseUrl(const QUrl &url); |
| void resetBaseUrl(); |
| |
| int minimumPixelSize() const; |
| void setMinimumPixelSize(int size); |
| |
| int minimumPointSize() const; |
| void setMinimumPointSize(int size); |
| |
| FontSizeMode fontSizeMode() const; |
| void setFontSizeMode(FontSizeMode mode); |
| |
| void componentComplete() override; |
| |
| int resourcesLoading() const; // mainly for testing |
| |
| qreal contentWidth() const; |
| qreal contentHeight() const; |
| |
| QRectF boundingRect() const override; |
| QRectF clipRect() const override; |
| Q_INVOKABLE void doLayout(); // ### Qt 6: remove |
| Q_REVISION(9) Q_INVOKABLE void forceLayout(); |
| |
| RenderType renderType() const; |
| void setRenderType(RenderType renderType); |
| |
| QString hoveredLink() const; |
| |
| Q_REVISION(3) Q_INVOKABLE QString linkAt(qreal x, qreal y) 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(); |
| |
| QJSValue fontInfo() const; |
| QSizeF advance() const; |
| |
| Q_SIGNALS: |
| void textChanged(const QString &text); |
| void linkActivated(const QString &link); |
| Q_REVISION(2) void linkHovered(const QString &link); |
| void fontChanged(const QFont &font); |
| void colorChanged(); |
| void linkColorChanged(); |
| void styleChanged(QQuickText::TextStyle style); |
| void styleColorChanged(); |
| void horizontalAlignmentChanged(QQuickText::HAlignment alignment); |
| void verticalAlignmentChanged(QQuickText::VAlignment alignment); |
| void wrapModeChanged(); |
| void lineCountChanged(); |
| void truncatedChanged(); |
| void maximumLineCountChanged(); |
| void textFormatChanged(QQuickText::TextFormat textFormat); |
| void elideModeChanged(QQuickText::TextElideMode mode); |
| void contentSizeChanged(); |
| // The next two signals should be marked as Q_REVISION(12). See QTBUG-71247 |
| void contentWidthChanged(qreal contentWidth); |
| void contentHeightChanged(qreal contentHeight); |
| |
| void lineHeightChanged(qreal lineHeight); |
| void lineHeightModeChanged(LineHeightMode mode); |
| void fontSizeModeChanged(); |
| void minimumPixelSizeChanged(); |
| void minimumPointSizeChanged(); |
| void effectiveHorizontalAlignmentChanged(); |
| void lineLaidOut(QQuickTextLine *line); |
| void baseUrlChanged(); |
| 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(); |
| Q_REVISION(9) void fontInfoChanged(); |
| |
| protected: |
| QQuickText(QQuickTextPrivate &dd, QQuickItem *parent = nullptr); |
| |
| void mousePressEvent(QMouseEvent *event) override; |
| void mouseReleaseEvent(QMouseEvent *event) override; |
| void itemChange(ItemChange change, const ItemChangeData &value) override; |
| void geometryChanged(const QRectF &newGeometry, |
| const QRectF &oldGeometry) override; |
| QSGNode *updatePaintNode(QSGNode *, UpdatePaintNodeData *) override; |
| |
| void updatePolish() override; |
| |
| void hoverEnterEvent(QHoverEvent *event) override; |
| void hoverMoveEvent(QHoverEvent *event) override; |
| void hoverLeaveEvent(QHoverEvent *event) override; |
| void invalidateFontCaches(); |
| |
| private Q_SLOTS: |
| void q_updateLayout(); |
| void triggerPreprocess(); |
| void imageDownloadFinished(); |
| |
| private: |
| Q_DISABLE_COPY(QQuickText) |
| Q_DECLARE_PRIVATE(QQuickText) |
| }; |
| |
| class QTextLine; |
| class QQuickTextLine : public QObject |
| { |
| Q_OBJECT |
| Q_PROPERTY(int number READ number) |
| Q_PROPERTY(qreal width READ width WRITE setWidth) |
| Q_PROPERTY(qreal height READ height WRITE setHeight) |
| Q_PROPERTY(qreal x READ x WRITE setX) |
| Q_PROPERTY(qreal y READ y WRITE setY) |
| |
| public: |
| QQuickTextLine(); |
| |
| void setLine(QTextLine* line); |
| void setLineOffset(int offset); |
| int number() const; |
| |
| qreal width() const; |
| void setWidth(qreal width); |
| |
| qreal height() const; |
| void setHeight(qreal height); |
| |
| qreal x() const; |
| void setX(qreal x); |
| |
| qreal y() const; |
| void setY(qreal y); |
| |
| private: |
| QTextLine *m_line; |
| qreal m_height; |
| int m_lineOffset; |
| }; |
| |
| QT_END_NAMESPACE |
| |
| QML_DECLARE_TYPE(QQuickText) |
| QML_DECLARE_TYPE(QQuickTextLine) |
| |
| #endif // QQUICKTEXT_P_H |