setFontProperties

setFontProperties(fontName:    String;
                  fontSize:    Real;
                  fontBold:    Boolean);

The setFontProperties method of the Control class sets the values of the Control class fontName, fontSize, and fontBold properties.

Use this method to set the value of the fontName, fontSize, and fontBold properties of the control in one action; that is, instead of defining the example shown in the following code fragment.

listBox1.fontName := "Arial";
listBox1.fontSize := 9;
listBox1.fontBold := true;

Using the setFontProperties method can be more efficient than setting the properties individually, because the three properties are all set in the same action. When each property is set individually in JADE logic, a new font is created each time, and any impacts that the changed font has on the control size are applied; for example, auto‑sizing, parentAspect positioning, or aligning controls. The setFontProperties method sets all three properties before applying any impacts.

For a Table control, the setFontProperties method uses the current setting of the accessMode property to determine whether the method will set the font for the current sheet, row, column, or cell.