17.18.3 ST_BrClear

This simple type specifies the set of possible restart locations which can be used as to determine the next available line when a break’s type attribute has a value of textWrapping. This property only affects the restart location when the current run is being displayed on a line which does not span the full text extents due to the presence of a floating object (see enumeration values for details).

[Example: Consider a text wrapping break character which should force the restart location to the next line which spans the full width of the text extents of the page (there are no floating objects which interrupt the line).

This line break is of style textWrapping, since it must only advance to the next line, but the clear value must specify that this restart location must ignore all lines which are not of the full line width by specifying a value of all, as follows:

<w:br w:type="textWrapping" w:clear="all" />

This break must therefore not use the next available line, but rather the next available line ignoring all lines which do not span the full text width. end example]

This simple type’s contents are a restriction of the W3C XML Schema string datatype.

This simple type is restricted to the values

listed in the following table:

Enumeration Value

Description

Specifies that the text wrapping break shall advance the text to the next line in the WordprocessingML document which spans the full width of the line (i.e. the next line which is not interrupted by any floating

Enumeration Value

Description

objects when those objects are positioned on the page at display time.

[Note: This setting is typically used to place a single line of text next to a floating object for use as a caption. end note]

Specifies that the text wrapping break shall behave as follows when this line intersects a floating object:

If the parent paragraph is left-to-right: - If this is the leftmost region of text flow currently on this line, - If a floating object occurs to the left of the break, advance the text to the next available line that does not have a floating object on the left. - Otherwise, advance the text to the next position on the line where text can be displayed - Otherwise, treat this as a text wrapping break of type none.

If the parent paragraph is right to left: If the object occurs to the left of the break, advance the text to the next available line that does not have a floating object on the left. - Otherwise, treat this as a text wrapping break of type none.

In either case, if this line does not intersect a floating object, then treat this break as a text wrapping break of type none.

Specifies that the text wrapping break shall advance the text to the next line in the WordprocessingML document, regardless of its position left to right or the presence of any floating objects which intersect with the line,

This is the setting for a typical line break in a document.

Specifies that the text wrapping break shall behave as follows when this line intersects a floating object:

Enumeration Value

Description

If the parent paragraph is left-to-right: - If the object occurs to the right of the break, advance the text to the next available line that does not have a floating object on the right. - Otherwise, treat this as a text wrapping break of type none. If the parent paragraph is right to left: - If this is the rightmost region of text flow currently on this line, - If a floating object occurs to the right of the break, advance the text to the next available line that does not have a floating object on the right. - Otherwise, advance the text to the next position on the line where text can be displayed - Otherwise, treat this as a text wrapping break of type none.

In either case, if this line does not intersect a floating object, then treat this break as a text wrapping break of type none.

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