fontName

Type: String[31]

Availability: Read or write at any time

The fontName property of the Control class contains the font used to display text in a control.

The fontName property is defined for all controls, but it does not have any meaning in some cases. For example, a ScrollBar control has no text, and therefore the font is not relevant.

The font of a control defaults to the application font if the fontName property of the control is set to Default when printing the form. At run time, the fontName property returns an empty string if the control is using the default application font. Use app.fontName to obtain the actual font name.

For the Table class, the accessMode, accessedSheet, accessedRow, accessedColumn, or accessedCell property determines whether the fontName property for the current sheet, cell, column, or row is being accessed. Changing the sheet font causes the default table row height to be changed. Changing the font for a cell or row causes the current row height to change, unless the rowHeight property has been set for the row. Changing the font for a column causes all rows not having the rowHeight property set to have at least the font height size.

For the JadeTextEdit control, the clearAllStyles method copies the value of this property to the default text style; that is, STYLE_DEFAULT (32).

The default value for the fontName property is determined by the system. Fonts that are available with JADE vary, according to your system configuration, display devices, and printing devices.

Changing the fontName property to an empty string causes the control to use the default font. The fontBold and fontSize properties revert to the font of the application.

If a control is using the default font for the application (that is, this property contains the "" null value), changing any font property of the control causes the control to use a local font constructed by using the application font values with the changed font attribute.

Use the Control class setFontProperties method to change the fontName, fontBold, and fontSize properties at the same time.