Qt Toolkit - qfont.h include file

# qfont.h

This is the verbatim text of the qfont.h include file. It is is provided only for illustration; the copyright remains with Troll Tech.

    /****************************************************************************
    ** $Id: qfont.h,v 2.11.2.5 1999/01/26 07:49:01 aavit Exp $
    **
    ** Definition of QFont class
    **
    ** Created : 940514
    **
    ** Copyright (C) 1992-1999 Troll Tech AS.  All rights reserved.
    **
    ** This file is part of Qt Free Edition, version 1.45.
    **
    ** 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, 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 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