Mercurial > hg > easyhg
comparison textabbrev.h @ 50:c76782c14371
* Use specific includes instead of QtCore, QtGui etc; bring in TextAbbrev class
author | Chris Cannam |
---|---|
date | Thu, 11 Nov 2010 22:04:59 +0000 |
parents | |
children | 3c46b2ac45d3 |
comparison
equal
deleted
inserted
replaced
49:f9b53c10a3f6 | 50:c76782c14371 |
---|---|
1 /* -*- c-basic-offset: 4 indent-tabs-mode: nil -*- vi:set ts=8 sts=4 sw=4: */ | |
2 | |
3 /* | |
4 Sonic Visualiser | |
5 An audio file viewer and annotation editor. | |
6 Centre for Digital Music, Queen Mary, University of London. | |
7 This file copyright 2006-2007 Chris Cannam and QMUL. | |
8 | |
9 This program is free software; you can redistribute it and/or | |
10 modify it under the terms of the GNU General Public License as | |
11 published by the Free Software Foundation; either version 2 of the | |
12 License, or (at your option) any later version. See the file | |
13 COPYING included with this distribution for more information. | |
14 */ | |
15 | |
16 #ifndef _TEXT_ABBREV_H_ | |
17 #define _TEXT_ABBREV_H_ | |
18 | |
19 #include <QString> | |
20 #include <QStringList> | |
21 | |
22 class QFontMetrics; | |
23 | |
24 class TextAbbrev | |
25 { | |
26 public: | |
27 enum Policy { | |
28 ElideEnd, | |
29 ElideEndAndCommonPrefixes, | |
30 ElideStart, | |
31 ElideMiddle | |
32 }; | |
33 | |
34 /** | |
35 * Abbreviate the given text to the given maximum length | |
36 * (including ellipsis), using the given abbreviation policy. If | |
37 * fuzzy is true, the text will be left alone if it is "not much | |
38 * more than" the maximum length. | |
39 * | |
40 * If ellipsis is non-empty, it will be used to show elisions in | |
41 * preference to the default (which is "..."). | |
42 */ | |
43 static QString abbreviate(QString text, int maxLength, | |
44 Policy policy = ElideEnd, | |
45 bool fuzzy = true, | |
46 QString ellipsis = ""); | |
47 | |
48 /** | |
49 * Abbreviate the given text to the given maximum painted width, | |
50 * using the given abbreviation policy. maxWidth is also modified | |
51 * so as to return the painted width of the abbreviated text. | |
52 * | |
53 * If ellipsis is non-empty, it will be used to show elisions in | |
54 * preference to the default (which is tr("...")). | |
55 */ | |
56 static QString abbreviate(QString text, | |
57 const QFontMetrics &metrics, | |
58 int &maxWidth, | |
59 Policy policy = ElideEnd, | |
60 QString ellipsis = ""); | |
61 | |
62 /** | |
63 * Abbreviate all of the given texts to the given maximum length, | |
64 * using the given abbreviation policy. If fuzzy is true, texts | |
65 * that are "not much more than" the maximum length will be left | |
66 * alone. | |
67 * | |
68 * If ellipsis is non-empty, it will be used to show elisions in | |
69 * preference to the default (which is tr("...")). | |
70 */ | |
71 static QStringList abbreviate(const QStringList &texts, int maxLength, | |
72 Policy policy = ElideEndAndCommonPrefixes, | |
73 bool fuzzy = true, | |
74 QString ellipsis = ""); | |
75 | |
76 /** | |
77 * Abbreviate all of the given texts to the given maximum painted | |
78 * width, using the given abbreviation policy. maxWidth is also | |
79 * modified so as to return the maximum painted width of the | |
80 * abbreviated texts. | |
81 * | |
82 * If ellipsis is non-empty, it will be used to show elisions in | |
83 * preference to the default (which is tr("...")). | |
84 */ | |
85 static QStringList abbreviate(const QStringList &texts, | |
86 const QFontMetrics &metrics, | |
87 int &maxWidth, | |
88 Policy policy = ElideEndAndCommonPrefixes, | |
89 QString ellipsis = ""); | |
90 | |
91 protected: | |
92 static QString getDefaultEllipsis(); | |
93 static int getFuzzLength(QString ellipsis); | |
94 static int getFuzzWidth(const QFontMetrics &metrics, QString ellipsis); | |
95 static QString abbreviateTo(QString text, int characters, | |
96 Policy policy, QString ellipsis); | |
97 static QStringList elidePrefixes(const QStringList &texts, | |
98 int targetReduction, | |
99 QString ellipsis); | |
100 static QStringList elidePrefixes(const QStringList &texts, | |
101 const QFontMetrics &metrics, | |
102 int targetWidthReduction, | |
103 QString ellipsis); | |
104 static int getPrefixLength(const QStringList &texts); | |
105 }; | |
106 | |
107 #endif | |
108 |