Qt
Internal/Contributor docs for the Qt SDK. Note: These are NOT official API docs; those are found at https://doc.qt.io/
Loading...
Searching...
No Matches
qquicktext_p_p.h
Go to the documentation of this file.
1// Copyright (C) 2016 The Qt Company Ltd.
2// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
3// Qt-Security score:significant reason:default
4
5#ifndef QQUICKTEXT_P_P_H
6#define QQUICKTEXT_P_P_H
7
8//
9// W A R N I N G
10// -------------
11//
12// This file is not part of the Qt API. It exists purely as an
13// implementation detail. This header file may change from version to
14// version without notice, or even be removed.
15//
16// We mean it.
17//
18
19#include "qquicktext_p.h"
20#include "qquickimplicitsizeitem_p_p.h"
21
22#include <QtQml/qqml.h>
23#include <QtGui/qabstracttextdocumentlayout.h>
24#include <QtGui/qtextlayout.h>
25#include <private/qquickstyledtext_p.h>
26#include <private/qlazilyallocated_p.h>
27#include <private/qquicktextdocument_p.h>
28
29QT_BEGIN_NAMESPACE
30
31class QTextLayout;
32
33class Q_QUICK_EXPORT QQuickTextPrivate : public QQuickImplicitSizeItemPrivate
34{
35 Q_DECLARE_PUBLIC(QQuickText)
36public:
37 QQuickTextPrivate();
38 ~QQuickTextPrivate();
39 void init();
40
41 void updateBaseline(qreal baseline, qreal dy);
42 void updateSize();
43 void signalSizeChange(const QSizeF &previousSize);
44 void updateLayout();
45 bool determineHorizontalAlignment();
46 bool setHAlign(QQuickText::HAlignment, bool forceAlign = false);
47 void mirrorChange() override;
48 bool isLineLaidOutConnected();
49 void setLineGeometry(QTextLine &line, qreal lineWidth, qreal &height);
50
51 int lineHeightOffset() const;
52 QString elidedText(qreal lineWidth, const QTextLine &line, const QTextLine *nextLine = nullptr) const;
53 void elideFormats(int start, int length, int offset, QVector<QTextLayout::FormatRange> *elidedFormats);
54 void clearFormats();
55
56 void processHoverEvent(QHoverEvent *event);
57 bool transformChanged(QQuickItem *transformedItem) override;
58
59 QRectF layedOutTextRect;
60 QSizeF advance;
61
62 struct ExtraData {
63 ExtraData();
64
65 qreal padding;
66 qreal topPadding;
67 qreal leftPadding;
68 qreal rightPadding;
69 qreal bottomPadding;
70 bool explicitTopPadding : 1;
71 bool explicitLeftPadding : 1;
72 bool explicitRightPadding : 1;
73 bool explicitBottomPadding : 1;
74 qreal lineHeight;
75 QTextDocument *doc;
76 QQuickTextImageHandler *imageHandler = nullptr;
77 QString activeLink;
78 QString hoveredLink;
79 int minimumPixelSize;
80 int minimumPointSize;
81 int maximumLineCount;
82 int renderTypeQuality;
83 bool lineHeightValid : 1;
84 QQuickText::LineHeightMode lineHeightMode;
85 QQuickText::FontSizeMode fontSizeMode;
86 QList<QQuickStyledTextImgTag*> imgTags;
87 QList<QQuickStyledTextImgTag*> visibleImgTags;
88 QList<QQuickPixmap *> pixmapsInProgress;
89 QUrl baseUrl;
90 };
91 QLazilyAllocated<ExtraData> extra;
92
93 QString text;
94 QFont font;
95 QFont sourceFont;
96 QFontInfo fontInfo;
97
98 QTextLayout layout;
99 QScopedPointer<QTextLayout> elideLayout;
100 QScopedPointer<QQuickTextLine> textLine;
101
102 qreal lineWidth;
103
104 QRgb color;
105 QRgb linkColor;
106 QRgb styleColor;
107
108 int lineCount;
109 int multilengthEos;
110
111 enum UpdateType {
112 UpdateNone,
113 UpdatePreprocess,
114 UpdatePaintNode
115 };
116
117 QQuickText::TextElideMode elideMode;
118 QQuickText::HAlignment hAlign;
119 QQuickText::VAlignment vAlign;
120 QQuickText::TextFormat format;
121 QQuickText::WrapMode wrapMode;
122 QQuickText::TextStyle style;
123 QQuickText::RenderType renderType;
124 UpdateType updateType;
125
126 QString assignedFont;
127
128 bool maximumLineCountValid:1;
129 bool updateOnComponentComplete:1;
130 bool richText:1;
131 bool styledText:1;
132 bool markdownText:1;
133 bool widthExceeded:1;
134 bool heightExceeded:1;
135 bool internalWidthUpdate:1;
136 bool requireImplicitSize:1;
137 bool implicitWidthValid:1;
138 bool implicitHeightValid:1;
139 bool truncated:1;
140 bool hAlignImplicit:1;
141 bool rightToLeftText:1;
142 bool layoutTextElided:1;
143 bool textHasChanged:1;
144 bool needToUpdateLayout:1;
145 bool formatModifiesFontSize:1;
146 bool polishSize:1; // Workaround for problem with polish called after updateSize (QTBUG-42636)
147 bool updateSizeRecursionGuard:1;
148 bool containsUnscalableGlyphs:1;
149
150 static const QChar elideChar;
151 static const int largeTextSizeThreshold;
152
153 qreal getImplicitWidth() const override;
154 qreal getImplicitHeight() const override;
155
156 qreal availableWidth() const;
157 qreal availableHeight() const;
158
159 inline qreal padding() const { return extra.isAllocated() ? extra->padding : 0.0; }
160 void setTopPadding(qreal value, bool reset = false);
161 void setLeftPadding(qreal value, bool reset = false);
162 void setRightPadding(qreal value, bool reset = false);
163 void setBottomPadding(qreal value, bool reset = false);
164
165 void ensureDoc();
166 void updateDocumentText();
167
168 QRectF setupTextLayout(qreal * const baseline);
169 void setupCustomLineGeometry(QTextLine &line, qreal &height, int fullLayoutTextLength, int lineOffset = 0);
170 bool isLinkActivatedConnected();
171 bool isLinkHoveredConnected();
172 QStringList links() const;
173
174 struct LinkDesc {
175 QString m_anchor;
176 QString m_anchorTarget;
177 int m_startIndex;
178 int m_endIndex;
179 QRect rect;
180 };
181
182 QVector<LinkDesc> getLinks() const;
183
184 static QString anchorAt(const QTextLayout *layout, const QPointF &mousePos);
185 QString anchorAt(const QPointF &pos) const;
186
187 inline qreal lineHeight() const { return extra.isAllocated() ? extra->lineHeight : 1.0; }
188 inline int maximumLineCount() const { return extra.isAllocated() ? extra->maximumLineCount : INT_MAX; }
189 inline int renderTypeQuality() const { return extra.isAllocated() ? extra->renderTypeQuality : QQuickText::DefaultRenderTypeQuality; }
190 inline QQuickText::LineHeightMode lineHeightMode() const { return extra.isAllocated() ? extra->lineHeightMode : QQuickText::ProportionalHeight; }
191 inline QQuickText::FontSizeMode fontSizeMode() const { return extra.isAllocated() ? extra->fontSizeMode : QQuickText::FixedSize; }
192 inline int minimumPixelSize() const { return extra.isAllocated() ? extra->minimumPixelSize : 12; }
193 inline int minimumPointSize() const { return extra.isAllocated() ? extra->minimumPointSize : 12; }
194 static inline QQuickTextPrivate *get(QQuickText *t) { return t->d_func(); }
195};
196
197QT_END_NAMESPACE
198
199#endif // QQUICKTEXT_P_P_H
Q_STATIC_LOGGING_CATEGORY
Q_STATIC_LOGGING_CATEGORY(lcAccessibilityCore, "qt.accessibility.core")
QQUICKTEXT_LARGETEXT_THRESHOLD
#define QQUICKTEXT_LARGETEXT_THRESHOLD
Definition qquicktext.cpp:45
getLinks_helper
static void getLinks_helper(const QTextLayout *layout, QVector< QQuickTextPrivate::LinkDesc > *links)
Definition qquicktext.cpp:3190