DoNotUseEastAsianBreakRules Class

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

Inheritance Hierarchy

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

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

Syntax

'Declaration
Public Class DoNotUseEastAsianBreakRules _
    Inherits OnOffType
'Usage
Dim instance As DoNotUseEastAsianBreakRules
public class DoNotUseEastAsianBreakRules : OnOffType

Remarks

[ISO/IEC 29500-1 1st Edition]

9.7.3.14 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):

DocumentFormat.OpenXml.Wordprocessing.DoNotUseEast

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:

DocumentFormat.OpenXml.Wordprocessing.DoNotUseEast

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.

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

DoNotUseEastAsianBreakRules Members

DocumentFormat.OpenXml.Wordprocessing Namespace