DoNotUseEastAsianBreakRules class

Office 2013 and later

Do Not Compress Compressible Characters When Using Document Grid. When the object is serialized out as xml, its qualified name is w:doNotUseEastAsianBreakRules.

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

public class DoNotUseEastAsianBreakRules : OnOffType

[ISO/IEC 29500-1 1st Edition]

doNotUseEastAsianBreakRules (Do Not Compress Compressible Characters When Using Document Grid)

This element specifies whether applications should compress characters with identical compression rules when the document grid has been defined using the docGrid element (Part 1, §17.6.5). Compression rules refer to the additional bearing on the left and/or right side of a typical character, which can be compressed as needed without modifying the actual width of the character (its breadth).

Typically, punctuation characters with an identical set of compression rules are compressed when the contents of a document are displayed. This element, when present with a val attribute value of true (or equivalent), specifies that if a document grid is defined for the current section, compression shall never be performed on any character - all compressible characters shall be individually snapped to the document grid.

[Example: Consider a WordprocessingML document with a document grid set to allow 10 characters per line:

<w:sectPr>
  <w:docGrid w:type="snapTOCars" w:charSpace="146636" … />
</w:sectPr>

The default presentation would allow characters with identical compression rules to compress and utilize a single slot on the document grid (notice that the four parenthesis on the first line are combined since they can be compressed identically, while the two parenthesis with different compression on line two are not):

However, if this compatibility setting is turned on:

<w:compat>
  <w:doNotUseEastAsianBreakRules />
</w:compat>

Then no character with compression is compressed and instead are snapped to the grid individually, resulting in the following output:

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.
Show: