This documentation is archived and is not being maintained.

Range.BorderAround Method

Office 2007
Adds a border to a range and sets the Color, LineStyle, and Weight properties for the new border. Variant.


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

expression   A variable that represents a Range object.


NameRequired/OptionalData TypeDescription
LineStyleOptionalVariantOne of the constants of XlLineStyle specifying the line style for the border.
WeightOptionalXlBorderWeightThe border weight.
ColorIndexOptionalXlColorIndexThe border color, as an index into the current color palette or as a XlColorIndex constant.
ColorOptionalVariantThe border color, as an RGB value.

Return Value


You must specify either ColorIndex or Color, but not both.

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.


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

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