1
/****************************************************************************
2
**
3
** Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies).
4
** All rights reserved.
5
** Contact: Nokia Corporation (qt-info@nokia.com)
6
**
7
** This file is part of the QtGui module of the Qt Toolkit.
8
**
9
** $QT_BEGIN_LICENSE:LGPL$
10
** GNU Lesser General Public License Usage
11
** This file may be used under the terms of the GNU Lesser General Public
12
** License version 2.1 as published by the Free Software Foundation and
13
** appearing in the file LICENSE.LGPL included in the packaging of this
14
** file. Please review the following information to ensure the GNU Lesser
15
** General Public License version 2.1 requirements will be met:
16
** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
17
**
18
** In addition, as a special exception, Nokia gives you certain additional
19
** rights. These rights are described in the Nokia Qt LGPL Exception
20
** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
21
**
22
** GNU General Public License Usage
23
** Alternatively, this file may be used under the terms of the GNU General
24
** Public License version 3.0 as published by the Free Software Foundation
25
** and appearing in the file LICENSE.GPL included in the packaging of this
26
** file. Please review the following information to ensure the GNU General
27
** Public License version 3.0 requirements will be met:
28
** http://www.gnu.org/copyleft/gpl.html.
29
**
30
** Other Usage
31
** Alternatively, this file may be used in accordance with the terms and
32
** conditions contained in a signed written agreement between you and Nokia.
33
**
34
**
35
**
36
**
37
**
38
** $QT_END_LICENSE$
39
**
40
****************************************************************************/
41
42
#ifndef QTEXTOPTION_H
43
#define QTEXTOPTION_H
44
45
#include <QtCore/qnamespace.h>
46
#include <QtCore/qchar.h>
47
#include <QtCore/qmetatype.h>
48
49
50
QT_BEGIN_HEADER
51
52
QT_BEGIN_NAMESPACE
53
54
QT_MODULE(Gui)
55
56
template <typename T> class QList;
57
struct QTextOptionPrivate;
58
59
class Q_GUI_EXPORT QTextOption
60
{
61
public:
62
    enum TabType {
63
        LeftTab,
64
        RightTab,
65
        CenterTab,
66
        DelimiterTab
67
    };
68
69
    struct Q_GUI_EXPORT Tab {
70
        inline Tab() : position(80), type(QTextOption::LeftTab) { }
71
        inline Tab(qreal pos, TabType tabType, QChar delim = QChar())
72
            : position(pos), type(tabType), delimiter(delim) {}
73
74
        inline bool operator==(const Tab &other) const {
75
            return type == other.type
76
                   && qFuzzyCompare(position, other.position)
77
                   && delimiter == other.delimiter;
78
        }
79
80
        inline bool operator!=(const Tab &other) const {
81
            return !operator==(other);
82
        }
83
84
        qreal position;
85
        TabType type;
86
        QChar delimiter;
87
    };
88
89
    QTextOption();
90
    QTextOption(Qt::Alignment alignment);
91
    ~QTextOption();
92
93
    QTextOption(const QTextOption &o);
94
    QTextOption &operator=(const QTextOption &o);
95
96
    inline void setAlignment(Qt::Alignment alignment);
97
    inline Qt::Alignment alignment() const { return Qt::Alignment(align); }
98
99
    inline void setTextDirection(Qt::LayoutDirection aDirection) { this->direction = aDirection; }
100
    inline Qt::LayoutDirection textDirection() const { return Qt::LayoutDirection(direction); }
101
102
    enum WrapMode {
103
        NoWrap,
104
        WordWrap,
105
        ManualWrap,
106
        WrapAnywhere,
107
        WrapAtWordBoundaryOrAnywhere
108
    };
109
    inline void setWrapMode(WrapMode wrap) { wordWrap = wrap; }
110
    inline WrapMode wrapMode() const { return static_cast<WrapMode>(wordWrap); }
111
112
    enum Flag {
113
        ShowTabsAndSpaces = 0x1,
114
        ShowLineAndParagraphSeparators = 0x2,
115
        AddSpaceForLineAndParagraphSeparators = 0x4,
116
        SuppressColors = 0x8,
117
        IncludeTrailingSpaces = 0x80000000
118
    };
119
    Q_DECLARE_FLAGS(Flags, Flag)
120
    inline void setFlags(Flags flags);
121
    inline Flags flags() const { return Flags(f); }
122
123
    inline void setTabStop(qreal tabStop);
124
    inline qreal tabStop() const { return tab; }
125
126
    void setTabArray(QList<qreal> tabStops);
127
    QList<qreal> tabArray() const;
128
129
    void setTabs(QList<Tab> tabStops);
130
    QList<Tab> tabs() const;
131
132
    void setUseDesignMetrics(bool b) { design = b; }
133
    bool useDesignMetrics() const { return design; }
134
135
private:
136
    uint align : 8;
137
    uint wordWrap : 4;
138
    uint design : 1;
139
    uint direction : 2;
140
    uint unused : 18;
141
    uint f;
142
    qreal tab;
143
    QTextOptionPrivate *d;
144
};
145
146
Q_DECLARE_OPERATORS_FOR_FLAGS(QTextOption::Flags)
147
148
inline void QTextOption::setAlignment(Qt::Alignment aalignment)
149
{ align = aalignment; }
150
151
inline void QTextOption::setFlags(Flags aflags)
152
{ f = aflags; }
153
154
inline void QTextOption::setTabStop(qreal atabStop)
155
{ tab = atabStop; }
156
157
QT_END_NAMESPACE
158
159
Q_DECLARE_METATYPE( QTextOption::Tab )
160
161
QT_END_HEADER
162
163
#endif // QTEXTOPTION_H