Export (0) Print
Expand All

NoLineBreaksBeforeKinsoku class

Custom Set Of Characters Which Cannot Begin A Line. When the object is serialized out as xml, its qualified name is w:noLineBreaksBefore.

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

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

public class NoLineBreaksBeforeKinsoku : OpenXmlLeafElement

[ISO/IEC 29500-1 1st Edition]

noLineBreaksBefore (Custom Set Of Characters Which Cannot Begin A Line)

This element specifies the set of characters which shall be restricted from beginning a new 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 /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 Korean content using the following WordprocessingML in the run properties:

<w:r>
  <w:rPr>
    <w:lang w:eastAsia="ko-KR" />
  </w:rPr>
  <w:t>$</w:t>
</w:r>

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

  <w:noLineBreaksBefore w:lang="ko-KR" w:val="$" />

The noLineBreaksBefore element's val attribute has a value of ko-KR, specifying that all dollar signs in this document which are marked as Korean text must not be allowed to begin a line. This means that the previous word character must therefore be moved to the next line as the dollar sign can no longer be the first character on a line:

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.

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

Community Additions

Show:
© 2014 Microsoft