This topic has not yet been rated - Rate this topic

# IHTMLRuleStyle6::captionSide Property

Gets or sets where the caption of a table is located.

Syntax

```
HRESULT IHTMLRuleStyle6::get_captionSide(BSTR *p);HRESULT IHTMLRuleStyle6::put_captionSide(BSTR v);
```

Parameters

p
Pointer to a variable of type BSTR that receives the placement of the caption.
v
BSTR that specifies the placement of the caption.

Possible Values

 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 For horizontal tables, the caption is placed below the table. Not supported for vertical tables. left For vertical tables, the caption is placed at the left of the table. Not supported for horizontal tables. right For vertical tables, the caption is placed at the right of the table. Not supported for horizontal tables.

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

The supported possible values for caption-side depend on the orientation of the table. Horizontal tables ( -ms-writing-mode set to `lr-*` or `rl-*`) support the `top` and `bottom` values. Vertical tables ( -ms-writing-mode 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).

This style attribute can be applied to any element with a display style of `table-caption`.

This property requires Internet Explorer to be in IE8 Standards mode rendering.