captionSide property
Sets or retrieves where the caption of a table is located.
.png){kind=icon} .png){kind=icon} |
Syntax
HRESULT value = object.put_captionSide( v);HRESULT value = object.get_captionSide(* p);
Property values
Type: BSTR
the placement of the caption.
top (top)
For horizontal tables (in horizontal writing modes), the caption is placed above the table. Not supported for vertical tables (in vertical writing modes).
bottom (bottom)
For horizontal tables, the caption is placed below the table. Not supported for vertical tables.
left (left)
For vertical tables, the caption is placed at the left of the table. Not supported for horizontal tables.
right (right)
For vertical tables, the caption is placed at the right of the table. Not supported for horizontal tables.
String format
top | bottom
CSS information
| Applies To | All elements |
| Media | visual |
| Inherited | 1 |
| Initial Value |
Standards information
- CSS 2.1, Section 17.4.1
Remarks
The supported possible values for IHTMLStyle6::captionSide depend on the orientation of the table. Horizontal tables (IHTMLCurrentStyle2::writingMode set to lr-* or rl-*) support the top and bottom values. Vertical tables (IHTMLCurrentStyle2::writingMode set to tb-* or bt-*) support the left and right values.
Using an unsupported value for this property (for instance, left on a caption for a horizontal table) will cause the caption to appear at the "logical top" of the table. The logical top of a table depends on the writing mode of the text, and is parallel to and immediately precedes the first line of text in a table.
Captions placed to the left or right of the table are not rotated so as to be read vertically. To do this, use the Rotation property of the BasicImage filter (Windows Internet Explorer only).
Captions placed to the left or right of the table are not rotated so as to be read vertically. To do this, use the Rotation property of the BasicImage filter.
This style attribute can be applied to any element with a IHTMLRuleStyle::display style of table-caption.
This property requires Internet Explorer to be in IE8 Standards mode rendering.
Requirements
Minimum supported client |
Windows XP with SP2 |
Minimum supported server |
Windows Server 2003 |
Header |
Mshtml.h |
IDL |
Mshtml.idl |
DLL |
Mshtml.dll |