SubFontBySize Class

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

Inheritance Hierarchy

System.Object
  DocumentFormat.OpenXml.OpenXmlElement
    DocumentFormat.OpenXml.OpenXmlLeafElement
      DocumentFormat.OpenXml.Wordprocessing.OnOffType
        DocumentFormat.OpenXml.Wordprocessing.SubFontBySize

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

Syntax

'Declaration
Public Class SubFontBySize _
    Inherits OnOffType
'Usage
Dim instance As SubFontBySize

public class SubFontBySize : OnOffType

Remarks

[ISO/IEC 29500-1 1st Edition]

9.7.3.39 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]

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

© ISO/IEC29500: 2008.

Thread Safety

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

See Also

Reference

SubFontBySize Members

DocumentFormat.OpenXml.Wordprocessing Namespace