- Family
-
-
-
-
- Supported families are:
- @b wxDEFAULT, wxDECORATIVE, wxROMAN, wxSCRIPT, wxSWISS, wxMODERN.
- @b wxMODERN is a fixed pitch font; the others are either fixed or variable pitch.
-
-
-
-
-
- Style
-
-
-
-
- The value can be @b wxNORMAL, wxSLANT or @b wxITALIC.
-
-
-
-
-
- Weight
-
-
-
-
- The value can be @b wxNORMAL, wxLIGHT or @b wxBOLD.
-
-
-
-
-
- Underlining
-
-
-
-
- The value can be @true or @false.
-
-
-
-
-
- Face name
-
-
-
-
- An optional string specifying the actual typeface to be used. If @NULL,
- a default typeface will chosen based on the family.
-
-
-
-
-
- Encoding
-
-
-
-
- The font encoding (see @b wxFONTENCODING_XXX
- constants and the @ref fontencoding_overview for more
- details)
-
-
-
-
-
- Specifying a family, rather than a specific typeface name, ensures a degree of
- portability across platforms because a suitable font will be chosen for the
- given font family, however it doesn't allow to choose a font precisely as the
- parameters above don't suffice, in general, to identify all the available fonts
- and this is where using the native font descriptions may be helpful - see
- below.
- Under Windows, the face name can be one of the installed fonts on the user's
- system. Since the choice of fonts differs from system to system, either choose
- standard Windows fonts, or if allowing the user to specify a face name, store
- the family name with any file that might be transported to a different Windows
- machine or other platform.
-
- @b Note: There is currently a difference between the appearance
- of fonts on the two platforms, if the mapping mode is anything other than
- wxMM_TEXT. Under X, font size is always specified in points. Under MS
- Windows, the unit for text is points but the text is scaled according to the
- current mapping mode. However, user scaling on a device context will also
- scale fonts under both environments.
-
- @ref nativefontinformation_overview
-
-
- @section nativefontinformation Native font information
-
- An alternative way of choosing fonts is to use the native font description.
- This is the only acceptable solution if the user is allowed to choose the font
- using the #wxFontDialog because the selected font cannot
- be described using only the family name and so, if only family name is stored
- permanently, the user would almost surely see a different font in the program
- later.
- Instead, you should store the value returned by
- wxFont::GetNativeFontInfoDesc and pass
- it to wxFont::SetNativeFontInfo later to
- recreate exactly the same font.
- Note that the contents of this string depends on the platform and shouldn't be
- used for any other purpose (in particular, it is not meant to be shown to the
- user). Also please note that although the native font information is currently
- implemented for Windows and Unix (GTK+ and Motif) ports only, all the methods
- are available for all the ports and should be used to make your program work
- correctly when they are implemented later.
-
- */