ParagraphBorders Class
Defines the ParagraphBorders Class.When the object is serialized out as xml, its qualified name is w:pBdr.
Inheritance Hierarchy
System.Object
DocumentFormat.OpenXml.OpenXmlElement
DocumentFormat.OpenXml.OpenXmlCompositeElement
DocumentFormat.OpenXml.Wordprocessing.ParagraphBorders
Namespace: DocumentFormat.OpenXml.Wordprocessing
Assembly: DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)
Syntax
'Declaration
<ChildElementInfoAttribute(GetType(TopBorder))> _
<ChildElementInfoAttribute(GetType(BottomBorder))> _
<ChildElementInfoAttribute(GetType(RightBorder))> _
<ChildElementInfoAttribute(GetType(BetweenBorder))> _
<ChildElementInfoAttribute(GetType(BarBorder))> _
<ChildElementInfoAttribute(GetType(LeftBorder))> _
Public Class ParagraphBorders _
Inherits OpenXmlCompositeElement
'Usage
Dim instance As ParagraphBorders
[ChildElementInfoAttribute(typeof(TopBorder))]
[ChildElementInfoAttribute(typeof(BottomBorder))]
[ChildElementInfoAttribute(typeof(RightBorder))]
[ChildElementInfoAttribute(typeof(BetweenBorder))]
[ChildElementInfoAttribute(typeof(BarBorder))]
[ChildElementInfoAttribute(typeof(LeftBorder))]
public class ParagraphBorders : OpenXmlCompositeElement
Remarks
The following table lists the possible child types:
TopBorder <w:top>
LeftBorder <w:left>
BottomBorder <w:bottom>
RightBorder <w:right>
BetweenBorder <w:between>
BarBorder <w:bar>
[ISO/IEC 29500-1 1st Edition]
17.3.1.24 pBdr (Paragraph Borders)
This element specifies the borders for the parent paragraph. Each child element shall specify a specific kind of border (left, right, bottom, top, and between).
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 paragraph borders shall be applied.
[Example: Consider a pairing of paragraphs which have a three point red border around them, and a six point border between them. These paragraphs would each have the following set of paragraph borders:
<w:pBdr> <w:top w:val="single" w:sz="24" w:space="1" w:color="FF0000" /> <w:left w:val="single" w:sz="24" w:space="4" w:color="FF0000" /> <w:bottom w:val="single" w:sz="24" w:space="1" w:color="FF0000" /> <w:right w:val="single" w:sz="24" w:space="4" w:color="FF0000" /> <w:between w:val="single" w:sz="48" w:space="1" w:color="4D5D2C" /> </w:pBdr>
The resulting paragraphs have identical pBdr values, therefore they would use the top, left, bottom, and right borders around them as a units, and the between border between each other. This matching heuristic is further discussed in the child elements of the pBdr element. end example]
Parent Elements |
|---|
pPr (§17.3.1.26); pPr (§17.3.1.25); pPr (§17.7.5.2); pPr (§17.7.6.1); pPr (§17.9.23); pPr (§17.7.8.2) |
Child Elements |
Subclause |
|---|---|
bar (Paragraph Border Between Facing Pages) |
§17.3.1.4 |
between (Paragraph Border Between Identical Paragraphs) |
§17.3.1.5 |
bottom (Paragraph Border Below Identical Paragraphs) |
§17.3.1.7 |
left (Left Paragraph Border) |
§17.3.1.17 |
right (Right Paragraph Border) |
§17.3.1.28 |
top (Paragraph Border Above Identical Paragraphs) |
§17.3.1.42 |
[Note: The W3C XML Schema definition of this element’s content model (CT_PBdr) 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.