[wxWidgets.git] / include / wx / font.h

/////////////////////////////////////////////////////////////////////////////
// Name:        wx/font.h
// Purpose:     wxFontBase class: the interface of wxFont
// Author:      Vadim Zeitlin
// Modified by:
// Created:     20.09.99
// RCS-ID:      $Id$
// Copyright:   (c) wxWindows team
// Licence:     wxWindows license
/////////////////////////////////////////////////////////////////////////////

#ifndef _WX_FONT_H_BASE_
#define _WX_FONT_H_BASE_

#ifdef __GNUG__
    #pragma interface "fontbase.h"
#endif

// ----------------------------------------------------------------------------
// headers
// ----------------------------------------------------------------------------

#include "wx/defs.h"        // for wxDEFAULT &c
#include "wx/gdiobj.h"      // the base class

// ----------------------------------------------------------------------------
// forward declarations
// ----------------------------------------------------------------------------

class WXDLLEXPORT wxFontData;
class WXDLLEXPORT wxFontBase;
class WXDLLEXPORT wxFont;

// ----------------------------------------------------------------------------
// font constants
// ----------------------------------------------------------------------------

// standard font families
enum wxFontFamily
{
    wxFONTFAMILY_DEFAULT = wxDEFAULT,
    wxFONTFAMILY_DECORATIVE = wxDECORATIVE,
    wxFONTFAMILY_ROMAN = wxROMAN,
    wxFONTFAMILY_SCRIPT = wxSCRIPT,
    wxFONTFAMILY_SWISS = wxSWISS,
    wxFONTFAMILY_MODERN = wxMODERN,
    wxFONTFAMILY_TELETYPE = wxTELETYPE,
    wxFONTFAMILY_MAX
};

// font styles
enum wxFontStyle
{
    wxFONTSTYLE_NORMAL = wxNORMAL,
    wxFONTSTYLE_ITALIC = wxITALIC,
    wxFONTSTYLE_SLANT = wxSLANT,
    wxFONTSTYLE_MAX
};

// font weights
enum wxFontWeight
{
    wxFONTWEIGHT_NORMAL = wxNORMAL,
    wxFONTWEIGHT_LIGHT = wxLIGHT,
    wxFONTWEIGHT_BOLD = wxBOLD,
    wxFONTWEIGHT_MAX
};

// font encodings
enum wxFontEncoding
{
    wxFONTENCODING_SYSTEM = -1,     // system default
    wxFONTENCODING_DEFAULT,         // current default encoding

    // ISO8859 standard defines a number of single-byte charsets
    wxFONTENCODING_ISO8859_1,       // West European (Latin1)
    wxFONTENCODING_ISO8859_2,       // Central and East European (Latin2)
    wxFONTENCODING_ISO8859_3,       // Esperanto (Latin3)
    wxFONTENCODING_ISO8859_4,       // Baltic languages (Estonian) (Latin4)
    wxFONTENCODING_ISO8859_5,       // Cyrillic
    wxFONTENCODING_ISO8859_6,       // Arabic
    wxFONTENCODING_ISO8859_7,       // Greek
    wxFONTENCODING_ISO8859_8,       // Hebrew
    wxFONTENCODING_ISO8859_9,       // Turkish (Latin5)
    wxFONTENCODING_ISO8859_10,      // Variation of Latin4 (Latin6)
    wxFONTENCODING_ISO8859_11,      // Thai
    wxFONTENCODING_ISO8859_12,      // doesn't exist currently, but put it
                                    // here anyhow to make all ISO8859
                                    // consecutive numbers
    wxFONTENCODING_ISO8859_13,      // Latin7
    wxFONTENCODING_ISO8859_14,      // Latin8
    wxFONTENCODING_ISO8859_15,      // Latin9 (a.k.a. Latin0, includes euro)
    wxFONTENCODING_ISO8859_MAX,

    // Cyrillic charset soup (see http://czyborra.com/charsets/cyrillic.html)
    wxFONTENCODING_KOI8,            // we don't support any of KOI8 variants
    wxFONTENCODING_ALTERNATIVE,     // same as MS-DOS CP866
    wxFONTENCODING_BULGARIAN,       // used under Linux in Bulgaria

    // what would we do without Microsoft? They have their own encodings
        // for DOS
    wxFONTENCODING_CP437,           // original MS-DOS codepage
    wxFONTENCODING_CP850,           // CP437 merged with Latin1
    wxFONTENCODING_CP852,           // CP437 merged with Latin2
    wxFONTENCODING_CP855,           // another cyrillic encoding
    wxFONTENCODING_CP866,           // and another one
        // and for Windows
    wxFONTENCODING_CP1250,          // WinLatin2
    wxFONTENCODING_CP1251,          // WinCyrillic
    wxFONTENCODING_CP1252,          // WinLatin1
    wxFONTENCODING_CP1253,          // WinGreek (8859-7)
    wxFONTENCODING_CP1254,          // WinTurkish
    wxFONTENCODING_CP1255,          // WinHebrew
    wxFONTENCODING_CP1256,          // WinArabic
    wxFONTENCODING_CP1257,          // WinBaltic (same as Latin 7)
    wxFONTENCODING_CP12_MAX,

    wxFONTENCODING_MAX
};

// ----------------------------------------------------------------------------
// wxFontBase represents a font object
// ----------------------------------------------------------------------------

class WXDLLEXPORT wxFontRefData;

class wxFontBase : public wxGDIObject
{
public:
    // creator function
    static wxFont *New(
        int pointSize,              // size of the font in points
        int family,                 // see wxFontFamily enum
        int style,                  // see wxFontStyle enum
        int weight,                 // see wxFontWeight enum
        bool underlined = FALSE,    // not underlined by default
        const wxString& face = wxEmptyString,              // facename
        wxFontEncoding encoding = wxFONTENCODING_DEFAULT); // ISO8859-X, ...

    // was the font successfully created?
    bool Ok() const { return m_refData != NULL; }

    // comparison
    bool operator == (const wxFont& font) const;
    bool operator != (const wxFont& font) const;

    // accessors: get the font characteristics
    virtual int GetPointSize() const = 0;
    virtual int GetFamily() const = 0;
    virtual int GetStyle() const = 0;
    virtual int GetWeight() const = 0;
    virtual bool GetUnderlined() const = 0;
    virtual wxString GetFaceName() const = 0;
    virtual wxFontEncoding GetEncoding() const = 0;

    // change the font characteristics
    virtual void SetPointSize( int pointSize ) = 0;
    virtual void SetFamily( int family ) = 0;
    virtual void SetStyle( int style ) = 0;
    virtual void SetWeight( int weight ) = 0;
    virtual void SetFaceName( const wxString& faceName ) = 0;
    virtual void SetUnderlined( bool underlined ) = 0;
    virtual void SetEncoding(wxFontEncoding encoding) = 0;

    // translate the fonts into human-readable string (i.e. GetStyleString()
    // will return "wxITALIC" for an italic font, ...)
    wxString GetFamilyString() const;
    wxString GetStyleString() const;
    wxString GetWeightString() const;

    // the default encoding is used for creating all fonts with default
    // encoding parameter
    static wxFontEncoding GetDefaultEncoding()
        { return ms_encodingDefault; }
    static void SetDefaultEncoding(wxFontEncoding encoding)
        { ms_encodingDefault = encoding; }

protected:
    // get the internal data
    wxFontRefData *GetFontData() const
        { return (wxFontRefData *)m_refData; }

private:
    // the currently default encoding: by default, it's the default system
    // encoding, but may be changed by the application using
    // SetDefaultEncoding() to make all subsequent fonts created without
    // specifing encoding parameter using this encoding
    static wxFontEncoding ms_encodingDefault;
};

// include the real class declaration
#if defined(__WXMSW__)
    #include "wx/msw/font.h"
#elif defined(__WXMOTIF__)
    #include "wx/motif/font.h"
#elif defined(__WXGTK__)
    #include "wx/gtk/font.h"
#elif defined(__WXQT__)
    #include "wx/qt/font.h"
#elif defined(__WXMAC__)
    #include "wx/mac/font.h"
#elif defined(__WXPM__)
    #include "wx/os2/font.h"
#elif defined(__WXSTUBS__)
    #include "wx/stubs/font.h"
#endif

// ----------------------------------------------------------------------------
// macros
// ----------------------------------------------------------------------------

#define M_FONTDATA GetFontData()

#endif
    // _WX_FONT_H_BASE_
Commit	Line	Data
0c5d3e1c VZ	1	/////////////////////////////////////////////////////////////////////////////
	2	// Name: wx/font.h
	3	// Purpose: wxFontBase class: the interface of wxFont
	4	// Author: Vadim Zeitlin
	5	// Modified by:
	6	// Created: 20.09.99
	7	// RCS-ID: $Id$
	8	// Copyright: (c) wxWindows team
	9	// Licence: wxWindows license
	10	/////////////////////////////////////////////////////////////////////////////
	11
34138703 JS	12	#ifndef _WX_FONT_H_BASE_
34138703 JS	13	#define _WX_FONT_H_BASE_
c801d85f	14
1b68e0b5 RR	15	#ifdef __GNUG__
	16	#pragma interface "fontbase.h"
	17	#endif
	18
0c5d3e1c VZ	19	// ----------------------------------------------------------------------------
	20	// headers
	21	// ----------------------------------------------------------------------------
	22
	23	#include "wx/defs.h" // for wxDEFAULT &c
	24	#include "wx/gdiobj.h" // the base class
	25
	26	// ----------------------------------------------------------------------------
	27	// forward declarations
	28	// ----------------------------------------------------------------------------
	29
7beba2fc	30	class WXDLLEXPORT wxFontData;
0c5d3e1c VZ	31	class WXDLLEXPORT wxFontBase;
	32	class WXDLLEXPORT wxFont;
	33
	34	// ----------------------------------------------------------------------------
	35	// font constants
	36	// ----------------------------------------------------------------------------
	37
	38	// standard font families
	39	enum wxFontFamily
	40	{
	41	wxFONTFAMILY_DEFAULT = wxDEFAULT,
	42	wxFONTFAMILY_DECORATIVE = wxDECORATIVE,
	43	wxFONTFAMILY_ROMAN = wxROMAN,
	44	wxFONTFAMILY_SCRIPT = wxSCRIPT,
	45	wxFONTFAMILY_SWISS = wxSWISS,
	46	wxFONTFAMILY_MODERN = wxMODERN,
	47	wxFONTFAMILY_TELETYPE = wxTELETYPE,
	48	wxFONTFAMILY_MAX
	49	};
	50
	51	// font styles
	52	enum wxFontStyle
	53	{
	54	wxFONTSTYLE_NORMAL = wxNORMAL,
	55	wxFONTSTYLE_ITALIC = wxITALIC,
	56	wxFONTSTYLE_SLANT = wxSLANT,
	57	wxFONTSTYLE_MAX
	58	};
	59
	60	// font weights
	61	enum wxFontWeight
	62	{
	63	wxFONTWEIGHT_NORMAL = wxNORMAL,
	64	wxFONTWEIGHT_LIGHT = wxLIGHT,
	65	wxFONTWEIGHT_BOLD = wxBOLD,
	66	wxFONTWEIGHT_MAX
	67	};
	68
	69	// font encodings
	70	enum wxFontEncoding
	71	{
	72	wxFONTENCODING_SYSTEM = -1, // system default
	73	wxFONTENCODING_DEFAULT, // current default encoding
	74
	75	// ISO8859 standard defines a number of single-byte charsets
	76	wxFONTENCODING_ISO8859_1, // West European (Latin1)
	77	wxFONTENCODING_ISO8859_2, // Central and East European (Latin2)
	78	wxFONTENCODING_ISO8859_3, // Esperanto (Latin3)
	79	wxFONTENCODING_ISO8859_4, // Baltic languages (Estonian) (Latin4)
	80	wxFONTENCODING_ISO8859_5, // Cyrillic
	81	wxFONTENCODING_ISO8859_6, // Arabic
	82	wxFONTENCODING_ISO8859_7, // Greek
	83	wxFONTENCODING_ISO8859_8, // Hebrew
	84	wxFONTENCODING_ISO8859_9, // Turkish (Latin5)
	85	wxFONTENCODING_ISO8859_10, // Variation of Latin4 (Latin6)
	86	wxFONTENCODING_ISO8859_11, // Thai
	87	wxFONTENCODING_ISO8859_12, // doesn't exist currently, but put it
	88	// here anyhow to make all ISO8859
	89	// consecutive numbers
	90	wxFONTENCODING_ISO8859_13, // Latin7
	91	wxFONTENCODING_ISO8859_14, // Latin8
	92	wxFONTENCODING_ISO8859_15, // Latin9 (a.k.a. Latin0, includes euro)
3c1866e8	93	wxFONTENCODING_ISO8859_MAX,
0c5d3e1c VZ	94
	95	// Cyrillic charset soup (see http://czyborra.com/charsets/cyrillic.html)
	96	wxFONTENCODING_KOI8, // we don't support any of KOI8 variants
	97	wxFONTENCODING_ALTERNATIVE, // same as MS-DOS CP866
	98	wxFONTENCODING_BULGARIAN, // used under Linux in Bulgaria
	99
	100	// what would we do without Microsoft? They have their own encodings
	101	// for DOS
	102	wxFONTENCODING_CP437, // original MS-DOS codepage
	103	wxFONTENCODING_CP850, // CP437 merged with Latin1
	104	wxFONTENCODING_CP852, // CP437 merged with Latin2
	105	wxFONTENCODING_CP855, // another cyrillic encoding
b9b3ccd9	106	wxFONTENCODING_CP866, // and another one
0c5d3e1c VZ	107	// and for Windows
	108	wxFONTENCODING_CP1250, // WinLatin2
	109	wxFONTENCODING_CP1251, // WinCyrillic
	110	wxFONTENCODING_CP1252, // WinLatin1
3c1866e8 VZ	111	wxFONTENCODING_CP1253, // WinGreek (8859-7)
	112	wxFONTENCODING_CP1254, // WinTurkish
	113	wxFONTENCODING_CP1255, // WinHebrew
	114	wxFONTENCODING_CP1256, // WinArabic
	115	wxFONTENCODING_CP1257, // WinBaltic (same as Latin 7)
	116	wxFONTENCODING_CP12_MAX,
0c5d3e1c VZ	117
	118	wxFONTENCODING_MAX
	119	};
	120
	121	// ----------------------------------------------------------------------------
	122	// wxFontBase represents a font object
	123	// ----------------------------------------------------------------------------
	124
4d85bcd1 JS	125	class WXDLLEXPORT wxFontRefData;
4d85bcd1 JS	126
0c5d3e1c VZ	127	class wxFontBase : public wxGDIObject
	128	{
	129	public:
	130	// creator function
	131	static wxFont *New(
	132	int pointSize, // size of the font in points
	133	int family, // see wxFontFamily enum
	134	int style, // see wxFontStyle enum
	135	int weight, // see wxFontWeight enum
	136	bool underlined = FALSE, // not underlined by default
	137	const wxString& face = wxEmptyString, // facename
	138	wxFontEncoding encoding = wxFONTENCODING_DEFAULT); // ISO8859-X, ...
	139
	140	// was the font successfully created?
	141	bool Ok() const { return m_refData != NULL; }
	142
	143	// comparison
	144	bool operator == (const wxFont& font) const;
	145	bool operator != (const wxFont& font) const;
	146
	147	// accessors: get the font characteristics
	148	virtual int GetPointSize() const = 0;
	149	virtual int GetFamily() const = 0;
	150	virtual int GetStyle() const = 0;
	151	virtual int GetWeight() const = 0;
	152	virtual bool GetUnderlined() const = 0;
	153	virtual wxString GetFaceName() const = 0;
	154	virtual wxFontEncoding GetEncoding() const = 0;
	155
	156	// change the font characteristics
	157	virtual void SetPointSize( int pointSize ) = 0;
	158	virtual void SetFamily( int family ) = 0;
	159	virtual void SetStyle( int style ) = 0;
	160	virtual void SetWeight( int weight ) = 0;
	161	virtual void SetFaceName( const wxString& faceName ) = 0;
	162	virtual void SetUnderlined( bool underlined ) = 0;
	163	virtual void SetEncoding(wxFontEncoding encoding) = 0;
	164
	165	// translate the fonts into human-readable string (i.e. GetStyleString()
	166	// will return "wxITALIC" for an italic font, ...)
	167	wxString GetFamilyString() const;
	168	wxString GetStyleString() const;
	169	wxString GetWeightString() const;
	170
	171	// the default encoding is used for creating all fonts with default
	172	// encoding parameter
	173	static wxFontEncoding GetDefaultEncoding()
	174	{ return ms_encodingDefault; }
	175	static void SetDefaultEncoding(wxFontEncoding encoding)
	176	{ ms_encodingDefault = encoding; }
	177
	178	protected:
	179	// get the internal data
4d85bcd1	180	wxFontRefData *GetFontData() const
0c5d3e1c VZ	181	{ return (wxFontRefData *)m_refData; }
	182
	183	private:
	184	// the currently default encoding: by default, it's the default system
	185	// encoding, but may be changed by the application using
	186	// SetDefaultEncoding() to make all subsequent fonts created without
	187	// specifing encoding parameter using this encoding
	188	static wxFontEncoding ms_encodingDefault;
	189	};
	190
	191	// include the real class declaration
2049ba38	192	#if defined(__WXMSW__)
0c5d3e1c	193	#include "wx/msw/font.h"
2049ba38	194	#elif defined(__WXMOTIF__)
0c5d3e1c	195	#include "wx/motif/font.h"
2049ba38	196	#elif defined(__WXGTK__)
0c5d3e1c	197	#include "wx/gtk/font.h"
b4e76e0d	198	#elif defined(__WXQT__)
0c5d3e1c	199	#include "wx/qt/font.h"
34138703	200	#elif defined(__WXMAC__)
0c5d3e1c	201	#include "wx/mac/font.h"
1777b9bb	202	#elif defined(__WXPM__)
0c5d3e1c	203	#include "wx/os2/font.h"
34138703	204	#elif defined(__WXSTUBS__)
0c5d3e1c	205	#include "wx/stubs/font.h"
c801d85f KB	206	#endif
c801d85f KB	207
0c5d3e1c VZ	208	// ----------------------------------------------------------------------------
	209	// macros
	210	// ----------------------------------------------------------------------------
	211
0c5d3e1c VZ	212	#define M_FONTDATA GetFontData()
0c5d3e1c VZ	213
c801d85f	214	#endif
34138703	215	// _WX_FONT_H_BASE_