phoenix_title wx.FontList

A font list is a list containing all fonts which have been created.

There is only one instance of this class: wx.TheFontList .

Use this object to search for a previously created font of the desired type and create it if not already found.

In some windowing systems, the font may be a scarce resource, so it is best to reuse old resources if possible. When an application finishes, all fonts will be deleted and their resources freed, eliminating the possibility of ‘memory leaks’.

See also

wx.Font


class_hierarchy Class Hierarchy

Inheritance diagram for class FontList:

method_summary Methods Summary

__init__

Constructor.

FindOrCreateFont

Finds a font of the given specification, or creates one and adds it to the list.


api Class API

class wx.FontList(object)

Possible constructors:

FontList() -> None

A font list is a list containing all fonts which have been created.


Methods

__init__(self)

Constructor.

The application should not construct its own font list: use the object pointer wx.TheFontList .

Return type:

None



FindOrCreateFont(self, *args, **kw)

overload Overloaded Implementations:



FindOrCreateFont (self, point_size, family, style, weight, underline=False, facename=’’, encoding=FONTENCODING_DEFAULT)

Finds a font of the given specification, or creates one and adds it to the list.

See the Font constructor for details of the arguments.

Note that in the new code it’s preferable to use FindOrCreateFont overload taking wx.FontInfo, as it can be used for the fonts with fractional point sizes or fonts with sizes specified in pixels, unlike this overload which can only be used with the fonts using integer size in points.

Parameters:
Return type:

wx.Font



FindOrCreateFont (self, fontInfo)

Finds a font of the given specification, or creates one and adds it to the list.

See the Font constructor for details of the arguments.

Example of using this function to retrieve (creating it if necessary) a bold font of size 20:

Parameters:

fontInfo (wx.FontInfo)

Return type:

wx.Font

Returns:

Font pointer which must not be deleted by the caller. The pointer is normally always valid, i.e. non-null.

Added in version 4.1/wxWidgets-3.1.1.