qfont.h

/****************************************************************************
** $Id: qfont.h,v 2.32 1999/06/23 03:18:59 warwick Exp $
**
** Definition of QFont class
**
** Created : 940514
**
** Copyright (C) 1992-1999 Troll Tech AS.  All rights reserved.
**
** This file is part of the Qt GUI Toolkit.
**
** This file may be distributed under the terms of the Q Public License
** as defined by Troll Tech AS of Norway and appearing in the file
** LICENSE.QPL included in the packaging of this file.
**
** Licensees holding valid Qt Professional Edition licenses may use this
** file in accordance with the Qt Professional Edition License Agreement
** provided with the Qt Professional Edition.
**
** See http://www.troll.no/pricing.html or email sales@troll.no for
** information about the Professional Edition licensing, or see
** http://www.troll.no/qpl/ for QPL licensing information.
**
*****************************************************************************/

#ifndef QFONT_H
#define QFONT_H

#ifndef QT_H
#include "qwindowdefs.h"
#include "qstring.h"
#endif // QT_H


class QStringList;
struct QFontDef;
struct QFontData;
class  QFontInternal;


class Q_EXPORT QFont                                    // font class
{
public:
    enum CharSet   { ISO_8859_1,  Latin1 = ISO_8859_1, AnyCharSet,
                     ISO_8859_2,  Latin2 = ISO_8859_2,
                     ISO_8859_3,  Latin3 = ISO_8859_3,
                     ISO_8859_4,  Latin4 = ISO_8859_4,
                     ISO_8859_5,
                     ISO_8859_6,
                     ISO_8859_7,
                     ISO_8859_8,
                     ISO_8859_9,  Latin5 = ISO_8859_9,
                     ISO_8859_10, Latin6 = ISO_8859_10,
                     ISO_8859_11,
                     ISO_8859_12,
                     ISO_8859_13, Latin7 = ISO_8859_13,
                     ISO_8859_14, Latin8 = ISO_8859_14,
                     ISO_8859_15, Latin9 = ISO_8859_15,
                     KOI8R,
                     Set_Ja, Set_1 = Set_Ja,
                     Set_Ko,
                     Set_Th_TH,
                     Set_Zh,
                     Set_Zh_TW, Set_N = Set_Zh_TW,
                     Unicode
                    };
    enum StyleHint { Helvetica, Times, Courier, OldEnglish,  System, AnyStyle,
                     SansSerif  = Helvetica,
                     Serif      = Times,
                     TypeWriter = Courier,
                     Decorative = OldEnglish};
    enum Weight    { Light = 25, Normal = 50, DemiBold = 63,
                     Bold  = 75, Black  = 87 };
    QFont();                                    // default font
    QFont( const QString &family, int pointSize = 12,
           int weight = Normal, bool italic = FALSE );
    QFont( const QString &family, int pointSize,
           int weight, bool italic, CharSet charSet );
    QFont( const QFont & );
    ~QFont();
    QFont      &operator=( const QFont & );

    QString     family()        const;
    void        setFamily( const QString &);
    int         pointSize()     const;
    float       pointSizeFloat()        const;
    void        setPointSize( int );
    void        setPointSizeFloat( float );
    int         pixelSize() const;
    void        setPixelSize( int );
    void        setPixelSizeFloat( float );
    int         weight()        const;
    void        setWeight( int );
    bool        bold()          const;
    void        setBold( bool );
    bool        italic()        const;
    void        setItalic( bool );
    bool        underline()     const;
    void        setUnderline( bool );
    bool        strikeOut()     const;
    void        setStrikeOut( bool );
    bool        fixedPitch()    const;
    void        setFixedPitch( bool );
    StyleHint   styleHint()     const;
    void        setStyleHint( StyleHint );
    CharSet     charSet()       const;
    void        setCharSet( CharSet );

    static CharSet charSetForLocale();

    bool        rawMode()       const;
    void        setRawMode( bool );

    bool        exactMatch()    const;

    bool        operator==( const QFont & ) const;
    bool        operator!=( const QFont & ) const;
    bool        isCopyOf( const QFont & ) const;

#if defined(_WS_WIN_)
    HFONT       handle() const;
#elif defined(_WS_X11_)
    HANDLE      handle() const;
#endif

    void        setRawName( const QString & );
    QString     rawName() const;

    QString     key() const;

    static QString encodingName( CharSet );

    static const QFont defaultFont();
    static void setDefaultFont( const QFont & );

    static QString substitute( const QString &familyName );
    static void insertSubstitution( const QString&, const QString &);
    static void removeSubstitution( const QString &);
    static QStringList substitutions();

    static void initialize();
    static void locale_init();
    static void cleanup();
    static void cacheStatistics();

protected:
    bool        dirty()                 const;

    QString     defaultFamily()         const;
    QString     lastResortFamily()      const;
    QString     lastResortFont()        const;
    int         deciPointSize()         const;

private:
    QFont( QFontData * );
    void        init();
    void        detach();
    void        initFontInfo() const;
    void        load() const;
#if defined(_WS_WIN_)
    HFONT       create( bool *, HDC=0, bool=FALSE ) const;
    void       *textMetric() const;
#endif

    friend class QFontMetrics;
    friend class QFontInfo;
    friend class QPainter;
    friend Q_EXPORT QDataStream &operator<<( QDataStream &, const QFont & );
    friend Q_EXPORT QDataStream &operator>>( QDataStream &, QFont & );

    QFontData    *d;                            // internal font data
    static CharSet defaultCharSet;
};

inline bool QFont::bold() const
{ return weight() > Normal; }

inline void QFont::setBold( bool enable )
{ setWeight( enable ? Bold : Normal ); }


/*****************************************************************************
  QFont stream functions
 *****************************************************************************/

Q_EXPORT QDataStream &operator<<( QDataStream &, const QFont & );
Q_EXPORT QDataStream &operator>>( QDataStream &, QFont & );


#endif // QFONT_H