Skip to main content

SetTopBorder

Specifies the border which will be displayed above a set of paragraphs which have the same set of paragraph border settings.

note

The paragraphs of the same style going one by one are considered as a single block, so the border is added to the whole block rather than to every paragraph in this block.

Inherited from ApiParaPr.SetTopBorder.

Syntax​

expression.SetTopBorder(sType, nSize, nSpace, r, g, b);

expression - A variable that represents an ApiParagraph class.

Parameters​

NameRequired/OptionalData typeDefaultDescription
sTypeRequiredBorderTypeThe border style.
nSizeRequiredpt_8The width of the current top border measured in eighths of a point.
nSpaceRequiredptThe spacing offset above the paragraph measured in points used to place this border.
rRequiredbyteRed color component value.
gRequiredbyteGreen color component value.
bRequiredbyteBlue color component value.

Returns​

boolean

Example​

Draw a visible line above a paragraph to separate it from the content above in a document.

// How do I add a decorative or structural border along the top of a paragraph in a document?

// Visually divide sections of text by placing a styled line at the top of a paragraph in a document.

let doc = Api.GetDocument();
let paragraph = doc.GetElement(0);
paragraph.AddText("This is the first paragraph. We will add a thick orange border above it.");
paragraph.SetTopBorder("single", 24, 0, 255, 111, 61);