| Absolute File Name: | /home/opencoverage/opencoverage/guest-scripts/qtdeclarative/src/qtdeclarative/src/quick/util/qquickfontmetrics.cpp |
| Source code | Switch to Preprocessed file |
| Line | Source | Count | ||||||
|---|---|---|---|---|---|---|---|---|
| 1 | /**************************************************************************** | - | ||||||
| 2 | ** | - | ||||||
| 3 | ** Copyright (C) 2016 The Qt Company Ltd. | - | ||||||
| 4 | ** Contact: https://www.qt.io/licensing/ | - | ||||||
| 5 | ** | - | ||||||
| 6 | ** This file is part of the QtQuick module of the Qt Toolkit. | - | ||||||
| 7 | ** | - | ||||||
| 8 | ** $QT_BEGIN_LICENSE:LGPL$ | - | ||||||
| 9 | ** Commercial License Usage | - | ||||||
| 10 | ** Licensees holding valid commercial Qt licenses may use this file in | - | ||||||
| 11 | ** accordance with the commercial license agreement provided with the | - | ||||||
| 12 | ** Software or, alternatively, in accordance with the terms contained in | - | ||||||
| 13 | ** a written agreement between you and The Qt Company. For licensing terms | - | ||||||
| 14 | ** and conditions see https://www.qt.io/terms-conditions. For further | - | ||||||
| 15 | ** information use the contact form at https://www.qt.io/contact-us. | - | ||||||
| 16 | ** | - | ||||||
| 17 | ** GNU Lesser General Public License Usage | - | ||||||
| 18 | ** Alternatively, this file may be used under the terms of the GNU Lesser | - | ||||||
| 19 | ** General Public License version 3 as published by the Free Software | - | ||||||
| 20 | ** Foundation and appearing in the file LICENSE.LGPL3 included in the | - | ||||||
| 21 | ** packaging of this file. Please review the following information to | - | ||||||
| 22 | ** ensure the GNU Lesser General Public License version 3 requirements | - | ||||||
| 23 | ** will be met: https://www.gnu.org/licenses/lgpl-3.0.html. | - | ||||||
| 24 | ** | - | ||||||
| 25 | ** GNU General Public License Usage | - | ||||||
| 26 | ** Alternatively, this file may be used under the terms of the GNU | - | ||||||
| 27 | ** General Public License version 2.0 or (at your option) the GNU General | - | ||||||
| 28 | ** Public license version 3 or any later version approved by the KDE Free | - | ||||||
| 29 | ** Qt Foundation. The licenses are as published by the Free Software | - | ||||||
| 30 | ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3 | - | ||||||
| 31 | ** included in the packaging of this file. Please review the following | - | ||||||
| 32 | ** information to ensure the GNU General Public License requirements will | - | ||||||
| 33 | ** be met: https://www.gnu.org/licenses/gpl-2.0.html and | - | ||||||
| 34 | ** https://www.gnu.org/licenses/gpl-3.0.html. | - | ||||||
| 35 | ** | - | ||||||
| 36 | ** $QT_END_LICENSE$ | - | ||||||
| 37 | ** | - | ||||||
| 38 | ****************************************************************************/ | - | ||||||
| 39 | - | |||||||
| 40 | #include "qquickfontmetrics_p.h" | - | ||||||
| 41 | - | |||||||
| 42 | #include <QFont> | - | ||||||
| 43 | - | |||||||
| 44 | QT_BEGIN_NAMESPACE | - | ||||||
| 45 | - | |||||||
| 46 | /*! | - | ||||||
| 47 | \qmltype FontMetrics | - | ||||||
| 48 | \instantiates QQuickFontMetrics | - | ||||||
| 49 | \inqmlmodule QtQuick | - | ||||||
| 50 | \since 5.4 | - | ||||||
| 51 | \ingroup qtquick-text-utility | - | ||||||
| 52 | \brief Provides metrics for a given font. | - | ||||||
| 53 | - | |||||||
| 54 | FontMetrics calculates the size of characters and strings for a given font. | - | ||||||
| 55 | - | |||||||
| 56 | It provides a subset of the C++ \l QFontMetricsF API, with the added | - | ||||||
| 57 | ability to change the font that is used for calculations via the \l font | - | ||||||
| 58 | property. | - | ||||||
| 59 | - | |||||||
| 60 | \code | - | ||||||
| 61 | FontMetrics { | - | ||||||
| 62 | id: fontMetrics | - | ||||||
| 63 | font.family: "Arial" | - | ||||||
| 64 | } | - | ||||||
| 65 | - | |||||||
| 66 | Rectangle { | - | ||||||
| 67 | width: fontMetrics.height * 4 | - | ||||||
| 68 | height: fontMetrics.height * 2 | - | ||||||
| 69 | } | - | ||||||
| 70 | \endcode | - | ||||||
| 71 | - | |||||||
| 72 | \sa QFontMetricsF, TextMetrics | - | ||||||
| 73 | */ | - | ||||||
| 74 | QQuickFontMetrics::QQuickFontMetrics(QObject *parent) : | - | ||||||
| 75 | QObject(parent), | - | ||||||
| 76 | m_metrics(m_font) | - | ||||||
| 77 | { | - | ||||||
| 78 | } executed 202 times by 1 test: end of blockExecuted by:
| 202 | ||||||
| 79 | - | |||||||
| 80 | QQuickFontMetrics::~QQuickFontMetrics() | - | ||||||
| 81 | { | - | ||||||
| 82 | } | - | ||||||
| 83 | - | |||||||
| 84 | /*! | - | ||||||
| 85 | \qmlproperty font QtQuick::FontMetrics::font | - | ||||||
| 86 | - | |||||||
| 87 | This property holds the font used for the metrics calculations. | - | ||||||
| 88 | */ | - | ||||||
| 89 | QFont QQuickFontMetrics::font() const | - | ||||||
| 90 | { | - | ||||||
| 91 | return m_font; never executed: return m_font; | 0 | ||||||
| 92 | } | - | ||||||
| 93 | - | |||||||
| 94 | void QQuickFontMetrics::setFont(const QFont &font) | - | ||||||
| 95 | { | - | ||||||
| 96 | if (m_font != font) {
| 0-20 | ||||||
| 97 | m_font = font; | - | ||||||
| 98 | m_metrics = QFontMetricsF(m_font); | - | ||||||
| 99 | emit fontChanged(m_font); | - | ||||||
| 100 | } executed 20 times by 1 test: end of blockExecuted by:
| 20 | ||||||
| 101 | } executed 20 times by 1 test: end of blockExecuted by:
| 20 | ||||||
| 102 | - | |||||||
| 103 | /*! | - | ||||||
| 104 | \qmlproperty real QtQuick::FontMetrics::ascent | - | ||||||
| 105 | - | |||||||
| 106 | This property holds the ascent of the font. | - | ||||||
| 107 | - | |||||||
| 108 | \sa {QFontMetricsF::ascent()}, descent, height | - | ||||||
| 109 | */ | - | ||||||
| 110 | qreal QQuickFontMetrics::ascent() const | - | ||||||
| 111 | { | - | ||||||
| 112 | return m_metrics.ascent(); executed 20 times by 1 test: return m_metrics.ascent();Executed by:
| 20 | ||||||
| 113 | } | - | ||||||
| 114 | - | |||||||
| 115 | /*! | - | ||||||
| 116 | \qmlproperty real QtQuick::FontMetrics::descent | - | ||||||
| 117 | - | |||||||
| 118 | This property holds the descent of the font. | - | ||||||
| 119 | - | |||||||
| 120 | \sa {QFontMetricsF::descent()}, ascent, height | - | ||||||
| 121 | */ | - | ||||||
| 122 | qreal QQuickFontMetrics::descent() const | - | ||||||
| 123 | { | - | ||||||
| 124 | return m_metrics.descent(); executed 20 times by 1 test: return m_metrics.descent();Executed by:
| 20 | ||||||
| 125 | } | - | ||||||
| 126 | - | |||||||
| 127 | /*! | - | ||||||
| 128 | \qmlproperty real QtQuick::FontMetrics::height | - | ||||||
| 129 | - | |||||||
| 130 | This property holds the height of the font. | - | ||||||
| 131 | - | |||||||
| 132 | \sa {QFontMetricsF::height()} | - | ||||||
| 133 | */ | - | ||||||
| 134 | qreal QQuickFontMetrics::height() const | - | ||||||
| 135 | { | - | ||||||
| 136 | return m_metrics.height(); executed 20 times by 1 test: return m_metrics.height();Executed by:
| 20 | ||||||
| 137 | } | - | ||||||
| 138 | - | |||||||
| 139 | /*! | - | ||||||
| 140 | \qmlproperty real QtQuick::FontMetrics::leading | - | ||||||
| 141 | - | |||||||
| 142 | This property holds the leading of the font. | - | ||||||
| 143 | - | |||||||
| 144 | \sa {QFontMetricsF::leading()} | - | ||||||
| 145 | */ | - | ||||||
| 146 | qreal QQuickFontMetrics::leading() const | - | ||||||
| 147 | { | - | ||||||
| 148 | return m_metrics.leading(); executed 20 times by 1 test: return m_metrics.leading();Executed by:
| 20 | ||||||
| 149 | } | - | ||||||
| 150 | - | |||||||
| 151 | /*! | - | ||||||
| 152 | \qmlproperty real QtQuick::FontMetrics::lineSpacing | - | ||||||
| 153 | - | |||||||
| 154 | This property holds the distance from one base line to the next. | - | ||||||
| 155 | - | |||||||
| 156 | \sa {QFontMetricsF::lineSpacing()} | - | ||||||
| 157 | */ | - | ||||||
| 158 | qreal QQuickFontMetrics::lineSpacing() const | - | ||||||
| 159 | { | - | ||||||
| 160 | return m_metrics.lineSpacing(); executed 20 times by 1 test: return m_metrics.lineSpacing();Executed by:
| 20 | ||||||
| 161 | } | - | ||||||
| 162 | - | |||||||
| 163 | /*! | - | ||||||
| 164 | \qmlproperty real QtQuick::FontMetrics::minimumLeftBearing | - | ||||||
| 165 | - | |||||||
| 166 | This property holds the minimum left bearing of the font. | - | ||||||
| 167 | - | |||||||
| 168 | \sa {QFontMetricsF::minLeftBearing()} | - | ||||||
| 169 | */ | - | ||||||
| 170 | qreal QQuickFontMetrics::minimumLeftBearing() const | - | ||||||
| 171 | { | - | ||||||
| 172 | return m_metrics.minLeftBearing(); executed 20 times by 1 test: return m_metrics.minLeftBearing();Executed by:
| 20 | ||||||
| 173 | } | - | ||||||
| 174 | - | |||||||
| 175 | /*! | - | ||||||
| 176 | \qmlproperty real QtQuick::FontMetrics::minimumRightBearing | - | ||||||
| 177 | - | |||||||
| 178 | This property holds the minimum right bearing of the font. | - | ||||||
| 179 | - | |||||||
| 180 | \sa {QFontMetricsF::minRightBearing()} | - | ||||||
| 181 | */ | - | ||||||
| 182 | qreal QQuickFontMetrics::minimumRightBearing() const | - | ||||||
| 183 | { | - | ||||||
| 184 | return m_metrics.minRightBearing(); executed 20 times by 1 test: return m_metrics.minRightBearing();Executed by:
| 20 | ||||||
| 185 | } | - | ||||||
| 186 | - | |||||||
| 187 | /*! | - | ||||||
| 188 | \qmlproperty real QtQuick::FontMetrics::maximumCharacterWidth | - | ||||||
| 189 | - | |||||||
| 190 | This property holds the width of the widest character in the font. | - | ||||||
| 191 | - | |||||||
| 192 | \sa {QFontMetricsF::maxWidth()} | - | ||||||
| 193 | */ | - | ||||||
| 194 | qreal QQuickFontMetrics::maximumCharacterWidth() const | - | ||||||
| 195 | { | - | ||||||
| 196 | return m_metrics.maxWidth(); executed 20 times by 1 test: return m_metrics.maxWidth();Executed by:
| 20 | ||||||
| 197 | } | - | ||||||
| 198 | - | |||||||
| 199 | /*! | - | ||||||
| 200 | \qmlproperty real QtQuick::FontMetrics::xHeight | - | ||||||
| 201 | - | |||||||
| 202 | This property holds the 'x' height of the font. | - | ||||||
| 203 | - | |||||||
| 204 | \sa {QFontMetricsF::xHeight()} | - | ||||||
| 205 | */ | - | ||||||
| 206 | qreal QQuickFontMetrics::xHeight() const | - | ||||||
| 207 | { | - | ||||||
| 208 | return m_metrics.xHeight(); executed 20 times by 1 test: return m_metrics.xHeight();Executed by:
| 20 | ||||||
| 209 | } | - | ||||||
| 210 | - | |||||||
| 211 | /*! | - | ||||||
| 212 | \qmlproperty real QtQuick::FontMetrics::averageCharacterWidth | - | ||||||
| 213 | - | |||||||
| 214 | This property holds the average width of glyphs in the font. | - | ||||||
| 215 | - | |||||||
| 216 | \sa {QFontMetricsF::averageCharWidth()} | - | ||||||
| 217 | */ | - | ||||||
| 218 | qreal QQuickFontMetrics::averageCharacterWidth() const | - | ||||||
| 219 | { | - | ||||||
| 220 | return m_metrics.averageCharWidth(); executed 20 times by 1 test: return m_metrics.averageCharWidth();Executed by:
| 20 | ||||||
| 221 | } | - | ||||||
| 222 | - | |||||||
| 223 | /*! | - | ||||||
| 224 | \qmlproperty real QtQuick::FontMetrics::underlinePosition | - | ||||||
| 225 | - | |||||||
| 226 | This property holds the distance from the base line to where an underscore | - | ||||||
| 227 | should be drawn. | - | ||||||
| 228 | - | |||||||
| 229 | \sa {QFontMetricsF::underlinePos()}, overlinePosition, strikeOutPosition | - | ||||||
| 230 | */ | - | ||||||
| 231 | qreal QQuickFontMetrics::underlinePosition() const | - | ||||||
| 232 | { | - | ||||||
| 233 | return m_metrics.underlinePos(); executed 20 times by 1 test: return m_metrics.underlinePos();Executed by:
| 20 | ||||||
| 234 | } | - | ||||||
| 235 | - | |||||||
| 236 | /*! | - | ||||||
| 237 | \qmlproperty real QtQuick::FontMetrics::overlinePosition | - | ||||||
| 238 | - | |||||||
| 239 | This property holds the distance from the base line to where an overline | - | ||||||
| 240 | should be drawn. | - | ||||||
| 241 | - | |||||||
| 242 | \sa {QFontMetricsF::overlinePos()}, underlinePosition, strikeOutPosition | - | ||||||
| 243 | */ | - | ||||||
| 244 | qreal QQuickFontMetrics::overlinePosition() const | - | ||||||
| 245 | { | - | ||||||
| 246 | return m_metrics.overlinePos(); executed 20 times by 1 test: return m_metrics.overlinePos();Executed by:
| 20 | ||||||
| 247 | } | - | ||||||
| 248 | - | |||||||
| 249 | /*! | - | ||||||
| 250 | \qmlproperty real QtQuick::FontMetrics::strikeOutPosition | - | ||||||
| 251 | - | |||||||
| 252 | This property holds the distance from the base line to where the strikeout | - | ||||||
| 253 | line should be drawn. | - | ||||||
| 254 | - | |||||||
| 255 | \sa {QFontMetricsF::strikeOutPos()}, overlinePosition, underlinePosition | - | ||||||
| 256 | */ | - | ||||||
| 257 | qreal QQuickFontMetrics::strikeOutPosition() const | - | ||||||
| 258 | { | - | ||||||
| 259 | return m_metrics.strikeOutPos(); executed 20 times by 1 test: return m_metrics.strikeOutPos();Executed by:
| 20 | ||||||
| 260 | } | - | ||||||
| 261 | - | |||||||
| 262 | /*! | - | ||||||
| 263 | \qmlproperty real QtQuick::FontMetrics::lineWidth | - | ||||||
| 264 | - | |||||||
| 265 | This property holds the width of the underline and strikeout lines, | - | ||||||
| 266 | adjusted for the point size of the font. | - | ||||||
| 267 | - | |||||||
| 268 | \sa {QFontMetricsF::lineWidth()} | - | ||||||
| 269 | */ | - | ||||||
| 270 | qreal QQuickFontMetrics::lineWidth() const | - | ||||||
| 271 | { | - | ||||||
| 272 | return m_metrics.lineWidth(); executed 20 times by 1 test: return m_metrics.lineWidth();Executed by:
| 20 | ||||||
| 273 | } | - | ||||||
| 274 | - | |||||||
| 275 | /*! | - | ||||||
| 276 | \qmlmethod qreal QtQuick::FontMetrics::advanceWidth(string text) | - | ||||||
| 277 | - | |||||||
| 278 | This method returns the advance in pixels of the characters in \a text. | - | ||||||
| 279 | This is the distance from the position of the string to where the next | - | ||||||
| 280 | string should be drawn. | - | ||||||
| 281 | - | |||||||
| 282 | This method is offered as an imperative alternative to the | - | ||||||
| 283 | \l {QQuickTextMetrics::advanceWidth}{advanceWidth} property of | - | ||||||
| 284 | \l {QQuickTextMetrics::advanceWidth}{TextMetrics}. | - | ||||||
| 285 | - | |||||||
| 286 | \sa {QFontMetricsF::width()}, {QFontMetricsF::height()} | - | ||||||
| 287 | */ | - | ||||||
| 288 | qreal QQuickFontMetrics::advanceWidth(const QString &text) const | - | ||||||
| 289 | { | - | ||||||
| 290 | return m_metrics.width(text); executed 200 times by 1 test: return m_metrics.width(text);Executed by:
| 200 | ||||||
| 291 | } | - | ||||||
| 292 | - | |||||||
| 293 | /*! | - | ||||||
| 294 | \qmlmethod rect QtQuick::FontMetrics::boundingRect(string text) | - | ||||||
| 295 | - | |||||||
| 296 | This method returns the bounding rectangle of the characters in the string | - | ||||||
| 297 | specified by \a text. | - | ||||||
| 298 | - | |||||||
| 299 | This method is offered as an imperative alternative to the | - | ||||||
| 300 | \l {QQuickTextMetrics::boundingRect}{boundingRect} property of | - | ||||||
| 301 | \l {QQuickTextMetrics::boundingRect}{TextMetrics}. | - | ||||||
| 302 | - | |||||||
| 303 | \sa {QFontMetricsF::boundingRect()}, tightBoundingRect() | - | ||||||
| 304 | */ | - | ||||||
| 305 | QRectF QQuickFontMetrics::boundingRect(const QString &text) const | - | ||||||
| 306 | { | - | ||||||
| 307 | return m_metrics.boundingRect(text); executed 200 times by 1 test: return m_metrics.boundingRect(text);Executed by:
| 200 | ||||||
| 308 | } | - | ||||||
| 309 | - | |||||||
| 310 | /*! | - | ||||||
| 311 | \qmlmethod rect QtQuick::FontMetrics::tightBoundingRect(string text) | - | ||||||
| 312 | - | |||||||
| 313 | This method returns a tight bounding rectangle around the characters in the | - | ||||||
| 314 | string specified by \a text. | - | ||||||
| 315 | - | |||||||
| 316 | This method is offered as an imperative alternative to the | - | ||||||
| 317 | \l {QQuickTextMetrics::tightBoundingRect}{tightBoundingRect} property of | - | ||||||
| 318 | \l {QQuickTextMetrics::tightBoundingRect}{TextMetrics}. | - | ||||||
| 319 | - | |||||||
| 320 | \sa {QFontMetricsF::tightBoundingRect()}, boundingRect() | - | ||||||
| 321 | */ | - | ||||||
| 322 | QRectF QQuickFontMetrics::tightBoundingRect(const QString &text) const | - | ||||||
| 323 | { | - | ||||||
| 324 | return m_metrics.tightBoundingRect(text); executed 200 times by 1 test: return m_metrics.tightBoundingRect(text);Executed by:
| 200 | ||||||
| 325 | } | - | ||||||
| 326 | - | |||||||
| 327 | /*! | - | ||||||
| 328 | \qmlmethod string QtQuick::FontMetrics::elidedText(string text, enumeration mode, real width, int flags) | - | ||||||
| 329 | - | |||||||
| 330 | This method returns a returns an elided version of the string (i.e., a | - | ||||||
| 331 | string with "..." in it) if the string \a text is wider than \a width. | - | ||||||
| 332 | Otherwise, returns the original string. | - | ||||||
| 333 | - | |||||||
| 334 | The \a flags argument is optional and currently only supports | - | ||||||
| 335 | \l {Qt::TextShowMnemonic}. | - | ||||||
| 336 | - | |||||||
| 337 | This method is offered as an imperative alternative to the | - | ||||||
| 338 | \l {QQuickTextMetrics::elidedText}{elidedText} property of | - | ||||||
| 339 | \l {QQuickTextMetrics::elidedText}{TextMetrics}. | - | ||||||
| 340 | - | |||||||
| 341 | \sa {QFontMetricsF::elidedText()} | - | ||||||
| 342 | */ | - | ||||||
| 343 | QString QQuickFontMetrics::elidedText(const QString &text, Qt::TextElideMode mode, qreal width, int flags) const | - | ||||||
| 344 | { | - | ||||||
| 345 | return m_metrics.elidedText(text, mode, width, flags); executed 200 times by 1 test: return m_metrics.elidedText(text, mode, width, flags);Executed by:
| 200 | ||||||
| 346 | } | - | ||||||
| 347 | - | |||||||
| 348 | QT_END_NAMESPACE | - | ||||||
| 349 | - | |||||||
| 350 | #include "moc_qquickfontmetrics_p.cpp" | - | ||||||
| Source code | Switch to Preprocessed file |