qfont.h

/****************************************************************************
** $Id: qfont.h,v 2.11.2.3 1998/08/25 09:20:52 hanord Exp $
**
** Definition of QFont class
**
** Created : 940514
**
** Copyright (C) 1992-1998 Troll Tech AS.  All rights reserved.
**
** This file is part of Qt Free Edition, version 1.42.
**
** See the file LICENSE included in the distribution for the usage
** and distribution terms, or http://www.troll.no/free-license.html.
**
** IMPORTANT NOTE: You may NOT copy this file or any part of it into
** your own programs or libraries.
**
** Please see http://www.troll.no/pricing.html for information about 
** Qt Professional Edition, which is this same library but with a
** license which allows creation of commercial/proprietary software.
**
*****************************************************************************/

#ifndef QFONT_H
#define QFONT_H

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


class  QStrList;
struct QFontDef;
struct QFontData;
class  QFontInternal;


class Q_EXPORT QFont                                    // font class
{
public:
    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 };
    enum CharSet   { Latin1, ISO_8859_1 = Latin1, AnyCharSet,
                     Latin2, ISO_8859_2 = Latin2,
                     Latin3, ISO_8859_3 = Latin3,
                     Latin4, ISO_8859_4 = Latin4,
                     Latin5, ISO_8859_5 = Latin5,
                     Latin6, ISO_8859_6 = Latin6,
                     Latin7, ISO_8859_7 = Latin7,
                     Latin8, ISO_8859_8 = Latin8,
                     Latin9, ISO_8859_9 = Latin9,
                     KOI8R };

    QFont();                                    // default font
    QFont( const char *family, int pointSize = 12,
           int weight = Normal, bool italic = FALSE );
    QFont( const char *family, int pointSize,
           int weight, bool italic, CharSet charSet );
    QFont( const QFont & );
    virtual ~QFont();
    QFont      &operator=( const QFont & );

    const char *family()        const;
    void        setFamily( const char * );
    int         pointSize()     const;
    void        setPointSize( int );
    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 );
    bool        rawMode()       const;
    void        setRawMode( bool );

    bool        exactMatch()    const;

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

    HANDLE      handle( HANDLE=0 ) const;

    const char* rawName() const;

    QString     key() const;

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

    static const char  *substitute( const char *familyName );
    static void insertSubstitution( const char *, const char * );
    static void removeSubstitution( const char * );
    static void listSubstitutions( QStrList * );

    static void initialize();
    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 * );
    QFont( bool );
    void        init();
    void        detach();
    void        initFontInfo()      const;
    void        load( HANDLE=0 )    const;
#if defined(_WS_WIN_)
    HANDLE      create( bool *, HANDLE=0 ) 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 QFont *defFont;
};


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