Border Class

Defines the Border Class.When the object is serialized out as xml, its qualified name is w:bdr.

Inheritance Hierarchy

System.Object
  DocumentFormat.OpenXml.OpenXmlElement
    DocumentFormat.OpenXml.OpenXmlLeafElement
      DocumentFormat.OpenXml.Wordprocessing.BorderType
        DocumentFormat.OpenXml.Wordprocessing.Border

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

Syntax

'Declaration
Public Class Border _
    Inherits BorderType
'Usage
Dim instance As Border
public class Border : BorderType

Remarks

[ISO/IEC 29500-1 1st Edition]

17.3.2.4 bdr (Text Border)

This element specifies information about the border applied to the text in the current run.

The first piece of information specified by the bdr element is that the current shall have a border when displayed. This information is specified simply by the presence of the bdr element in run's properties.

The second piece of information concerns the set of runs which share the current run border. This is determined based on the attributes on the bdr element. If the set of attribute values specifies on two adjacent runs is identical, then those two runs shall be considered to be part of the same run border group and rendered within the same set of borders in the document.

If this element is not present, the default value is to leave the formatting applied at previous level in the style hierarchy. If this element is never applied in the style hierarchy, then no run border shall be applied to the text in this run.

[Example: Consider a document in which the following two runs are located adjacent to one another:

<w:r>
  <w:rPr>
    <w:bdr w:val="single" w:sz="36" w:space="0" w:color="B8CCE4" w:themeColor="accent1" w:themeTint="66" /> 
  </w:rPr>
  <w:t xml:space="preserve">run one</w:t> 
</w:r>
<w:r >
  <w:rPr>
    <w:b /> 
    <w:bdr w:val="single" w:sz="36" w:space="0" w:color="B8CCE4" w:themeColor="accent1" w:themeTint="66" /> 
  </w:rPr>
  <w:t>run two</w:t> 
</w:r>

These two runs, although each is distinct, are combined when rendering the text border because the bdr elements are identical between the two runs. end example]

Parent Elements

rPr (§17.3.1.29); rPr (§17.3.1.30); rPr (§17.5.2.28); rPr (§17.9.25); rPr (§17.7.9.1); rPr (§17.7.5.4); rPr (§17.3.2.28); rPr (§17.5.2.27); rPr (§17.7.6.2); rPr (§17.3.2.27)

This element’s content model is defined by the common border properties definition in §17.3.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

Border Members

DocumentFormat.OpenXml.Wordprocessing Namespace