<top> (Paragraph Border Above Identical Paragraphs)

This element specifies the  border which shall be displayed above a set of paragraphs which have the same set of paragraph border settings.

To determine if any two adjoining paragraphs shall have an individual <top> and <bottom> border or a <between> border, the set of borders on the two adjoining paragraphs are compared. If the border information on those two paragraphs is identical for all possible paragraphs borders, then the <between> border is displayed. Otherwise, the final paragraph shall use its <bottom> border and the following paragraph shall use its <top> border, respectively. If this border specifies a @space attribute, that value determines the space above the text (ignoring any spacing above) which should be left before this border is drawn, specified in points.

If this element is omitted on a given paragraph, its value is determined by the setting previously set at any level of the style hierarchy (i.e. that previous setting remains unchanged). If this setting is never specified in the style hierarchy, then no between border shall be applied above identical paragraphs.

example:
<w:p>
  <w:pPr>
    <w:pBdr>
      <w:top w:val="single" w:sz="24" w:space="1" w:color="F2DCDB" w:themeColor="accent2" w:themeTint="33" /> 
      <w:left w:val="single" w:sz="24" w:space="4" w:color="B97034" w:themeColor="accent6" w:themeShade="BF" /> 
      <w:bottom w:val="single" w:sz="24" w:space="1" w:color="F2DCDB" w:themeColor="accent2" w:themeTint="33" /> 
      <w:right w:val="single" w:sz="24" w:space="4" w:color="C3D69B" w:themeColor="accent3" w:themeTint="99" /> 
      <w:between w:val="single" w:sz="24" w:space="1" w:color="4F81BD" w:themeColor="accent1" /> 
    </w:pBdr>
  </w:pPr>
  <w:r>
    <w:t>First paragraph.</w:t> 
  </w:r>
</w:p>
<w:p>
  <w:pPr>
    <w:pBdr>
      <w:top w:val="single" w:sz="24" w:space="1" w:color="F2DCDB" w:themeColor="accent2" w:themeTint="33" /> 
      <w:left w:val="single" w:sz="24" w:space="4" w:color="B97034" w:themeColor="accent6" w:themeShade="BF" /> 
      <w:bottom w:val="single" w:sz="24" w:space="0" w:color="F2DCDB" w:themeColor="accent2" w:themeTint="33" /> 
      <w:right w:val="single" w:sz="24" w:space="4" w:color="C3D69B" w:themeColor="accent3" w:themeTint="99" /> 
      <w:between w:val="single" w:sz="24" w:space="1" w:color="4F81BD" w:themeColor="accent1" /> 
    </w:pBdr>
  </w:pPr>
  <w:r>
    <w:t>Second paragraph.</w:t> 
  </w:r>
</w:p>

Since the paragraph border is different between the two paragraphs (the <bottom> @space value goes from 1 to 0), paragraph two uses its <top> border, which is located one point above the text in that paragraph. ]

Parent Elements

<pBdr>2.3.1.24)

Attributes

Description

<color> (Border Color)

Specifies the color for this border.

This color may either be presented as a hex value (in RRGGBB format), or auto to allow a consumer to automatically determine the border color as appropriate.

<w:bottom  w:color="auto"/>

This color therefore may be automatically be modified by a consumer as appropriate, for example, in order to ensure that the border can be distinguished against the page's background color. ]

If the border style (the @val attribute) specifies the use of an art border, this attribute is ignored. As well, if the border specifies the use of a theme color via the @themeColor attribute, this value is superseded by the theme color value.

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

<frame> (Create Frame Effect)

Specifies whether the specified border should be modified to create a frame effect by reversing the border's appearance from the edge nearest the text to the edge furthest from the text.

If this attribute is omitted, then the border is not given any frame effect.

<w:bottom w:frame="true" ... />

This frame's @val is true, indicating that the border frame effect shall be applied. ]

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

<shadow> (Border Shadow)

Specifies whether this border should be modified to create the appearance of a shadow.

For the right and bottom borders, this is accomplished by duplicating the border below and right of the normal border location. For the right and top borders, this is accomplished by moving the order down and to the right of its original location.

If this attribute is omitted, then the border is not given the shadow effect.

<w:bottom w:shadow="true" ... />

This frame's @val is true, indicating that the shadow effect shall be applied to the border. ]

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

<space> (Border Spacing Measurement)

Specifies the spacing offset that shall be used to place this border on the parent object.

When a document has a page border that is relative to the page edges (using a value of page in the @offsetFrom attribute on <pgBorders>2.6.10)), it shall specify the distance between the edge of the page and the beginning of this border in points.

When a document has a page border that is relative to the text extents (using a value of text in the @offsetFrom attribute on <pgBorders >2.6.10)), or any other border type, it shall specify the distance between the edge of the object and the beginning of this border in points.

<w:pgBorders w:offsetFrom="page">
  <w:bottom  w:space="24/> 
</w:pgBorders

The @offsetFrom attribute specifies that the @space value will provide the offset of the page border from the page edge, and the value of the space attribute specifies that the page offset shall be 24 points. ]

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

<sz> (Border Width)

Specifies the width of the current border.

If the border style (@val attribute) specifies a line border, the width of this border is specified in measurements of eighths of a point, with a minimum value of two (one-fourth of a point) and a maximum value of 96 (twelve points). Any values outside this range may be reassigned to a more appropriate value.

If the border style (@val attribute) specifies an art border, the width of this border is specified in measurements of points, with a minimum value of one and a maximum value of 31. Any values outside this range may be reassigned to a more appropriate value.

<w:top w:val="dashed" w:sz="24" …/>
<w:left w:val="dashed" w:sz="24" …/>
<w:bottom w:val="dashed" w:sz="24" …/>
<w:right w:val="dashed" w:sz="24" …/>

The border style is specified using the @val attribute, and because that border style is a line border (dashed), the @sz attribute specifies the size in eighths of a point (24 eighths of a point = 3 points). ]

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

<themeColor> (Border Theme Color)

Specifies a theme color to be applied to the current border.

The specified theme color is a reference to one of the predefined theme colors, located in the document's Theme part,which allows color information to be set centrally in the document.

<w:top  w:color="FFA8A0" w:themeColor="accent2" w:themeTint="99" />
<w:bottom  w:color="FFA8A0" w:themeColor="accent2" w:themeTint="99" />
<w:left  w:color="FFA8A0" w:themeColor="accent2" w:themeTint="99" />
<w:right  w:color="FFA8A0" w:themeColor="accent2" w:themeTint="99" />

The borders have a @color with an RGB value of FFA8A0, however, because the @themeColor attribute is specified, that value is ignored in favor of the accent2 theme color specified for this document. ]

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

<themeShade> (Border Theme Color Shade)

Specifies the shade value applied to the supplied theme color (if any) for this border instance.

If the @themeShade is supplied, then it is applied to the RGB value of the theme color (from the theme part) to determine the final color applied to this border.

The @themeShade value is stored as a hex encoding of the shade value (from 0–255) applied to the current border.

The resulting @themeShade value in the file format would be 66. ]

Given an RGB color defined as three hex values in RRGGBB format, the shade is applied as follows:

  • Convert the color to the HSL color format (values from 0 to 1)

  • Modify the luminance factor as follows:

  • Convert the resultant HSL color to RGB

The equivalent HSL color value would be.

Applying the shade formula with a shade percentage of 75% to the luminance, we get:

Taking the resulting HSL color value of and converting back to RGB, we get 943634.

This transformed value can be seen in the resulting background's @color attribute:

<w:top w:val="single" w:sz="4" w:space="24" 
  w:color="943634" w:themeColor="accent2" 
  w:themeShade="BF"/>

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

<themeTint> (Border Theme Color Tint)

Specifies the tint value applied to the supplied theme color (if any) for this border instance.

If the @themeTint is supplied, then it is applied to the RGB value of the theme color (from the theme part) to determine the final color applied to this border.

The @themeTint value is stored as a hex encoding of the tint value (from 0–255) applied to the current border.

The resulting @themeTint value in the file format would be 99. ]

Given an RGB color defined as three hex values in RRGGBB format, the shade is applied as follows:

  • Convert the color to the HSL color format (values from 0 to 1)

  • Modify the luminance factor as follows:

  • Convert the resultant HSL color to RGB

The equivalent HSL color value would be.

Applying the tint formula with a tint percentage of 60% to the luminance, we get:

Taking the resulting HSL color value of and converting back to RGB, we get 95B3D7.

This transformed value can be seen in the resulting background's @color attribute:

<w:top w:val="single" w:sz="4" w:space="24"
  w:color="95B3D7" w:themeColor="accent2" 
  w:themeTint="99"/>

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

<val> (Border Style)

Specifies the style of border used on this object.

This border can either be an art border (a repeated image along the borders - only valid for page borders) or a line border (a line format repeated along the borders) - see the simple type definition for a description of each border style.

<w:left w:val="single" …/>

This border's @val is single, indicating that the border style is a single line. ]

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

The following XML Schema fragment defines the contents of this element:

<complexType name="CT_Border">
	<attribute name="val" type="ST_Border" use="required"/>
	<attribute name="color" type="ST_HexColor" use="optional"/>
	<attribute name="themeColor" type="ST_ThemeColor" use="optional"/>
	<attribute name="themeTint" type="ST_UcharHexNumber" use="optional"/>
	<attribute name="themeShade" type="ST_UcharHexNumber" use="optional"/>
	<attribute name="sz" type="ST_EighthPointMeasure" use="optional"/>
	<attribute name="space" type="ST_PointMeasure" use="optional"/>
	<attribute name="shadow" type="ST_OnOff" use="optional"/>
	<attribute name="frame" type="ST_OnOff" use="optional"/>
</complexType>