Export (0) Print
Expand All

SubFontBySize class

Increase Priority Of Font Size During Font Substitution. When the object is serialized out as xml, its qualified name is w:subFontBySize.

Namespace:  DocumentFormat.OpenXml.Wordprocessing
Assembly:  DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)

public class SubFontBySize : OnOffType

[ISO/IEC 29500-1 1st Edition]

subFontBySize (Require Exact Size During Font Substitution)

This element specifies whether applications shall accept fonts which cannot be rendered at the size specified by the sz (Part 1, §17.3.2.38) and/or szCs (Part 1, §17.3.2.39) elements on the parent run when performing font substitution.

Typically, applications can perform font substitution as defined in Part 1, §17.8.2, with no additional restrictions. This element, when present with a val attribute value of true (or equivalent), specifies that when a potential substitute font has been located, an application shall check whether that font is capable of displaying characters at the specified point size. If it is not, that font is not considered as a substitute font (i.e. it is rejected, and the next closest match is considered).

[Example: Consider a WordprocessingML document with a series of characters in an unavailable font. The default presentation would use any method used by the application to perform that font substitution.

However, if this compatibility setting is turned on:

<w:compat>
  <w:subFontBySize />
</w:compat>

For each run, the application determines if the substitute font produced by its font substitution algorithm can be displayed at the size specified by the run’s sz and/or szCs elements. If it cannot, that font is not used and the next closest match as substitute font is considered. end example]

Parent Elements

compat (Part 1, §17.15.1.21)

This element’s content model is defined by the common boolean property definition in Part 1, §17.17.4.

© ISO/IEC29500: 2008.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Community Additions

Show:
© 2014 Microsoft