IHTMLRuleStyle2::get_tableLayout Method

Retrieves the value of the tableLayout property of the element.

Syntax

HRESULT get_tableLayout(
    BSTR *p
);

Parameters

p

Address of a string (BSTR) that contains tableLayout option.

Return Value

Returns S_OK if successful, or an error code otherwise.

Remarks

If the width attribute is not set on the COL object, the columns are given equal widths, with the sum of the widths totaling the width of the TABLE object.

If the content of a cell exceeds the fixed width of the column, the content will be wrapped or, if wrapping is not possible, it will be clipped. If the row height is specified, wrapped text will be clipped when it exceeds the set height.

Setting the property to fixed significantly improves the table rendering speed, particularly for longer tables.

Setting row height further improves rendering speed, again enabling the browser's parser to begin rendering the row without having to examine the content of each cell in the row to determine row height.

IHTMLRuleStyle2::put_tableLayout Method

Sets the value of the tableLayout property of the element.

Syntax

HRESULT put_tableLayout(
    BSTR v
);

Parameters

v

String (BSTR) that contains the tableLayout option to set.

Return Value

Returns S_OK if successful, or an error code otherwise.

Remarks

If the width attribute is not set on the COL object, the columns are given equal widths, with the sum of the widths totaling the width of the TABLE object.

If the content of a cell exceeds the fixed width of the column, the content will be wrapped or, if wrapping is not possible, it will be clipped. If the row height is specified, wrapped text will be clipped when it exceeds the set height.

Setting the property to fixed significantly improves the table rendering speed, particularly for longer tables.

Setting row height further improves rendering speed, again enabling the browser's parser to begin rendering the row without having to examine the content of each cell in the row to determine row height.