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 void positionInlineImages(const QTextLine &line, const QList<QTextLayout::FormatRange> &formats);
51
52 int lineHeightOffset() const;
53 QString elidedText(qreal lineWidth, const QTextLine &line) const;
54 void elideFormats(int start, int length, int offset, QList<QTextLayout::FormatRange> *elidedFormats);
55 void clearFormats();
56
57 void processHoverEvent(QHoverEvent *event);
58 bool transformChanged(QQuickItem *transformedItem) override;
59
60 QRectF layedOutTextRect;
61 QSizeF advance;
62
63 struct ExtraData {
64 ExtraData();
65
66 qreal padding;
67 qreal topPadding;
68 qreal leftPadding;
69 qreal rightPadding;
70 qreal bottomPadding;
71 bool explicitTopPadding : 1;
72 bool explicitLeftPadding : 1;
73 bool explicitRightPadding : 1;
74 bool explicitBottomPadding : 1;
75 qreal lineHeight;
76 QTextDocument *doc;
77 QQuickTextImageHandler *imageHandler = nullptr;
78 QString activeLink;
79 QString hoveredLink;
80 int minimumPixelSize;
81 int minimumPointSize;
82 int maximumLineCount;
83 int renderTypeQuality;
84 bool lineHeightValid : 1;
85 QQuickText::LineHeightMode lineHeightMode;
86 QQuickText::FontSizeMode fontSizeMode;
87 QList<QQuickStyledTextImgTag*> imgTags;
88 QList<QQuickStyledTextImgTag*> visibleImgTags;
89 QList<QQuickPixmap *> pixmapsInProgress;
90 QUrl baseUrl;
91 };
92 QLazilyAllocated<ExtraData> extra;
93
94 QString text;
95 QFont font;
96 QFont sourceFont;
97 QFontInfo fontInfo;
98
99 QTextLayout layout;
100 QScopedPointer<QTextLayout> elideLayout;
101 QScopedPointer<QQuickTextLine> textLine;
102
103 qreal lineWidth;
104
105 QRgb color;
106 QRgb linkColor;
107 QRgb styleColor;
108
109 int lineCount;
110 int multilengthEos;
111
112 enum UpdateType {
113 UpdateNone,
114 UpdatePreprocess,
115 UpdatePaintNode
116 };
117
118 QQuickText::TextElideMode elideMode;
119 QQuickText::HAlignment hAlign;
120 QQuickText::VAlignment vAlign;
121 QQuickText::TextFormat format;
122 QQuickText::WrapMode wrapMode;
123 QQuickText::TextStyle style;
124 QQuickText::RenderType renderType;
125 UpdateType updateType;
126
127 QString assignedFont;
128
129 bool maximumLineCountValid:1;
130 bool updateOnComponentComplete:1;
131 bool richText:1;
132 bool styledText:1;
133 bool markdownText:1;
134 bool widthExceeded:1;
135 bool heightExceeded:1;
136 bool internalWidthUpdate:1;
137 bool requireImplicitSize:1;
138 bool implicitWidthValid:1;
139 bool implicitHeightValid:1;
140 bool truncated:1;
141 bool hAlignImplicit:1;
142 bool rightToLeftText:1;
143 bool layoutTextElided:1;
144 bool textHasChanged:1;
145 bool needToUpdateLayout:1;
146 bool formatModifiesFontSize:1;
147 bool polishSize:1; // Workaround for problem with polish called after updateSize (QTBUG-42636)
148 bool updateSizeRecursionGuard:1;
149 bool containsUnscalableGlyphs:1;
150
151 static const QChar elideChar;
152 static const int largeTextSizeThreshold;
153
154 qreal getImplicitWidth() const override;
155 qreal getImplicitHeight() const override;
156
157 qreal availableWidth() const;
158 qreal availableHeight() const;
159
160 inline qreal padding() const { return extra.isAllocated() ? extra->padding : 0.0; }
161 void setTopPadding(qreal value, bool reset = false);
162 void setLeftPadding(qreal value, bool reset = false);
163 void setRightPadding(qreal value, bool reset = false);
164 void setBottomPadding(qreal value, bool reset = false);
165
166 void ensureDoc();
167 void updateDocumentText();
168
169 QRectF setupTextLayout(qreal * const baseline);
170 void setupCustomLineGeometry(QTextLine &line, qreal &height, int fullLayoutTextLength, int lineOffset = 0);
171 bool isLinkActivatedConnected();
172 bool isLinkHoveredConnected();
173 QStringList links() const;
174
175 struct LinkDesc {
176 QString m_anchor;
177 QString m_anchorTarget;
178 int m_startIndex;
179 int m_endIndex;
180 QRect rect;
181 };
182
183 QList<LinkDesc> getLinks() const;
184
185 static QString anchorAt(const QTextLayout *layout, const QPointF &mousePos);
186 QString anchorAt(const QPointF &pos) const;
187
188 inline qreal lineHeight() const { return extra.isAllocated() ? extra->lineHeight : 1.0; }
189 inline int maximumLineCount() const { return extra.isAllocated() ? extra->maximumLineCount : INT_MAX; }
190 inline int renderTypeQuality() const { return extra.isAllocated() ? extra->renderTypeQuality : QQuickText::DefaultRenderTypeQuality; }
191 inline QQuickText::LineHeightMode lineHeightMode() const { return extra.isAllocated() ? extra->lineHeightMode : QQuickText::ProportionalHeight; }
192 inline QQuickText::FontSizeMode fontSizeMode() const { return extra.isAllocated() ? extra->fontSizeMode : QQuickText::FixedSize; }
193 inline int minimumPixelSize() const { return extra.isAllocated() ? extra->minimumPixelSize : 12; }
194 inline int minimumPointSize() const { return extra.isAllocated() ? extra->minimumPointSize : 12; }
195 static inline QQuickTextPrivate *get(QQuickText *t) { return t->d_func(); }
196};
197
198QT_END_NAMESPACE
199
200#endif // QQUICKTEXT_P_P_H
QT_BEGIN_NAMESPACE
Combined button and popup list for selecting options.
Definition qsequentialanimationgroup.cpp:47
Q_STATIC_LOGGING_CATEGORY
QT_BEGIN_NAMESPACE Q_STATIC_LOGGING_CATEGORY(lcSynthesizedIterableAccess, "qt.iterable.synthesized", QtWarningMsg)
QQUICKTEXT_LARGETEXT_THRESHOLD
#define QQUICKTEXT_LARGETEXT_THRESHOLD
Definition qquicktext.cpp:45
positionInlineImage
static void positionInlineImage(QQuickStyledTextImgTag *image, int textPos, const QTextLine &line)
Definition qquicktext.cpp:726
getLinks_helper
static void getLinks_helper(const QTextLayout *layout, QList< QQuickTextPrivate::LinkDesc > *links)
Definition qquicktext.cpp:3013