/****************************************************************************
**
** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).
** All rights reserved.
** Contact: Nokia Corporation (qt-info@nokia.com)
**
** This file is part of the QtGui module of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:LGPL$
** No Commercial Usage
** This file contains pre-release code and may not be distributed.
** You may use this file in accordance with the terms and conditions
** contained in the Technology Preview License Agreement accompanying
** this package.
**
** GNU Lesser General Public License Usage
** Alternatively, this file may be used under the terms of the GNU Lesser
** General Public License version 2.1 as published by the Free Software
** Foundation and appearing in the file LICENSE.LGPL included in the
** packaging of this file. Please review the following information to
** ensure the GNU Lesser General Public License version 2.1 requirements
** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
**
** In addition, as a special exception, Nokia gives you certain additional
** rights. These rights are described in the Nokia Qt LGPL Exception
** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
**
** If you have questions regarding the use of this file, please contact
** Nokia at qt-info@nokia.com.
**
**
**
**
**
**
**
**
** $QT_END_LICENSE$
**
****************************************************************************/
#ifndef QFONT_H
#define QFONT_H
#include <QtGui/qwindowdefs.h>
#include <QtCore/qstring.h>
#include <QtCore/qsharedpointer.h>
#if defined(Q_WS_X11) || defined(Q_WS_QWS)
typedef struct FT_FaceRec_* FT_Face;
#endif
QT_BEGIN_HEADER
QT_BEGIN_NAMESPACE
QT_MODULE(Gui)
class QFontPrivate; /* don't touch */
class QStringList;
class QVariant;
class Q3TextFormatCollection;
class Q_GUI_EXPORT QFont
{
Q_GADGET
Q_ENUMS(StyleStrategy)
public:
enum StyleHint {
Helvetica, SansSerif = Helvetica,
Times, Serif = Times,
Courier, TypeWriter = Courier,
OldEnglish, Decorative = OldEnglish,
System,
AnyStyle
};
enum StyleStrategy {
PreferDefault = 0x0001,
PreferBitmap = 0x0002,
PreferDevice = 0x0004,
PreferOutline = 0x0008,
ForceOutline = 0x0010,
PreferMatch = 0x0020,
PreferQuality = 0x0040,
PreferAntialias = 0x0080,
NoAntialias = 0x0100,
OpenGLCompatible = 0x0200,
ForceIntegerMetrics = 0x0400,
NoFontMerging = 0x8000
};
enum Weight {
Light = 25,
Normal = 50,
DemiBold = 63,
Bold = 75,
Black = 87
};
enum Style {
StyleNormal,
StyleItalic,
StyleOblique
};
enum Stretch {
UltraCondensed = 50,
ExtraCondensed = 62,
Condensed = 75,
SemiCondensed = 87,
Unstretched = 100,
SemiExpanded = 112,
Expanded = 125,
ExtraExpanded = 150,
UltraExpanded = 200
};
enum Capitalization {
MixedCase,
AllUppercase,
AllLowercase,
SmallCaps,
Capitalize
};
enum SpacingType {
PercentageSpacing,
AbsoluteSpacing
};
enum ResolveProperties {
FamilyResolved = 0x0001,
SizeResolved = 0x0002,
StyleHintResolved = 0x0004,
StyleStrategyResolved = 0x0008,
WeightResolved = 0x0010,
StyleResolved = 0x0020,
UnderlineResolved = 0x0040,
OverlineResolved = 0x0080,
StrikeOutResolved = 0x0100,
FixedPitchResolved = 0x0200,
StretchResolved = 0x0400,
KerningResolved = 0x0800,
CapitalizationResolved = 0x1000,
LetterSpacingResolved = 0x2000,
WordSpacingResolved = 0x4000,
AllPropertiesResolved = 0x7fff
};
QFont();
QFont(const QString &family, int pointSize = -1, int weight = -1, bool italic = false);
QFont(const QFont &, QPaintDevice *pd);
QFont(const QFont &);
~QFont();
QString family() const;
void setFamily(const QString &);
int pointSize() const;
void setPointSize(int);
qreal pointSizeF() const;
void setPointSizeF(qreal);
int pixelSize() const;
void setPixelSize(int);
int weight() const;
void setWeight(int);
inline bool bold() const;
inline void setBold(bool);
void setStyle(Style style);
Style style() const;
inline bool italic() const;
inline void setItalic(bool b);
bool underline() const;
void setUnderline(bool);
bool overline() const;
void setOverline(bool);
bool strikeOut() const;
void setStrikeOut(bool);
bool fixedPitch() const;
void setFixedPitch(bool);
bool kerning() const;
void setKerning(bool);
StyleHint styleHint() const;
StyleStrategy styleStrategy() const;
void setStyleHint(StyleHint, StyleStrategy = PreferDefault);
void setStyleStrategy(StyleStrategy s);
int stretch() const;
void setStretch(int);
qreal letterSpacing() const;
SpacingType letterSpacingType() const;
void setLetterSpacing(SpacingType type, qreal spacing);
qreal wordSpacing() const;
void setWordSpacing(qreal spacing);
void setCapitalization(Capitalization);
Capitalization capitalization() const;
// is raw mode still needed?
bool rawMode() const;
void setRawMode(bool);
// dupicated from QFontInfo
bool exactMatch() const;
QFont &operator=(const QFont &);
bool operator==(const QFont &) const;
bool operator!=(const QFont &) const;
bool operator<(const QFont &) const;
operator QVariant() const;
bool isCopyOf(const QFont &) const;
#ifdef Q_WS_WIN
HFONT handle() const;
#else // !Q_WS_WIN
Qt::HANDLE handle() const;
#endif // Q_WS_WIN
#ifdef Q_WS_MAC
quint32 macFontID() const;
#endif
#if defined(Q_WS_X11) || defined(Q_WS_QWS)
FT_Face freetypeFace() const;
#endif
// needed for X11
void setRawName(const QString &);
QString rawName() const;
QString key() const;
QString toString() const;
bool fromString(const QString &);
static QString substitute(const QString &);
static QStringList substitutes(const QString &);
static QStringList substitutions();
static void insertSubstitution(const QString&, const QString &);
static void insertSubstitutions(const QString&, const QStringList &);
static void removeSubstitution(const QString &);
static void initialize();
static void cleanup();
#ifndef Q_WS_QWS
static void cacheStatistics();
#endif
QString defaultFamily() const;
QString lastResortFamily() const;
QString lastResortFont() const;
QFont resolve(const QFont &) const;
inline uint resolve() const { return resolve_mask; }
inline void resolve(uint mask) { resolve_mask = mask; }
#ifdef QT3_SUPPORT
static QT3_SUPPORT QFont defaultFont();
static QT3_SUPPORT void setDefaultFont(const QFont &);
QT3_SUPPORT void setPixelSizeFloat(qreal);
QT3_SUPPORT qreal pointSizeFloat() const { return pointSizeF(); }
QT3_SUPPORT void setPointSizeFloat(qreal size) { setPointSizeF(size); }
#endif
private:
QFont(QFontPrivate *);
void detach();
#if defined(Q_WS_MAC)
void macSetFont(QPaintDevice *);
#elif defined(Q_WS_X11)
void x11SetScreen(int screen = -1);
int x11Screen() const;
#endif
friend class QFontPrivate;
friend class QFontDialogPrivate;
friend class QFontMetrics;
friend class QFontMetricsF;
friend class QFontInfo;
friend class QPainter;
friend class QPainterPrivate;
friend class QPSPrintEngineFont;
friend class QApplication;
friend class QWidget;
friend class QWidgetPrivate;
friend class Q3TextFormatCollection;
friend class QTextLayout;
friend class QTextEngine;
friend class QStackTextEngine;
friend class QTextLine;
friend struct QScriptLine;
friend class QGLContext;
friend class QWin32PaintEngine;
friend class QAlphaPaintEngine;
friend class QPainterPath;
friend class QTextItemInt;
friend class QPicturePaintEngine;
friend class QPainterReplayer;
friend class QPaintBufferEngine;
friend class QCommandLinkButtonPrivate;
#ifndef QT_NO_DATASTREAM
friend Q_GUI_EXPORT QDataStream &operator<<(QDataStream &, const QFont &);
friend Q_GUI_EXPORT QDataStream &operator>>(QDataStream &, QFont &);
#endif
QExplicitlySharedDataPointer<QFontPrivate> d;
uint resolve_mask;
};
inline bool QFont::bold() const
{ return weight() > Normal; }
inline void QFont::setBold(bool enable)
{ setWeight(enable ? Bold : Normal); }
inline bool QFont::italic() const
{
return (style() != StyleNormal);
}
inline void QFont::setItalic(bool b) {
setStyle(b ? StyleItalic : StyleNormal);
}
/*****************************************************************************
QFont stream functions
*****************************************************************************/
#ifndef QT_NO_DATASTREAM
Q_GUI_EXPORT QDataStream &operator<<(QDataStream &, const QFont &);
Q_GUI_EXPORT QDataStream &operator>>(QDataStream &, QFont &);
#endif
#ifndef QT_NO_DEBUG_STREAM
Q_GUI_EXPORT QDebug operator<<(QDebug, const QFont &);
#endif
QT_END_NAMESPACE
QT_END_HEADER
#endif // QFONT_H