IHTMLStyle2::get_tablelayout Method

This document describes technologies available in the Internet Explorer 5 Beta. While we encourage you to evaluate these features and to send us your feedback, please note that these features are subject to change.

Retrieves whether the table layout is fixed.

Syntax

HRESULT get_tablelayout(
    BSTR *p
);

Parameters

p
Address of a string structure that contains the table layout.

auto The column width is determined by the widest unbreakable content in the column cells.

fixed The table and column widths are set by either the sum of the widths on the COL objects or, if these are not specified, by the contents in the first row of cells.

Return Value

Returns S_OK if successful, or an error value 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.
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.

IHTMLStyle2::put_tablelayout Method

Sets whether the table layout is fixed.

Syntax

HRESULT put_tablelayout(
    BSTR v
);

Parameters

v
String (BSTR) that contains the tablelayout option to be set.

auto The column width is determined by the widest unbreakable content in the column cells.

fixed The table and column widths are set by either the sum of the widths on the COL objects or, if these are not specified, by the contents in the first row of cells.

Return Value

Returns S_OK if successful, or an error value 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.
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.

auto	The column width is determined by the widest unbreakable content in the column cells.
fixed	The table and column widths are set by either the sum of the widths on the COL objects or, if these are not specified, by the contents in the first row of cells.