Applies automatic adjustments to letter spacing and line height for every font size, the ability to specify text style semantically such as Body, Footnote, etc. and text that responds appropriately when user change their preferred text size settings.
| ||Empty value (default).|
|Body ||Used for general text.|
|Caption1 ||Used for standard titles.|
|Caption2 ||Used for alternative titles.|
|Footnote ||Used for notes.|
|Headline ||Used for heading texts.|
|Subheadline ||Used for subtitles.|
Generators: Android, Apple
Level: Theme Class
The main scenario for this feature is a simple way to have readable text.
To allow this the OS:
- Makes automatic adjustments to letter spacing and line height for every font size.
- Has the ability to specify text style semantically such as Body, Footnote, etc.
To handle this in GeneXus, the Font Category property was implemented within the properties group 'Font' of the classes in the Themes for Smart Devices.
This property gives the fonts semantics regarding the intent with which it will be used and then, on this basis, to calculate the default values of the existing properties (Font Weight, Font Size, etc) and set the font properties that are not configurable from GeneXus (letter spacing or line height for example), or the properties configurable at runtime by the user of the device (Text Size).
For example, when Font Category property uses one of this values and:
- Font Size property is empty or 0dip, then it will take the value corresponding to the selected category and the size that the user has configured on his device. Note that 0dip may be useful to override an inherited value of another parent class.
- Font Weight and Font Style properties are empty, Normal/Bold and Normal/Italic will be used respectively for Font Weight and Font Style based on the selected category.
- As of GeneXus 15 Upgrade 7 when Font Size property is set and the font family is a custom font, an application running on iOS 11 or higher will take its value as a base according to user font size preference (instead of predefined font size). For example, if Font Size property = 20, every option of Font Category property will be adjusted from that value (i.e. 20).
For iOS applications, it is recommended to keep Font Size property as empty for built-in fonts (managed by the OS) and specify a base font size for custom fonts.
Font Category property is available as from
This property applies only at design-time.
To apply the corresponding changes when the property value is configured, Run the main object.