| Parents | Children | Properties | Methods | Events |
| Purpose: | Loads a font resource |
Description
This object loads a Windows font into memory ready for use by another object. The characteristics of the font are specified by its properties as follows :
| PName | A character vector containing the name of the font face. The default is 'System'. Note that case is ignored when you specify the name, although it will be returned correctly by ⎕WG. |
| Size | An integer that specifies the character height of the font in pixels. |
| Fixed | A Boolean value that specifies whether the font is fixed-width (1) or proportional (0). |
| Italic | A Boolean value that specifies whether the font is italicised (1) or not (0). |
| Underline | A Boolean value that specifies whether the font is underlined (1) or not (0). |
| Weight | An integer in the range 0-1000 that specifies how bold or heavy the font is (1000 = most bold). |
| Rotate | A numeric scalar that specifies the angle of rotation of the font in radians. The angle is measure from the x-axis in a counter-clockwise direction. |
| CharSet | An integer that specifies the character encoding. |
The Coord property may be set to 'Pixel', 'ScaledPixel' or 'RealPixel' when the object is created, but Coord may not subsequently be changed.
If Coord is 'Pixel', it is interpreted as either 'RealPixel' or 'ScaledPixel' according to the value of the DYALOG_PIXEL_TYPE parameter, which is either ScaledPixel or RealPixel. See DYALOG_PIXEL_TYPE.
If this parameter is not specified, the default is RealPixel. So by default, when you set Coord to Pixel, it will be treated as RealPixel.
If you are using 'ScaledPixel', this means that your fonts will also be scaled up automatically, as well as the sizes of the controls in which they are used.
When you ask Windows to allocate a font, you may specify as many or as few of these properties as you wish. Windows actually supplies the font that most closely matches the attributes you have specified. The matching rules it uses are complex, and may be found in the appropriate Windows documentation.
The values of the above properties after ⎕WC or ⎕WS reflect the attributes of the font which has been allocated by Windows, and not necessarily the values you have specified. Furthermore, it is possible that changing the value of one property will cause the values of others to be changed.