borderStyle property

Specifies the style of the left, right, top, and bottom borders of the object.

 

Syntax

Integer value = object.put_borderStyle(BSTR v);Integer value = object.get_borderStyle(BSTR* sStyle);

Property values

Type: BSTR

none (none)

Default. No border is drawn, regardless of any specified IHTMLRuleStyle::borderWidth.

hidden (hidden)

Internet Explorer 8. Same as none, except in terms of conflict resolution of collapsed borders. Any element with a hidden border suppresses all shared borders at that location. Borders with a style of none have the lowest priority.

dotted (dotted)

Border is a dotted line. This value is supported on the Macintosh platform, as of Internet Explorer 4.01, and on the Windows platform, as of Internet Explorer 5.5. It renders as a solid line on UNIX platforms, and on Windows systems running earlier versions of Internet Explorer.

dashed (dashed)

Border is a dashed line. This value is supported on the Macintosh platform as of Internet Explorer 4.01 and on the Windows platform, as of Internet Explorer 5.5. It renders as a solid line on UNIX platforms, and on Windows systems running earlier versions of Internet Explorer.

solid (solid)

Border is a solid line.

double (double)

Border is a double line drawn on top of the background of the object. The sum of the two single lines and the space between equals the IHTMLRuleStyle::borderWidth value. The border width must be at least 3 pixels wide to draw a double border.

groove (groove)

3-D groove is drawn in colors based on the value. The IHTMLRuleStyle::borderWidth property of the object must be specified for the style to render correctly.

ridge (ridge)

3-D ridge is drawn in colors based on the value.

inset (inset)

3-D inset is drawn in colors based on the value.

window-inset (window-inset)

Internet Explorer 6 and later. Border is the same as inset, but is surrounded by an additional single line, drawn in colors based on the value.

outset (outset)

3-D outset is drawn in colors based on the value.

String format

none | hidden | dotted | dashed | solid | double | groove | ridge | inset | outset {1,4}

CSS information

Applies To	All elements
Media	visual
Inherited	no
Initial Value	none

Standards information

• CSS Backgrounds and Borders Module Level 3, Section 4.2

Remarks

Illustrations of the above values are shown in the image below.

Examples

The following example shows how to use IHTMLRuleStyle::borderStyle to apply different border styles on the same div element.

<div id="multiple">
   border-style: dotted dashed ridge double;
</div> 

In the CSS below, IHTMLRuleStyle::borderStyle is set to dotted dashed ridge double. This sets the IHTMLRuleStyle::borderTopStyle to dotted, IHTMLRuleStyle::borderLeftStyle to dashed, IHTMLRuleStyle::borderBottomStyle to ridge, and IHTMLRuleStyle::borderRightStyle to double.

#multiple {
  width: 250px;
  background-color: #E6E6E6;
  border-style: dotted dashed ridge double;
  border-width: 6px;
  border-color: #000080;    
}

Requirements

Minimum supported client	Windows XP
Minimum supported server	Windows Server 2003
Header	Mshtml.h
IDL	Mshtml.idl
DLL	Mshtml.dll

See also

IHTMLRuleStyle::border