wxFont

Description

A font is an object which determines the appearance of text.

Fonts are used for drawing text to a device context, and setting the appearance of a window's text, see wxDC:setFont/2 and wxWindow:setFont/2.

The easiest way to create a custom font is to use wxFontInfo (not implemented in wx) object to specify the font attributes and then use new/5 constructor. Alternatively, you could start with one of the pre-defined fonts or use wxWindow:getFont/1 and modify the font, e.g. by increasing its size using MakeLarger() (not implemented in wx) or changing its weight using MakeBold() (not implemented in wx).

This class uses reference counting and copy-on-write internally so that assignments between two instances of this class are very cheap. You can therefore use actual objects instead of pointers without efficiency problems. If an instance of this class is changed it will create its own data internally so that other instances, which previously shared the data using the reference counting, are not affected.

You can retrieve the current system font settings with wxSystemSettings.

Predefined objects (include wx.hrl): ?wxNullFont, ?wxNORMAL_FONT, ?wxSMALL_FONT, ?wxITALIC_FONT, ?wxSWISS_FONT

See: Overview font, wxDC:setFont/2, wxDC:drawText/3, wxDC:getTextExtent/3, wxFontDialog, wxSystemSettings

wxWidgets docs: wxFont

Data Types

wxFont() = wx:wx_object()

Exports

new() -> wxFont()

Default ctor.

new(NativeInfoString) -> wxFont()

new(Font) -> wxFont()

Types

Font = wxFont()

Copy constructor, uses reference counting.

new(PointSize, Family, Style, Weight) -> wxFont()

new(PixelSize, Family, Style, Weight) -> wxFont()

Types

PixelSize = {W :: integer(), H :: integer()}

Family = Style = Weight = wx:wx_enum()

new(PointSize, Family, Style, Weight, Options :: [Option]) ->
wxFont()

new(PixelSize, Family, Style, Weight, Options :: [Option]) ->
wxFont()

Types

PixelSize = {W :: integer(), H :: integer()}

Family = Style = Weight = wx:wx_enum()

Option =
    {underline, boolean()} |
    {faceName, unicode:chardata()} |
    {encoding, wx:wx_enum()}

Creates a font object with the specified attributes and size in pixels.

Notice that the use of this constructor is often more verbose and less readable than the use of constructor from wxFontInfo (not implemented in wx), consider using that constructor instead.

Remark: If the desired font does not exist, the closest match will be chosen. Under Windows, only scalable TrueType fonts are used.

destroy(This :: wxFont()) -> ok

Destructor.

See reference-counted object destruction for more info.

Remark: Although all remaining fonts are deleted when the application exits, the application should try to clean up all fonts itself. This is because wxWidgets cannot know if a pointer to the font object is stored in an application data structure, and there is a risk of double deletion.

isFixedWidth(This) -> boolean()

Table of Contents

wxFont

Module

Module Summary

Description

Data Types

Exports

Types

Types

Types

Types

Types

Types

Types

Types

Types

Types

Types

Types

Types

Types

Types

Types

Types

Types

Types

Types

Types