001 /* 002 * Copyright (c) 2003 World Wide Web Consortium, 003 * (Massachusetts Institute of Technology, Institut National de 004 * Recherche en Informatique et en Automatique, Keio University). All 005 * Rights Reserved. This program is distributed under the W3C's Software 006 * Intellectual Property License. This program is distributed in the 007 * hope that it will be useful, but WITHOUT ANY WARRANTY; without even 008 * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR 009 * PURPOSE. 010 * See W3C License http://www.w3.org/Consortium/Legal/ for more details. 011 */ 012 013 package org.w3c.dom.html2; 014 015 import org.w3c.dom.DOMException; 016 017 /** 018 * The <code>THEAD</code>, <code>TFOOT</code>, and <code>TBODY</code> 019 * elements. 020 * <p>See also the <a href='http://www.w3.org/TR/2003/REC-DOM-Level-2-HTML-20030109'>Document Object Model (DOM) Level 2 HTML Specification</a>. 021 */ 022 public interface HTMLTableSectionElement extends HTMLElement { 023 /** 024 * Horizontal alignment of data in cells. See the <code>align</code> 025 * attribute for HTMLTheadElement for details. 026 */ 027 public String getAlign(); 028 /** 029 * Horizontal alignment of data in cells. See the <code>align</code> 030 * attribute for HTMLTheadElement for details. 031 */ 032 public void setAlign(String align); 033 034 /** 035 * Alignment character for cells in a column. See the char attribute 036 * definition in HTML 4.01. 037 */ 038 public String getCh(); 039 /** 040 * Alignment character for cells in a column. See the char attribute 041 * definition in HTML 4.01. 042 */ 043 public void setCh(String ch); 044 045 /** 046 * Offset of alignment character. See the charoff attribute definition in 047 * HTML 4.01. 048 */ 049 public String getChOff(); 050 /** 051 * Offset of alignment character. See the charoff attribute definition in 052 * HTML 4.01. 053 */ 054 public void setChOff(String chOff); 055 056 /** 057 * Vertical alignment of data in cells. See the <code>valign</code> 058 * attribute for HTMLTheadElement for details. 059 */ 060 public String getVAlign(); 061 /** 062 * Vertical alignment of data in cells. See the <code>valign</code> 063 * attribute for HTMLTheadElement for details. 064 */ 065 public void setVAlign(String vAlign); 066 067 /** 068 * The collection of rows in this table section. 069 */ 070 public HTMLCollection getRows(); 071 072 /** 073 * Insert a row into this section. The new row is inserted immediately 074 * before the current <code>index</code>th row in this section. If 075 * <code>index</code> is -1 or equal to the number of rows in this 076 * section, the new row is appended. 077 * @param index The row number where to insert a new row. This index 078 * starts from 0 and is relative only to the rows contained inside 079 * this section, not all the rows in the table. 080 * @return The newly created row. 081 * @exception DOMException 082 * INDEX_SIZE_ERR: Raised if the specified index is greater than the 083 * number of rows of if the index is a negative number other than -1. 084 * @version DOM Level 2 085 */ 086 public HTMLElement insertRow(int index) 087 throws DOMException; 088 089 /** 090 * Delete a row from this section. 091 * @param index The index of the row to be deleted, or -1 to delete the 092 * last row. This index starts from 0 and is relative only to the rows 093 * contained inside this section, not all the rows in the table. 094 * @exception DOMException 095 * INDEX_SIZE_ERR: Raised if the specified index is greater than or 096 * equal to the number of rows or if the index is a negative number 097 * other than -1. 098 * @version DOM Level 2 099 */ 100 public void deleteRow(int index) 101 throws DOMException; 102 103 }