NoLineBreaksAfterKinsoku Class

Custom Set of Characters Which Cannot End a Line.When the object is serialized out as xml, its qualified name is w:noLineBreaksAfter.

Inheritance Hierarchy

System.Object
  DocumentFormat.OpenXml.OpenXmlElement
    DocumentFormat.OpenXml.OpenXmlLeafElement
      DocumentFormat.OpenXml.Wordprocessing.NoLineBreaksAfterKinsoku

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

Syntax

'Declaration
Public Class NoLineBreaksAfterKinsoku _
    Inherits OpenXmlLeafElement
'Usage
Dim instance As NoLineBreaksAfterKinsoku
public class NoLineBreaksAfterKinsoku : OpenXmlLeafElement

Remarks

[ISO/IEC 29500-1 1st Edition]

17.15.1.58 noLineBreaksAfter (Custom Set of Characters Which Cannot End a Line)

This element specifies the set of characters which shall be restricted from ending a line for runs of text which shall be subject to custom line breaking logic using the kinsoku element (§17.3.1.16) when the contents of the document are displayed. This constraint shall only apply to text which has been flagged in the language of this rule via the lang element (§17.3.2.20) or automatic detection methods outside the scope of ISO/IEC 29500.

If this element is omitted, then no custom set of characters shall be used to restrict the characters which can end a line when using the kinsoku element.

[Example: Consider a paragraph of WordprocessingML text displayed as follows, with the dollar symbol $ was flagged as Japanese content using the following WordprocessingML in the run properties:

<w:r>
<w:rPr>
<w:lang w:eastAsia="ja-JP" />
</w:rPr>
<w:t>$</w:t>
</w:r>

DocumentFormat.OpenXml.Wordprocessing.NoLineBreaks

This text is displayed and the resulting first line ends with the dollar sign symbol. If this character must not be used to end a line, that requirement would be specified as follows in the document settings:

  <w:noLineBreaksAfter w:lang="ja-JP" w:val="$" />

The noLineBreaksAfter element's val attribute has a value of ja-JP, specifying that all dollar signs in this document which are marked as Japanese text must not be allowed to end a line. This means that the dollar sign character must therefore be moved to the next line as it can no longer be the last character on a line:

DocumentFormat.OpenXml.Wordprocessing.NoLineBreaks

end example]

Parent Elements

settings (§17.15.1.78)

Attributes

Description

lang (Language For Which Custom Line Breaking Rule Applies)

Specifies the language of text for which the parent custom line breaking rule shall be applied. Applications supporting this functionality shall support custom line breaking for the following four languages:

  • Chinese (Traditional)

  • Chinese (Simplified)

  • Japanese

  • Korean

Applications can also support custom line breaking rules for other languages, but this is not required.

[Example: Consider a WordprocessingML document which must have a custom line breaking rule for Japanese. That requirement would be specified as follows in the document settings:

<… w:lang="ja-JP" w:val="$" />

The lang attribute has a value of ja-JP, specifying that the rules must be applied to Japanese text. end example]

The possible values for this attribute are defined by the ST_Lang simple type (§22.9.2.6).

val (Characters For Custom Line Breaking Rule)

Specifies the set of characters which shall be included in the custom line breaking rule.

[Example: Consider a WordprocessingML document which must have a custom line breaking rule for Japanese. That requirement would be specified as follows in the document settings:

<… w:lang="ja-JP" w:val="$" />

The val attribute has a value of $, specifying that the dollar sign character is the only restricted character for Japanese text. end example]

The possible values for this attribute are defined by the ST_String simple type (§22.9.2.13).

[Note: The W3C XML Schema definition of this element’s content model (CT_Kinsoku) is located in §A.1. end note]

© 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

NoLineBreaksAfterKinsoku Members

DocumentFormat.OpenXml.Wordprocessing Namespace