Range.BorderAround method (Excel)

Adds a border to a range and sets the Color, LineStyle, and Weight properties of the Border object for the new border. Variant.

Syntax

expression.BorderAround (LineStyle, Weight, ColorIndex, Color, ThemeColor)

expression A variable that represents a Range object.

Parameters

Name Required/Optional Data type Description
LineStyle Optional Variant One of the constants of XlLineStyle specifying the line style for the border.
Weight Optional XlBorderWeight The border weight.
ColorIndex Optional XlColorIndex The border color, as an index into the current color palette or as an XlColorIndex constant.
Color Optional Variant The border color, as an RGB value.
ThemeColor Optional Variant The theme color, as an index into the current color theme or as an XlThemeColor value.

Return value

Variant

Remarks

You must specify only one of the following: ColorIndex, Color, or ThemeColor.

You can specify either LineStyle or Weight, but not both. If you don't specify either argument, Microsoft Excel uses the default line style and weight.

This method outlines the entire range without filling it in. To set the borders of all the cells, you must set the Color, LineStyle, and Weight properties for the Borders collection. To clear the border, you must set the LineStyle property to xlLineStyleNone for all the cells in the range.

Example

This example adds a thick red border around the range A1:D4 on Sheet1.

Worksheets("Sheet1").Range("A1:D4").BorderAround _ 
 ColorIndex:=3, Weight:=xlThick

Support and feedback

Have questions or feedback about Office VBA or this documentation? Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.