File Doc Category Size Date Package
HTMLTableElement.java API Doc Java SE 5 API 6594 Fri Aug 26 14:58:40 BST 2005 org.w3c.dom.html

HTMLTableElement

public interface HTMLTableElement implements HTMLElement

The create* and delete* methods on the table allow authors to construct and modify tables. HTML 4.0 specifies that only one of each of the CAPTION , THEAD , and TFOOT elements may exist in a table. Therefore, if one exists, and the createTHead() or createTFoot() method is called, the method returns the existing THead or TFoot element. See the TABLE element definition in HTML 4.0.

Fields Summary
Constructors Summary
Methods Summary
public org.w3c.dom.html.HTMLElement createCaption()
Create a new table caption object or return an existing one.
return
A CAPTION element.
public org.w3c.dom.html.HTMLElement createTFoot()
Create a table footer row or return an existing one.
return
A footer element (TFOOT ).
public org.w3c.dom.html.HTMLElement createTHead()
Create a table header row or return an existing one.
return
A new table header element (THEAD ).
public void deleteCaption()
Delete the table caption, if one exists.
public void deleteRow(int index)
Delete a table row.
param
index The index of the row to be deleted. This index starts from 0 and is relative to all the rows contained inside the table, regardless of section parentage.
exception
DOMException INDEX_SIZE_ERR: Raised if the specified index is greater than or equal to the number of rows or if the index is negative.
public void deleteTFoot()
Delete the footer from the table, if one exists.
public void deleteTHead()
Delete the header from the table, if one exists.
public java.lang.String getAlign()
Specifies the table's position with respect to the rest of the document. See the align attribute definition in HTML 4.0. This attribute is deprecated in HTML 4.0.
public java.lang.String getBgColor()
Cell background color. See the bgcolor attribute definition in HTML 4.0. This attribute is deprecated in HTML 4.0.
public java.lang.String getBorder()
The width of the border around the table. See the border attribute definition in HTML 4.0.
public org.w3c.dom.html.HTMLTableCaptionElement getCaption()
Returns the table's CAPTION , or void if none exists.
public java.lang.String getCellPadding()
Specifies the horizontal and vertical space between cell content and cell borders. See the cellpadding attribute definition in HTML 4.0.
public java.lang.String getCellSpacing()
Specifies the horizontal and vertical separation between cells. See the cellspacing attribute definition in HTML 4.0.
public java.lang.String getFrame()
Specifies which external table borders to render. See the frame attribute definition in HTML 4.0.
public org.w3c.dom.html.HTMLCollection getRows()
Returns a collection of all the rows in the table, including all in THEAD , TFOOT , all TBODY elements.
public java.lang.String getRules()
Specifies which internal table borders to render. See the rules attribute definition in HTML 4.0.
public java.lang.String getSummary()
Description about the purpose or structure of a table. See the summary attribute definition in HTML 4.0.
public org.w3c.dom.html.HTMLCollection getTBodies()
Returns a collection of the defined table bodies.
public org.w3c.dom.html.HTMLTableSectionElement getTFoot()
Returns the table's TFOOT , or null if none exists.
public org.w3c.dom.html.HTMLTableSectionElement getTHead()
Returns the table's THEAD , or null if none exists.
public java.lang.String getWidth()
Specifies the desired table width. See the width attribute definition in HTML 4.0.
public org.w3c.dom.html.HTMLElement insertRow(int index)
Insert a new empty row in the table. The new row is inserted immediately before and in the same section as the current index th row in the table. If index is equal to the number of rows, the new row is appended. In addition, when the table is empty the row is inserted into a TBODY which is created and inserted into the table. Note. A table row cannot be empty according to HTML 4.0 Recommendation.
param
index The row number where to insert a new row. This index starts from 0 and is relative to all the rows contained inside the table, regardless of section parentage.
return
The newly created row.
exception
DOMException INDEX_SIZE_ERR: Raised if the specified index is greater than the number of rows or if the index is negative.
public void setAlign(java.lang.String align)
public void setBgColor(java.lang.String bgColor)
public void setBorder(java.lang.String border)
public void setCaption(org.w3c.dom.html.HTMLTableCaptionElement caption)
public void setCellPadding(java.lang.String cellPadding)
public void setCellSpacing(java.lang.String cellSpacing)
public void setFrame(java.lang.String frame)
public void setRules(java.lang.String rules)
public void setSummary(java.lang.String summary)
public void setTFoot(org.w3c.dom.html.HTMLTableSectionElement tFoot)
public void setTHead(org.w3c.dom.html.HTMLTableSectionElement tHead)
public void setWidth(java.lang.String width)