docs/latex/wx/font.tex

   1 \section{\class{wxFont}}\label{wxfont}
   2
   3 A font is an object which determines the appearance of text. Fonts are
   4 used for drawing text to a device context, and setting the appearance of
   5 a window's text.
   6
   7 You can retrieve the current system font settings with \helpref{wxSystemSettings}{wxsystemsettings}.
   8
   9 \helpref{wxSystemSettings}{wxsystemsettings}
  10
  11 \wxheading{Derived from}
  12
  13 \helpref{wxGDIObject}{wxgdiobject}\\
  14 \helpref{wxObject}{wxobject}
  15
  16 \wxheading{Include files}
  17
  18 <wx/font.h>
  19
  20 \wxheading{Constants}
  21
  22 The possible values for the \arg{family} parameter of \helpref{wxFont
  23 constructor}{wxfontctor} are (the old names are for compatibility only):
  24
  25 \begin{verbatim}
  26 enum wxFontFamily
  27 {
  28     wxFONTFAMILY_DEFAULT = wxDEFAULT,
  29     wxFONTFAMILY_DECORATIVE = wxDECORATIVE,
  30     wxFONTFAMILY_ROMAN = wxROMAN,
  31     wxFONTFAMILY_SCRIPT = wxSCRIPT,
  32     wxFONTFAMILY_SWISS = wxSWISS,
  33     wxFONTFAMILY_MODERN = wxMODERN,
  34     wxFONTFAMILY_TELETYPE = wxTELETYPE,
  35     wxFONTFAMILY_MAX
  36 };
  37 \end{verbatim}
  38
  39 The possible values for the \arg{weight} parameter are (the old names
  40 are for compatibility only):
  41
  42 \begin{verbatim}
  43 enum wxFontWeight
  44 {
  45     wxFONTWEIGHT_NORMAL = wxNORMAL,
  46     wxFONTWEIGHT_LIGHT = wxLIGHT,
  47     wxFONTWEIGHT_BOLD = wxBOLD,
  48     wxFONTWEIGHT_MAX
  49 };
  50 \end{verbatim}
  51
  52 The font flags which can be used during the font creation are:
  53
  54 \begin{verbatim}
  55 enum
  56 {
  57     // no special flags: font with default weight/slant/anti-aliasing
  58     wxFONTFLAG_DEFAULT          = 0,
  59
  60     // slant flags (default: no slant)
  61     wxFONTFLAG_ITALIC           = 1 << 0,
  62     wxFONTFLAG_SLANT            = 1 << 1,
  63
  64     // weight flags (default: medium)
  65     wxFONTFLAG_LIGHT            = 1 << 2,
  66     wxFONTFLAG_BOLD             = 1 << 3,
  67
  68     // anti-aliasing flag: force on or off (default: the current system default)
  69     wxFONTFLAG_ANTIALIASED      = 1 << 4,
  70     wxFONTFLAG_NOT_ANTIALIASED  = 1 << 5,
  71
  72     // underlined/strikethrough flags (default: no lines)
  73     wxFONTFLAG_UNDERLINED       = 1 << 6,
  74     wxFONTFLAG_STRIKETHROUGH    = 1 << 7,
  75 };
  76 \end{verbatim}
  77
  78 The known font encodings are:
  79
  80 \begin{verbatim}
  81 enum wxFontEncoding
  82 {
  83     wxFONTENCODING_SYSTEM = -1,     // system default
  84     wxFONTENCODING_DEFAULT,         // current default encoding
  85
  86     // ISO8859 standard defines a number of single-byte charsets
  87     wxFONTENCODING_ISO8859_1,       // West European (Latin1)
  88     wxFONTENCODING_ISO8859_2,       // Central and East European (Latin2)
  89     wxFONTENCODING_ISO8859_3,       // Esperanto (Latin3)
  90     wxFONTENCODING_ISO8859_4,       // Baltic (old) (Latin4)
  91     wxFONTENCODING_ISO8859_5,       // Cyrillic
  92     wxFONTENCODING_ISO8859_6,       // Arabic
  93     wxFONTENCODING_ISO8859_7,       // Greek
  94     wxFONTENCODING_ISO8859_8,       // Hebrew
  95     wxFONTENCODING_ISO8859_9,       // Turkish (Latin5)
  96     wxFONTENCODING_ISO8859_10,      // Variation of Latin4 (Latin6)
  97     wxFONTENCODING_ISO8859_11,      // Thai
  98     wxFONTENCODING_ISO8859_12,      // doesn't exist currently, but put it
  99                                     // here anyhow to make all ISO8859
 100                                     // consecutive numbers
 101     wxFONTENCODING_ISO8859_13,      // Baltic (Latin7)
 102     wxFONTENCODING_ISO8859_14,      // Latin8
 103     wxFONTENCODING_ISO8859_15,      // Latin9 (a.k.a. Latin0, includes euro)
 104     wxFONTENCODING_ISO8859_MAX,
 105
 106     // Cyrillic charset soup (see http://czyborra.com/charsets/cyrillic.html)
 107     wxFONTENCODING_KOI8,            // we don't support any of KOI8 variants
 108     wxFONTENCODING_ALTERNATIVE,     // same as MS-DOS CP866
 109     wxFONTENCODING_BULGARIAN,       // used under Linux in Bulgaria
 110
 111     // what would we do without Microsoft? They have their own encodings
 112         // for DOS
 113     wxFONTENCODING_CP437,           // original MS-DOS codepage
 114     wxFONTENCODING_CP850,           // CP437 merged with Latin1
 115     wxFONTENCODING_CP852,           // CP437 merged with Latin2
 116     wxFONTENCODING_CP855,           // another cyrillic encoding
 117     wxFONTENCODING_CP866,           // and another one
 118         // and for Windows
 119     wxFONTENCODING_CP874,           // WinThai
 120     wxFONTENCODING_CP1250,          // WinLatin2
 121     wxFONTENCODING_CP1251,          // WinCyrillic
 122     wxFONTENCODING_CP1252,          // WinLatin1
 123     wxFONTENCODING_CP1253,          // WinGreek (8859-7)
 124     wxFONTENCODING_CP1254,          // WinTurkish
 125     wxFONTENCODING_CP1255,          // WinHebrew
 126     wxFONTENCODING_CP1256,          // WinArabic
 127     wxFONTENCODING_CP1257,          // WinBaltic (same as Latin 7)
 128     wxFONTENCODING_CP12_MAX,
 129
 130     wxFONTENCODING_UTF7,            // UTF-7 Unicode encoding
 131     wxFONTENCODING_UTF8,            // UTF-8 Unicode encoding
 132
 133     wxFONTENCODING_UNICODE,         // Unicode - currently used only by
 134                                     // wxEncodingConverter class
 135
 136     wxFONTENCODING_MAX
 137 };
 138 \end{verbatim}
 139
 140 \wxheading{Predefined objects}
 141
 142 Objects:
 143
 144 {\bf wxNullFont}
 145
 146 Pointers:
 147
 148 {\bf wxNORMAL\_FONT\\
 149 wxSMALL\_FONT\\
 150 wxITALIC\_FONT\\
 151 wxSWISS\_FONT}
 152
 153 \wxheading{See also}
 154
 155 \helpref{wxFont overview}{wxfontoverview}, \helpref{wxDC::SetFont}{wxdcsetfont},\rtfsp
 156 \helpref{wxDC::DrawText}{wxdcdrawtext}, \helpref{wxDC::GetTextExtent}{wxdcgettextextent},\rtfsp
 157 \helpref{wxFontDialog}{wxfontdialog}, \helpref{wxSystemSettings}{wxsystemsettings}
 158
 159 \latexignore{\rtfignore{\wxheading{Members}}}
 160
 161
 162 \membersection{wxFont::wxFont}\label{wxfontctor}
 163
 164 \func{}{wxFont}{\void}
 165
 166 Default constructor.
 167
 168 \func{}{wxFont}{\param{int}{ pointSize}, \param{wxFontFamily}{ family}, \param{int}{ style}, \param{wxFontWeight}{ weight},
 169  \param{const bool}{ underline = false}, \param{const wxString\& }{faceName = ""},
 170  \param{wxFontEncoding }{encoding = wxFONTENCODING\_DEFAULT}}
 171
 172 \func{}{wxFont}{\param{const wxSize\&}{ pixelSize}, \param{wxFontFamily}{ family}, \param{int}{ style}, \param{wxFontWeight}{ weight},
 173  \param{const bool}{ underline = false}, \param{const wxString\& }{faceName = ""},
 174  \param{wxFontEncoding }{encoding = wxFONTENCODING\_DEFAULT}}
 175
 176 Creates a font object with the specified attributes.
 177
 178 \wxheading{Parameters}
 179
 180 \docparam{pointSize}{Size in points.}
 181
 182 \docparam{pixelSize}{Size in pixels: this is directly supported only under MSW
 183 currently where this constructor can be used directly, under other platforms a
 184 font with the closest size to the given one is found using binary search and
 185 the static \helpref{New}{wxfontnew} method must be used.}
 186
 187 \docparam{family}{Font family, a generic way of referring to fonts without specifying actual facename. One of:
 188
 189 \twocolwidtha{5cm}
 190 \begin{twocollist}\itemsep=0pt
 191 \twocolitem{{\bf wxFONTFAMILY\_DEFAULT}}{Chooses a default font.}
 192 \twocolitem{{\bf wxFONTFAMILY\_DECORATIVE}}{A decorative font.}
 193 \twocolitem{{\bf wxFONTFAMILY\_ROMAN}}{A formal, serif font.}
 194 \twocolitem{{\bf wxFONTFAMILY\_SCRIPT}}{A handwriting font.}
 195 \twocolitem{{\bf wxFONTFAMILY\_SWISS}}{A sans-serif font.}
 196 \twocolitem{{\bf wxFONTFAMILY\_MODERN}}{A fixed pitch font.}
 197 \twocolitem{{\bf wxFONTFAMILY\_TELETYPE}}{A teletype font.}
 198 \end{twocollist}}
 199
 200 \docparam{style}{One of {\bf wxFONTSTYLE\_NORMAL}, {\bf wxFONTSTYLE\_SLANT} and {\bf wxFONTSTYLE\_ITALIC}.}
 201
 202 \docparam{weight}{Font weight, sometimes also referred to as font boldness. One of:
 203
 204 \twocolwidtha{5cm}
 205 \begin{twocollist}\itemsep=0pt
 206 \twocolitem{{\bf wxFONTWEIGHT\_NORMAL}}{Normal font.}
 207 \twocolitem{{\bf wxFONTWEIGHT\_LIGHT}}{Light font.}
 208 \twocolitem{{\bf wxFONTWEIGHT\_BOLD}}{Bold font.}
 209 \end{twocollist}}
 210
 211 \docparam{underline}{The value can be true or false. At present this has an effect on Windows and Motif 2.x only.}
 212
 213 \docparam{faceName}{An optional string specifying the actual typeface to be used. If it is an empty string,
 214 a default typeface will be chosen based on the family.}
 215
 216 \docparam{encoding}{An encoding which may be one of
 217 \twocolwidtha{5cm}
 218 \begin{twocollist}\itemsep=0pt
 219 \twocolitem{{\bf wxFONTENCODING\_SYSTEM}}{Default system encoding.}
 220 \twocolitem{{\bf wxFONTENCODING\_DEFAULT}}{Default application encoding: this
 221 is the encoding set by calls to
 222 \helpref{SetDefaultEncoding}{wxfontsetdefaultencoding} and which may be set to,
 223 say, KOI8 to create all fonts by default with KOI8 encoding. Initially, the
 224 default application encoding is the same as default system encoding.}
 225 \twocolitem{{\bf wxFONTENCODING\_ISO8859\_1...15}}{ISO8859 encodings.}
 226 \twocolitem{{\bf wxFONTENCODING\_KOI8}}{The standard Russian encoding for Internet.}
 227 \twocolitem{{\bf wxFONTENCODING\_CP1250...1252}}{Windows encodings similar to ISO8859 (but not identical).}
 228 \end{twocollist}
 229 If the specified encoding isn't available, no font is created
 230 (see also \helpref{font encoding overview}{wxfontencodingoverview}).
 231 }
 232
 233 \wxheading{Remarks}
 234
 235 If the desired font does not exist, the closest match will be chosen.
 236 Under Windows, only scalable TrueType fonts are used.
 237
 238 See also \helpref{wxDC::SetFont}{wxdcsetfont}, \helpref{wxDC::DrawText}{wxdcdrawtext}
 239 and \helpref{wxDC::GetTextExtent}{wxdcgettextextent}.
 240
 241
 242 \membersection{wxFont::\destruct{wxFont}}\label{wxfontdtor}
 243
 244 \func{}{\destruct{wxFont}}{\void}
 245
 246 Destructor.
 247
 248 \wxheading{Remarks}
 249
 250 The destructor may not delete the underlying font object of the native windowing
 251 system, since wxFont uses a reference counting system for efficiency.
 252
 253 Although all remaining fonts are deleted when the application exits,
 254 the application should try to clean up all fonts itself. This is because
 255 wxWidgets cannot know if a pointer to the font object is stored in an
 256 application data structure, and there is a risk of double deletion.
 257
 258
 259 \membersection{wxFont::IsFixedWidth}\label{wxfontisfixedwidth}
 260
 261 \constfunc{bool}{IsFixedWidth}{\void}
 262
 263 Returns {\tt true} if the font is a fixed width (or monospaced) font,
 264 {\tt false} if it is a proportional one or font is invalid.
 265
 266
 267 \membersection{wxFont::GetDefaultEncoding}\label{wxfontgetdefaultencoding}
 268
 269 \func{static wxFontEncoding}{GetDefaultEncoding}{\void}
 270
 271 Returns the current application's default encoding.
 272
 273 \wxheading{See also}
 274
 275 \helpref{Font encoding overview}{wxfontencodingoverview},
 276 \helpref{SetDefaultEncoding}{wxfontsetdefaultencoding}
 277
 278
 279 \membersection{wxFont::GetFaceName}\label{wxfontgetfacename}
 280
 281 \constfunc{wxString}{GetFaceName}{\void}
 282
 283 Returns the typeface name associated with the font, or the empty string if there is no
 284 typeface information.
 285
 286 \wxheading{See also}
 287
 288 \helpref{wxFont::SetFaceName}{wxfontsetfacename}
 289
 290
 291 \membersection{wxFont::GetFamily}\label{wxfontgetfamily}
 292
 293 \constfunc{wxFontFamily}{GetFamily}{\void}
 294
 295 Gets the font family. See \helpref{wxFont::SetFamily}{wxfontsetfamily} for a list of valid
 296 family identifiers.
 297
 298 \wxheading{See also}
 299
 300 \helpref{wxFont::SetFamily}{wxfontsetfamily}
 301
 302
 303 \membersection{wxFont::GetNativeFontInfoDesc}\label{wxfontgetnativefontinfodesc}
 304
 305 \constfunc{wxString}{GetNativeFontInfoDesc}{\void}
 306
 307 Returns the platform-dependent string completely describing this font or an
 308 empty string if the font wasn't constructed using the native font description.
 309 Note that the returned string is not meant to be shown or edited by the user: a typical
 310 use of this function is for serializing in string-form a wxFont object.
 311
 312 \wxheading{See also}
 313
 314 \helpref{wxFont::SetNativeFontInfo}{wxfontsetnativefontinfo},\helpref{wxFont::GetNativeFontInfoUserDesc}{wxfontgetnativefontinfouserdesc}
 315
 316
 317 \membersection{wxFont::GetNativeFontInfoUserDesc}\label{wxfontgetnativefontinfouserdesc}
 318
 319 \func{wxString}{GetNativeFontInfoUserDesc}{\void}
 320
 321 Returns a user-friendly string for this font object. Some examples of the formats of returned strings (which are platform-dependent) are in \helpref{SetNativeFontInfoUserDesc}{wxfontsetnativefontinfouserdesc}.
 322
 323 \wxheading{See also}
 324
 325 \helpref{wxFont::GetNativeFontInfoDesc}{wxfontgetnativefontinfodesc}
 326
 327
 328 \membersection{wxFont::GetPointSize}\label{wxfontgetpointsize}
 329
 330 \constfunc{int}{GetPointSize}{\void}
 331
 332 Gets the point size.
 333
 334 \wxheading{See also}
 335
 336 \helpref{wxFont::SetPointSize}{wxfontsetpointsize}
 337
 338
 339 \membersection{wxFont::GetStyle}\label{wxfontgetstyle}
 340
 341 \constfunc{int}{GetStyle}{\void}
 342
 343 Gets the font style. See \helpref{wxFont::wxFont}{wxfontctor} for a list of valid
 344 styles.
 345
 346 \wxheading{See also}
 347
 348 \helpref{wxFont::SetStyle}{wxfontsetstyle}
 349
 350
 351 \membersection{wxFont::GetUnderlined}\label{wxfontgetunderlined}
 352
 353 \constfunc{bool}{GetUnderlined}{\void}
 354
 355 Returns true if the font is underlined, false otherwise.
 356
 357 \wxheading{See also}
 358
 359 \helpref{wxFont::SetUnderlined}{wxfontsetunderlined}
 360
 361
 362 \membersection{wxFont::GetWeight}\label{wxfontgetweight}
 363
 364 \constfunc{wxFontWeight}{GetWeight}{\void}
 365
 366 Gets the font weight. See \helpref{wxFont::wxFont}{wxfontctor} for a list of valid
 367 weight identifiers.
 368
 369 \wxheading{See also}
 370
 371 \helpref{wxFont::SetWeight}{wxfontsetweight}
 372
 373
 374 \membersection{wxFont::New}\label{wxfontnew}
 375
 376 \func{static wxFont *}{New}{\param{int}{ pointSize}, \param{wxFontFamily}{ family}, \param{int}{ style}, \param{wxFontWeight}{ weight},
 377  \param{const bool}{ underline = false}, \param{const wxString\& }{faceName = ""},
 378  \param{wxFontEncoding }{encoding = wxFONTENCODING\_DEFAULT}}
 379
 380 \func{static wxFont *}{New}{\param{int}{ pointSize}, \param{wxFontFamily}{ family},
 381  \param{int}{ flags = \texttt{wxFONTFLAG\_DEFAULT}}, \param{const wxString\& }{faceName = ""},
 382  \param{wxFontEncoding }{encoding = wxFONTENCODING\_DEFAULT}}
 383
 384 \func{static wxFont *}{New}{\param{const wxSize\&}{ pixelSize}, \param{wxFontFamily}{ family}, \param{int}{ style}, \param{wxFontWeight}{ weight},
 385  \param{const bool}{ underline = false}, \param{const wxString\& }{faceName = ""},
 386  \param{wxFontEncoding }{encoding = wxFONTENCODING\_DEFAULT}}
 387
 388 \func{static wxFont *}{New}{\param{const wxSize\&}{ pixelSize}, \param{wxFontFamily}{ family},
 389  \param{int}{ flags = \texttt{wxFONTFLAG\_DEFAULT}}, \param{const wxString\& }{faceName = ""},
 390  \param{wxFontEncoding }{encoding = wxFONTENCODING\_DEFAULT}}
 391
 392 These functions take the same parameters as \helpref{wxFont
 393 constructor}{wxfontctor} and return a new font object allocated on the heap.
 394
 395 Using \texttt{New()} is currently the only way to directly create a font with
 396 the given size in pixels on platforms other than wxMSW.
 397
 398
 399 \membersection{wxFont::Ok}\label{wxfontok}
 400
 401 \constfunc{bool}{Ok}{\void}
 402
 403 Returns {\tt true} if this object is a valid font, {\tt false} otherwise.
 404
 405
 406 \membersection{wxFont::SetDefaultEncoding}\label{wxfontsetdefaultencoding}
 407
 408 \func{static void}{SetDefaultEncoding}{\param{wxFontEncoding }{encoding}}
 409
 410 Sets the default font encoding.
 411
 412 \wxheading{See also}
 413
 414 \helpref{Font encoding overview}{wxfontencodingoverview},
 415 \helpref{GetDefaultEncoding}{wxfontgetdefaultencoding}
 416
 417
 418 \membersection{wxFont::SetFaceName}\label{wxfontsetfacename}
 419
 420 \func{void}{SetFaceName}{\param{const wxString\& }{faceName}}
 421
 422 Sets the facename for the font.
 423
 424 \wxheading{Parameters}
 425
 426 \docparam{faceName}{A valid facename, which should be on the end-user's system.}
 427
 428 \wxheading{Remarks}
 429
 430 To avoid portability problems, don't rely on a specific face, but specify the font family
 431 instead or as well. A suitable font will be found on the end-user's system. If both the
 432 family and the facename are specified, wxWidgets will first search for the specific face,
 433 and then for a font belonging to the same family.
 434
 435 \wxheading{See also}
 436
 437 \helpref{wxFont::GetFaceName}{wxfontgetfacename}, \helpref{wxFont::SetFamily}{wxfontsetfamily}
 438
 439
 440 \membersection{wxFont::SetFamily}\label{wxfontsetfamily}
 441
 442 \func{void}{SetFamily}{\param{wxFontFamily}{ family}}
 443
 444 Sets the font family.
 445
 446 \wxheading{Parameters}
 447
 448 \docparam{family}{One of:
 449
 450 \twocolwidtha{5cm}
 451 \begin{twocollist}\itemsep=0pt
 452 \twocolitem{{\bf wxFONTFAMILY\_DEFAULT}}{Chooses a default font.}
 453 \twocolitem{{\bf wxFONTFAMILY\_DECORATIVE}}{A decorative font.}
 454 \twocolitem{{\bf wxFONTFAMILY\_ROMAN}}{A formal, serif font.}
 455 \twocolitem{{\bf wxFONTFAMILY\_SCRIPT}}{A handwriting font.}
 456 \twocolitem{{\bf wxFONTFAMILY\_SWISS}}{A sans-serif font.}
 457 \twocolitem{{\bf wxFONTFAMILY\_MODERN}}{A fixed pitch font.}
 458 \twocolitem{{\bf wxFONTFAMILY\_TELETYPE}}{A teletype font.}
 459 \end{twocollist}}
 460
 461 \wxheading{See also}
 462
 463 \helpref{wxFont::GetFamily}{wxfontgetfamily}, \helpref{wxFont::SetFaceName}{wxfontsetfacename}
 464
 465
 466 \membersection{wxFont::SetNativeFontInfo}\label{wxfontsetnativefontinfo}
 467
 468 \func{void}{SetNativeFontInfo}{\param{const wxString\& }{info}}
 469
 470 Creates the font corresponding to the given native font description string
 471 which must have been previously returned by
 472 \helpref{GetNativeFontInfoDesc}{wxfontgetnativefontinfodesc}. If the string is
 473 invalid, font is unchanged. This function is typically used for de-serializing a wxFont
 474 object previously saved in a string-form.
 475
 476 \wxheading{See also}
 477
 478 \helpref{wxFont::SetNativeFontInfoUserDesc}{wxfontsetnativefontinfouserdesc}
 479
 480
 481 \membersection{wxFont::SetNativeFontInfoUserDesc}\label{wxfontsetnativefontinfouserdesc}
 482
 483 \func{void}{SetNativeFontInfoUserDesc}{\param{const wxString\& }{info}}
 484
 485 Creates the font corresponding to the given native font description string.
 486 Unlike \helpref{SetNativeFontInfo}{wxfontsetnativefontinfo}, this function accepts
 487 strings which are user-friendly.
 488 Examples of accepted string formats are:
 489
 490 \twocolwidtha{15cm}
 491 \begin{twocollist}\itemsep=0pt
 492 \twocolitem{Generic syntax}{Example}
 493 \twocolitem{on {\bf wxGTK2}: {\tt $[FACE-NAME]$ $[bold]$ $[oblique|italic]$ $[POINTSIZE]$}}{Monospace bold 10}
 494 \twocolitem{on {\bf wxMSW}: {\tt $[light|bold]$ $[italic]$ $[FACE-NAME]$ $[POINTSIZE]$ $[ENCODING]$}}{Tahoma 10 WINDOWS-1252}
 495 \twocolitem{on {\bf wxMac}: FIXME}{FIXME}
 496 \end{twocollist}
 497
 498 For more detailed information about the allowed syntaxes you can look at the documentation of the native API used for font-rendering (e.g. \urlref{pango\_font\_description\_from\_string}{http://developer.gnome.org/doc/API/2.0/pango/pango-Fonts.html\#pango-font-description-from-string}).
 499
 500 \wxheading{See also}
 501
 502 \helpref{wxFont::SetNativeFontInfo}{wxfontsetnativefontinfo}
 503
 504
 505
 506 \membersection{wxFont::SetPointSize}\label{wxfontsetpointsize}
 507
 508 \func{void}{SetPointSize}{\param{int}{ pointSize}}
 509
 510 Sets the point size.
 511
 512 \wxheading{Parameters}
 513
 514 \docparam{pointSize}{Size in points.}
 515
 516 \wxheading{See also}
 517
 518 \helpref{wxFont::GetPointSize}{wxfontgetpointsize}
 519
 520
 521 \membersection{wxFont::SetStyle}\label{wxfontsetstyle}
 522
 523 \func{void}{SetStyle}{\param{int}{ style}}
 524
 525 Sets the font style.
 526
 527 \wxheading{Parameters}
 528
 529 \docparam{style}{One of {\bf wxFONTSTYLE\_NORMAL}, {\bf wxFONTSTYLE\_SLANT} and {\bf wxFONTSTYLE\_ITALIC}.}
 530
 531 \wxheading{See also}
 532
 533 \helpref{wxFont::GetStyle}{wxfontgetstyle}
 534
 535
 536 \membersection{wxFont::SetUnderlined}\label{wxfontsetunderlined}
 537
 538 \func{void}{SetUnderlined}{\param{const bool}{ underlined}}
 539
 540 Sets underlining.
 541
 542 \wxheading{Parameters}
 543
 544 \docparam{underlining}{true to underline, false otherwise.}
 545
 546 \wxheading{See also}
 547
 548 \helpref{wxFont::GetUnderlined}{wxfontgetunderlined}
 549
 550
 551 \membersection{wxFont::SetWeight}\label{wxfontsetweight}
 552
 553 \func{void}{SetWeight}{\param{wxFontWeight}{ weight}}
 554
 555 Sets the font weight.
 556
 557 \wxheading{Parameters}
 558
 559 \docparam{weight}{One of:
 560
 561 \twocolwidtha{5cm}
 562 \begin{twocollist}\itemsep=0pt
 563 \twocolitem{{\bf wxFONTWEIGHT\_NORMAL}}{Normal font.}
 564 \twocolitem{{\bf wxFONTWEIGHT\_LIGHT}}{Light font.}
 565 \twocolitem{{\bf wxFONTWEIGHT\_BOLD}}{Bold font.}
 566 \end{twocollist}}
 567
 568 \wxheading{See also}
 569
 570 \helpref{wxFont::GetWeight}{wxfontgetweight}
 571
 572
 573 \membersection{wxFont::operator $=$}\label{wxfontassignment}
 574
 575 \func{wxFont\&}{operator $=$}{\param{const wxFont\& }{font}}
 576
 577 Assignment operator, using reference counting. Returns a reference
 578 to `this'.
 579
 580
 581 \membersection{wxFont::operator $==$}\label{wxfontequals}
 582
 583 \func{bool}{operator $==$}{\param{const wxFont\& }{font}}
 584
 585 Equality operator. Two fonts are equal if they contain pointers
 586 to the same underlying font data. It does not compare each attribute,
 587 so two independently-created fonts using the same parameters will
 588 fail the test.
 589
 590
 591 \membersection{wxFont::operator $!=$}\label{wxfontnotequals}
 592
 593 \func{bool}{operator $!=$}{\param{const wxFont\& }{font}}
 594
 595 Inequality operator. Two fonts are not equal if they contain pointers
 596 to different underlying font data. It does not compare each attribute.
 597