diff options
Diffstat (limited to 'src/gui/text/qtextlayout.h')
-rw-r--r-- | src/gui/text/qtextlayout.h | 111 |
1 files changed, 44 insertions, 67 deletions
diff --git a/src/gui/text/qtextlayout.h b/src/gui/text/qtextlayout.h index 2fc0fcd55a..5b1b64d7ee 100644 --- a/src/gui/text/qtextlayout.h +++ b/src/gui/text/qtextlayout.h @@ -1,55 +1,20 @@ -/**************************************************************************** -** -** Copyright (C) 2016 The Qt Company Ltd. -** Contact: https://www.qt.io/licensing/ -** -** This file is part of the QtGui 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$ -** -****************************************************************************/ +// Copyright (C) 2016 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 #ifndef QTEXTLAYOUT_H #define QTEXTLAYOUT_H -#include <QtGui/qtguiglobal.h> -#include <QtCore/qstring.h> -#include <QtCore/qnamespace.h> -#include <QtCore/qrect.h> -#include <QtCore/qvector.h> #include <QtGui/qcolor.h> -#include <QtCore/qobject.h> #include <QtGui/qevent.h> -#include <QtGui/qtextformat.h> #include <QtGui/qglyphrun.h> #include <QtGui/qtextcursor.h> +#include <QtGui/qtextformat.h> +#include <QtGui/qtguiglobal.h> + +#include <QtCore/qlist.h> +#include <QtCore/qnamespace.h> +#include <QtCore/qobject.h> +#include <QtCore/qrect.h> +#include <QtCore/qstring.h> QT_BEGIN_NAMESPACE @@ -104,22 +69,21 @@ class QTextOption; class Q_GUI_EXPORT QTextLayout { public: + enum GlyphRunRetrievalFlag : quint16 { + RetrieveGlyphIndexes = 0x1, + RetrieveGlyphPositions = 0x2, + RetrieveStringIndexes = 0x4, + RetrieveString = 0x8, + + DefaultRetrievalFlags = RetrieveGlyphIndexes | RetrieveGlyphPositions, + RetrieveAll = 0xffff + }; + Q_DECLARE_FLAGS(GlyphRunRetrievalFlags, GlyphRunRetrievalFlag) + // does itemization QTextLayout(); QTextLayout(const QString& text); -#if QT_VERSION < QT_VERSION_CHECK(6, 0, 0) - QTextLayout(const QString &text, const QFont &font, QPaintDevice *paintdevice = nullptr); -#ifndef Q_QDOC - // the template is necessary to make QTextLayout(font,text,nullptr) and QTextLayout(font,text,NULL) - // not ambiguous. Implementation detail that should not be documented. - template<char = 0> -#endif - QTextLayout(const QString &textData, const QFont &textFont, const QPaintDevice *paintdevice) - : QTextLayout(textData, textFont, const_cast<QPaintDevice*>(paintdevice)) - {} -#else QTextLayout(const QString &text, const QFont &font, const QPaintDevice *paintdevice = nullptr); -#endif QTextLayout(const QTextBlock &b); ~QTextLayout(); @@ -150,13 +114,8 @@ public: friend bool operator!=(const FormatRange &lhs, const FormatRange &rhs) { return !operator==(lhs, rhs); } }; -#if QT_DEPRECATED_SINCE(5, 6) - QT_DEPRECATED_X("Use setFormats()") void setAdditionalFormats(const QList<FormatRange> &overrides); - QT_DEPRECATED_X("Use formats()") QList<FormatRange> additionalFormats() const; - QT_DEPRECATED_X("Use clearFormats()") void clearAdditionalFormats(); -#endif - void setFormats(const QVector<FormatRange> &overrides); - QVector<FormatRange> formats() const; + void setFormats(const QList<FormatRange> &overrides); + QList<FormatRange> formats() const; void clearFormats(); void setCacheEnabled(bool enable); @@ -185,7 +144,8 @@ public: int leftCursorPosition(int oldPos) const; int rightCursorPosition(int oldPos) const; - void draw(QPainter *p, const QPointF &pos, const QVector<FormatRange> &selections = QVector<FormatRange>(), + void draw(QPainter *p, const QPointF &pos, + const QList<FormatRange> &selections = QList<FormatRange>(), const QRectF &clip = QRectF()) const; void drawCursor(QPainter *p, const QPointF &pos, int cursorPosition) const; void drawCursor(QPainter *p, const QPointF &pos, int cursorPosition, int width) const; @@ -199,7 +159,15 @@ public: qreal maximumWidth() const; #if !defined(QT_NO_RAWFONT) + +# if QT_VERSION < QT_VERSION_CHECK(7, 0, 0) + QList<QGlyphRun> glyphRuns(int from, int length, GlyphRunRetrievalFlags flags) const; QList<QGlyphRun> glyphRuns(int from = -1, int length = -1) const; +# else + QList<QGlyphRun> glyphRuns(int from = -1, + int length = -1, + GlyphRunRetrievalFlags flags = DefaultRetrievalFlags) const; +# endif #endif QTextEngine *engine() const { return d; } @@ -217,7 +185,7 @@ private: QTextEngine *d; }; Q_DECLARE_TYPEINFO(QTextLayout::FormatRange, Q_RELOCATABLE_TYPE); - +Q_DECLARE_OPERATORS_FOR_FLAGS(QTextLayout::GlyphRunRetrievalFlags) class Q_GUI_EXPORT QTextLine { @@ -267,15 +235,24 @@ public: int lineNumber() const { return index; } - void draw(QPainter *p, const QPointF &point, const QTextLayout::FormatRange *selection = nullptr) const; + void draw(QPainter *painter, const QPointF &position) const; #if !defined(QT_NO_RAWFONT) +# if QT_VERSION < QT_VERSION_CHECK(7, 0, 0) + QList<QGlyphRun> glyphRuns(int from, int length, QTextLayout::GlyphRunRetrievalFlags flags) const; QList<QGlyphRun> glyphRuns(int from = -1, int length = -1) const; +# else + QList<QGlyphRun> glyphRuns(int from = -1, + int length = -1, + QTextLayout::GlyphRunRetrievalFlags flags = QTextLayout::DefaultRetrievalFlags) const; +# endif #endif private: QTextLine(int line, QTextEngine *e) : index(line), eng(e) {} void layout_helper(int numGlyphs); + void draw_internal(QPainter *p, const QPointF &pos, + const QTextLayout::FormatRange *selection) const; friend class QTextLayout; friend class QTextFragment; |