w:kern (Font Kerning)
Enables automatic pair kerning for the run at and above the specified minimum font size (in half-points).
Parent elements
Description
w:kern enables automatic pair kerning for the run, adjusting the spacing between specific character pairs (e.g. AV, WA) to improve visual balance. It is defined in ECMA-376 Part 1 §17.3.2.19.
The w:val attribute specifies the minimum font size (in half-points) above which kerning is applied. For example, w:val="24" enables kerning only when the effective font size is 12 pt or larger. Setting w:val="0" disables kerning regardless of size.
Attributes
| Attribute | Type | Possible Values | Description |
|---|---|---|---|
w:val |
ST_HpsMeasure |
Non-negative integer in half-points (e.g. 24 = 12 pt). 0 disables kerning. |
Minimum font size at which automatic kerning is enabled. |
Examples
<!-- Enable kerning for runs at 12pt or larger -->
<w:rPr>
<w:kern w:val="24"/>
</w:rPr>new RunProperties(
new Kern { Val = 24U });Notes
- The value is in half-points (1 half-point = 0.5 pt), so 12 pt =
24. - Kerning is cosmetic only and has no effect on the stored text or layout flow beyond glyph pair spacing.