borderRadius property

Article
05/02/2017

Specifies the radii of a quarter ellipse that defines the shape of the corners for the outer border edge of the current box.

Syntax

Integer value = object.put_borderRadius(BSTR v);Integer value = object.get_borderRadius(BSTR* sRadius);

Property values

Type: BSTR

One to eight of either of the following values, separated by an optional slash ("/"):

length (length)

Floating-point number, followed by a supported length unit.

percentage (percentage)

An integer, followed by a %. The value is a percentage of, for horizontal radii, the width of the border box, or for vertical radii, the height of the border box.

String format

[ <length> | <percentage> ] {1,4} [ / [ <length> | <percentage> ] {1,4} ] ?

CSS information

Applies To	All elements
Media	visual
Inherited	no
Initial Value	(see individual properties)

Standards information

CSS Backgrounds and Borders Module Level 3, Section 5.1

Remarks

The IHTMLCSSStyleDeclaration::borderRadius property is a composite property that specifies up to four border-*-radius properties. If values are given before and after the slash, the values before the slash set the horizontal radius and the values after the slash set the vertical radius. If there is no slash, the values set both radii equally.

The four values for each radius are given in the following order:

top left (equivalent to the IHTMLCSSStyleDeclaration::borderTopLeftRadius property)
top right (equivalent to the IHTMLCSSStyleDeclaration::borderTopRightRadius property)
bottom right (equivalent to the IHTMLCSSStyleDeclaration::borderBottomRightRadius property)
bottom left (equivalent to the IHTMLCSSStyleDeclaration::borderBottomLeftRadius property)

If the bottom-left value is omitted, the value is the same as the top-right value. If the bottom-right value is omitted, the value is the same as the top-left value. If the top-right value is omitted, the value is the same as the top-left value.

For more information about the IHTMLCSSStyleDeclaration::borderRadius property and related properties, see How to Add Rounded Corners with CSS3.

Examples

Following is an example of a typical use for the IHTMLCSSStyleDeclaration::borderRadius property. Because there are two values after the IHTMLCSSStyleDeclaration::borderRadius property, the first value is the radius of the circle that defines the top-left and bottom-right corners of the element, and the second value is the radius of the circle that defines the top-right and bottom-left corners of the element.

div.rounded {
  width: 800px;
  height: 600px;
  border: solid black 10px;
  border-radius: 15px 10px 
}

This example appears as follows in Internet Explorer 9 and later.

The following two selectors are equivalent; they produce identical results.

div.shorthand {
  border-radius: 40px;
}

div.all4properties {
  border-top-left-radius: 40px;
  border-top-right-radius: 40px; 
  border-bottom-right-radius: 40px;
  border-bottom-left-radius: 40px;
}

The following two selectors are also equivalent.

div.shorthand2 {
  border-radius: 2em 1em 4em / 0.5em 3em;
}

div.all4properties2 {
  border-top-left-radius: 2em 0.5em;  
  border-top-right-radius: 1em 3em;
  border-bottom-right-radius: 4em 0.5em;
  border-bottom-left-radius: 1em 3em;
}

Requirements

Minimum supported client	Windows Vista with SP1, Windows 7
Minimum supported server	Windows Server 2008 R2
Header	Mshtml.h
IDL	Mshtml.idl
DLL	Mshtml.dll