Home > Language Reference > Classes > Display

ScaleFont Property

Enable or disable font scaling.

Syntax

Public Property Get ScaleFont() As Boolean
Public Property Let ScaleFont(ByVal
bScale As Boolean)

ParameterDescription
bScaleIndicates whether fonts should be scaled or not.

Remarks

The ScaleFont property enables or disables font scaling. By default this property is set to True, indicating that the TextOut method uses scaled font to draw text. If you need to draw more, but smaller, text on a device that has high density display, you can set this property to False. This causes the blitter to render text using the low density family member of the specified font, even if that font family includes a font whose density matches the screen's one. The following screenshots illustrate this mechanism:

This property is only available on devices running Palm OS® 5.3 or higher, or on some devices having 240x320 screens. On other devices, it has no effect. You can check this feature is available by setting the value False to this property, and checking afterwards that the change was taken into account. For example:

Me.ScaleFont = False
If Me.ScaleFont = True Then
  ' Font scaling not available
Else
  ' Font scaling available
End If

Note: this property only applies to text drawn with the TextOut method. You cannot disable font scaling for controls or forms captions.

System requirements

SystemMinimal versionRemarks
Palm OSPalm OS 5.3Only effective on devices having a high density screen.