IHTMLTable interface

This interface specifies that the contained content is organized into a table with rows and columns.

Members

The IHTMLTable interface inherits from the IDispatch interface. IHTMLTable also has these types of members:

  • Methods
  • Properties

Methods

The IHTMLTable interface has these methods.

Method Description
createCaption

Creates an empty caption element in the table.

createTFoot

Creates an empty tFoot element in the table.

createTHead

Creates an empty tHead element in the table.

deleteCaption

Deletes the caption element and its contents from the table.

deleteRow

Removes the specified row (tr) from the element and from the rows collection.

deleteTFoot

Deletes the tFoot element and its contents from the table.

deleteTHead

Deletes the tHead element and its contents from the table.

insertRow

Creates a new row (tr) in the table, and adds the row to the rows collection.

nextPage

Displays the next page of records in the data set to which the table is bound.

previousPage

Displays the previous page of records in the data set to which the table is bound.

refresh

Refreshes the content of the table. This might be necessary after a call to a method such as IHTMLStyleSheet::removeRule, when the page does not automatically reflow.

 

Properties

The IHTMLTable interface has these properties.

Property Description

align

Sets or retrieves a value that indicates the table alignment.

background

Sets or retrieves the background picture tiled behind the text and graphics in the object.

bgColor

Deprecated. Sets or retrieves the background color behind the object.

border

Sets or retrieves the width of the border to draw around the object.

borderColor

Sets or retrieves the border color of the object.

borderColorDark

Sets or retrieves the color for one of the two colors used to draw the 3-D border of the object.

borderColorLight

Sets or retrieves the color for one of the two colors used to draw the 3-D border of the object.

caption

Retrieves the caption object of a table.

cellPadding

Sets or retrieves the amount of space between the border of the cell and the content of the cell.

cellSpacing

Sets or retrieves the amount of space between cells in a table.

cols

Sets or retrieves the number of columns in the table.

dataPageSize

Sets or retrieves the number of records displayed in a table bound to a data source.

frame

Sets or retrieves the way the border frame around the table is displayed.

height

Sets or retrieves the height of the object.

readyState

Retrieves a value that indicates the current state of the object.

rules

Sets or retrieves which dividing lines (inner borders) are displayed.

tFoot

Retrieves an IHTMLTableSection pointer to the foot section of a table.

tHead

Retrieves an IHTMLTableSection pointer to the head section of a table.

width

Sets or retrieves the width of the object.

 

Remarks

Valid tags within a table include caption, col, colGroup, tBody, tHead, tFoot, and tr.

The table element is a block element.

Windows Internet Explorer 8 will only render tables up to 1000 columns. To force Windows Internet Explorer 7 rendering mode, see How Do I Take Advantage of the New Features in Internet Explorer 8.

Requirements

Minimum supported client

Windows XP

Minimum supported server

Windows 2000 Server

Header

Mshtml.h

IDL

Mshtml.idl

DLL

Mshtml.dll

See also

IDispatch

Reference

IHTMLTable2

IHTMLTable3