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