1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
|
// Copyright (C) 2021 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
#include "qquicktextmetrics_p.h"
#include <QFont>
#include <QTextOption>
QT_BEGIN_NAMESPACE
/*!
\qmltype TextMetrics
\instantiates QQuickTextMetrics
\inqmlmodule QtQuick
\since 5.4
\ingroup qtquick-text-utility
\brief Provides metrics for a given font and text.
TextMetrics calculates various properties of a given string of text for a
particular font.
It provides a declarative API for the functions in \l QFontMetricsF which
take arguments.
\code
TextMetrics {
id: textMetrics
font.family: "Arial"
elide: Text.ElideMiddle
elideWidth: 100
text: "Hello World"
}
MyItem {
text: textMetrics.elidedText
}
\endcode
\sa QFontMetricsF, FontMetrics
*/
QQuickTextMetrics::QQuickTextMetrics(QObject *parent) :
QObject(parent),
m_metrics(m_font),
m_elide(Qt::ElideNone),
m_elideWidth(0),
m_renderType(QQuickText::QtRendering)
{
}
/*!
\qmlproperty font QtQuick::TextMetrics::font
This property holds the font used for the metrics calculations.
*/
QFont QQuickTextMetrics::font() const
{
return m_font;
}
void QQuickTextMetrics::setFont(const QFont &font)
{
if (m_font != font) {
m_font = font;
m_metrics = QFontMetricsF(m_font);
emit fontChanged();
emit metricsChanged();
}
}
/*!
\qmlproperty string QtQuick::TextMetrics::text
This property holds the text used for the metrics calculations.
*/
QString QQuickTextMetrics::text() const
{
return m_text;
}
void QQuickTextMetrics::setText(const QString &text)
{
if (m_text != text) {
m_text = text;
emit textChanged();
emit metricsChanged();
}
}
/*!
\qmlproperty enumeration QtQuick::TextMetrics::elide
This property holds the elide mode of the text. This determines the
position in which the string is elided. The possible values are:
\value Qt::ElideNone No eliding; this is the default value.
\value Qt::ElideLeft For example: "...World"
\value Qt::ElideMiddle For example: "He...ld"
\value Qt::ElideRight For example: "Hello..."
\sa elideWidth, QFontMetrics::elidedText
*/
Qt::TextElideMode QQuickTextMetrics::elide() const
{
return m_elide;
}
void QQuickTextMetrics::setElide(Qt::TextElideMode elide)
{
if (m_elide != elide) {
m_elide = elide;
emit elideChanged();
emit metricsChanged();
}
}
/*!
\qmlproperty real QtQuick::TextMetrics::elideWidth
This property holds the largest width the text can have (in pixels) before
eliding will occur.
\sa elide, QFontMetrics::elidedText
*/
qreal QQuickTextMetrics::elideWidth() const
{
return m_elideWidth;
}
void QQuickTextMetrics::setElideWidth(qreal elideWidth)
{
if (m_elideWidth != elideWidth) {
m_elideWidth = elideWidth;
emit elideWidthChanged();
emit metricsChanged();
}
}
/*!
\qmlproperty real QtQuick::TextMetrics::advanceWidth
This property holds the advance in pixels of the characters in \l text.
This is the distance from the position of the string to where the next
string should be drawn.
\sa {QFontMetricsF::horizontalAdvance()}
*/
qreal QQuickTextMetrics::advanceWidth() const
{
QTextOption option;
option.setUseDesignMetrics(m_renderType == QQuickText::QtRendering);
return m_metrics.horizontalAdvance(m_text, option);
}
/*!
\qmlproperty rect QtQuick::TextMetrics::boundingRect
This property holds the bounding rectangle of the characters in the string
specified by \l text.
\sa {QFontMetricsF::boundingRect()}, tightBoundingRect
*/
QRectF QQuickTextMetrics::boundingRect() const
{
QTextOption option;
option.setUseDesignMetrics(m_renderType == QQuickText::QtRendering);
return m_metrics.boundingRect(m_text, option);
}
/*!
\qmlproperty real QtQuick::TextMetrics::width
This property holds the width of the bounding rectangle of the characters
in the string specified by \l text. It is equivalent to:
\code
textMetrics.boundingRect.width
\endcode
\sa boundingRect
*/
qreal QQuickTextMetrics::width() const
{
return boundingRect().width();
}
/*!
\qmlproperty real QtQuick::TextMetrics::height
This property holds the height of the bounding rectangle of the characters
in the string specified by \l text. It is equivalent to:
\code
textMetrics.boundingRect.height
\endcode
\sa boundingRect
*/
qreal QQuickTextMetrics::height() const
{
return boundingRect().height();
}
/*!
\qmlproperty rect QtQuick::TextMetrics::tightBoundingRect
This property holds a tight bounding rectangle around the characters in the
string specified by \l text.
\sa {QFontMetricsF::tightBoundingRect()}, boundingRect
*/
QRectF QQuickTextMetrics::tightBoundingRect() const
{
QTextOption option;
option.setUseDesignMetrics(m_renderType == QQuickText::QtRendering);
return m_metrics.tightBoundingRect(m_text, option);
}
/*!
\qmlproperty string QtQuick::TextMetrics::elidedText
This property holds an elided version of the string (i.e., a string with
"..." in it) if the string \l text is wider than \l elideWidth. If the
text is not wider than \l elideWidth, or \l elide is set to
\c Qt::ElideNone, this property will be equal to the original string.
\sa {QFontMetricsF::elidedText()}
*/
QString QQuickTextMetrics::elidedText() const
{
return m_metrics.elidedText(m_text, m_elide, m_elideWidth);
}
/*!
\qmlproperty enumeration QtQuick::TextMetrics::renderType
Override the default rendering type for this component.
Supported render types are:
\value TextEdit.QtRendering Text is rendered using a scalable distance field for each glyph.
\value TextEdit.NativeRendering Text is rendered using a platform-specific technique.
This should match the intended \c renderType where you draw the text.
\since 6.3
\sa {Text::renderType}{Text.renderType}
*/
QQuickText::RenderType QQuickTextMetrics::renderType() const
{
return m_renderType;
}
void QQuickTextMetrics::setRenderType(QQuickText::RenderType renderType)
{
if (m_renderType == renderType)
return;
m_renderType = renderType;
emit renderTypeChanged();
}
QT_END_NAMESPACE
#include "moc_qquicktextmetrics_p.cpp"
|