DoNotWrapTextWithPunctuation Class

Do Not Allow Hanging Punctuation With Character Grid.When the object is serialized out as xml, its qualified name is w:doNotWrapTextWithPunct.

Inheritance Hierarchy

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

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

Syntax

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

Remarks

[ISO/IEC 29500-1 1st Edition]

9.7.3.19 doNotWrapTextWithPunct (Do Not Allow Hanging Punctuation With Character Grid)

This element specifies whether applications shall allowing hanging punctuation when:

  • The overflowPunct element (Part 1, §17.3.1.21) is turned on for a paragraph

  • A document grid is defined using the docGrid element (Part 1, §17.6.5) which defines the number of characters per line

Typically, paragraphs which allow hanging punctuation shall allow the number of characters on a line as specified by the document grid to be exceeded by one in order to allow for hanging punctuation. This element, when present with a val attribute value of true (or equivalent), specifies that the document grid shall never be exceeded for hanging punctuation.

[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>

If the eleventh character on the line was a punctuation characters, the default presentation would allow that character to behave as hanging punctuation on the first line:

DocumentFormat.OpenXml.Wordprocessing.DoNotWrapTex

However, if this compatibility setting is turned on:

<w:compat>
<w:doNotwrapTextWithPunct />
</w:compat>

Then the character grid cannot be exceeded even for the hanging punctuation, resulting in the following output:

DocumentFormat.OpenXml.Wordprocessing.DoNotWrapTex

The hanging punctuation was disallowed, moving it (and the character before it, since that character cannot begin a line) to the following line. 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

DoNotWrapTextWithPunctuation Members

DocumentFormat.OpenXml.Wordprocessing Namespace