gomp-20050608-branch/libjava/classpath/external/w3c_dom/org/w3c/dom/html2/HTMLTableSectionElement.java

   1 /*
   2  * Copyright (c) 2003 World Wide Web Consortium,
   3  * (Massachusetts Institute of Technology, Institut National de
   4  * Recherche en Informatique et en Automatique, Keio University). All
   5  * Rights Reserved. This program is distributed under the W3C's Software
   6  * Intellectual Property License. This program is distributed in the
   7  * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
   8  * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
   9  * PURPOSE.
  10  * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
  11  */
  12
  13 package org.w3c.dom.html2;
  14
  15 import org.w3c.dom.DOMException;
  16
  17 /**
  18  * The <code>THEAD</code>, <code>TFOOT</code>, and <code>TBODY</code>
  19  * elements.
  20  * <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>.
  21  */
  22 public interface HTMLTableSectionElement extends HTMLElement {
  23     /**
  24      * Horizontal alignment of data in cells. See the <code>align</code>
  25      * attribute for HTMLTheadElement for details.
  26      */
  27     public String getAlign();
  28     /**
  29      * Horizontal alignment of data in cells. See the <code>align</code>
  30      * attribute for HTMLTheadElement for details.
  31      */
  32     public void setAlign(String align);
  33
  34     /**
  35      * Alignment character for cells in a column. See the char attribute
  36      * definition in HTML 4.01.
  37      */
  38     public String getCh();
  39     /**
  40      * Alignment character for cells in a column. See the char attribute
  41      * definition in HTML 4.01.
  42      */
  43     public void setCh(String ch);
  44
  45     /**
  46      * Offset of alignment character. See the charoff attribute definition in
  47      * HTML 4.01.
  48      */
  49     public String getChOff();
  50     /**
  51      * Offset of alignment character. See the charoff attribute definition in
  52      * HTML 4.01.
  53      */
  54     public void setChOff(String chOff);
  55
  56     /**
  57      * Vertical alignment of data in cells. See the <code>valign</code>
  58      * attribute for HTMLTheadElement for details.
  59      */
  60     public String getVAlign();
  61     /**
  62      * Vertical alignment of data in cells. See the <code>valign</code>
  63      * attribute for HTMLTheadElement for details.
  64      */
  65     public void setVAlign(String vAlign);
  66
  67     /**
  68      * The collection of rows in this table section.
  69      */
  70     public HTMLCollection getRows();
  71
  72     /**
  73      * Insert a row into this section. The new row is inserted immediately
  74      * before the current <code>index</code>th row in this section. If
  75      * <code>index</code> is -1 or equal to the number of rows in this
  76      * section, the new row is appended.
  77      * @param index The row number where to insert a new row. This index
  78      *   starts from 0 and is relative only to the rows contained inside
  79      *   this section, not all the rows in the table.
  80      * @return The newly created row.
  81      * @exception DOMException
  82      *   INDEX_SIZE_ERR: Raised if the specified index is greater than the
  83      *   number of rows of if the index is a negative number other than -1.
  84      * @version DOM Level 2
  85      */
  86     public HTMLElement insertRow(int index)
  87                                  throws DOMException;
  88
  89     /**
  90      * Delete a row from this section.
  91      * @param index The index of the row to be deleted, or -1 to delete the
  92      *   last row. This index starts from 0 and is relative only to the rows
  93      *   contained inside this section, not all the rows in the table.
  94      * @exception DOMException
  95      *   INDEX_SIZE_ERR: Raised if the specified index is greater than or
  96      *   equal to the number of rows or if the index is a negative number
  97      *   other than -1.
  98      * @version DOM Level 2
  99      */
 100     public void deleteRow(int index)
 101                           throws DOMException;
 102
 103 }