You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
998 lines
25 KiB
998 lines
25 KiB
/*
|
|
* This file is part of the DOM implementation for KDE.
|
|
*
|
|
* (C) 1999 Lars Knoll (knoll@kde.org)
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Library General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2 of the License, or (at your option) any later version.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Library General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Library General Public License
|
|
* along with this library; see the file COPYING.LIB. If not, write to
|
|
* the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
|
|
* Boston, MA 02110-1301, USA.
|
|
*
|
|
* This file includes excerpts from the Document Object Model (DOM)
|
|
* Level 1 Specification (Recommendation)
|
|
* http://www.w3.org/TR/REC-DOM-Level-1/
|
|
* Copyright © World Wide Web Consortium , (Massachusetts Institute of
|
|
* Technology , Institut National de Recherche en Informatique et en
|
|
* Automatique , Keio University ). All Rights Reserved.
|
|
*
|
|
*/
|
|
#ifndef HTML_TABLE_H
|
|
#define HTML_TABLE_H
|
|
|
|
// --------------------------------------------------------------------------
|
|
#include <dom/html_element.h>
|
|
#include <kdelibs_export.h>
|
|
|
|
namespace DOM {
|
|
|
|
class HTMLTableCaptionElementImpl;
|
|
class DOMString;
|
|
|
|
/**
|
|
* Table caption See the <a
|
|
* href="http://www.w3.org/TR/REC-html40/struct/tables.html#edef-CAPTION">
|
|
* CAPTION element definition </a> in HTML 4.0.
|
|
*
|
|
*/
|
|
class KHTML_EXPORT HTMLTableCaptionElement : public HTMLElement
|
|
{
|
|
friend class HTMLTableElement;
|
|
|
|
public:
|
|
HTMLTableCaptionElement();
|
|
HTMLTableCaptionElement(const HTMLTableCaptionElement &other);
|
|
HTMLTableCaptionElement(const Node &other) : HTMLElement()
|
|
{(*this)=other;}
|
|
protected:
|
|
HTMLTableCaptionElement(HTMLTableCaptionElementImpl *impl);
|
|
public:
|
|
|
|
HTMLTableCaptionElement & operator = (const HTMLTableCaptionElement &other);
|
|
HTMLTableCaptionElement & operator = (const Node &other);
|
|
|
|
~HTMLTableCaptionElement();
|
|
|
|
/**
|
|
* Caption alignment with respect to the table. See the <a
|
|
* href="http://www.w3.org/TR/REC-html40/struct/tables.html#adef-align-CAPTION">
|
|
* align attribute definition </a> in HTML 4.0. This attribute is
|
|
* deprecated in HTML 4.0.
|
|
*
|
|
*/
|
|
DOMString align() const;
|
|
|
|
/**
|
|
* see align
|
|
*/
|
|
void setAlign( const DOMString & );
|
|
};
|
|
|
|
// --------------------------------------------------------------------------
|
|
|
|
class HTMLTableCellElementImpl;
|
|
|
|
/**
|
|
* The object used to represent the \c TH and \c TD
|
|
* elements. See the <a
|
|
* href="http://www.w3.org/TR/REC-html40/struct/tables.html#edef-TD">
|
|
* TD element definition </a> in HTML 4.0.
|
|
*
|
|
*/
|
|
class KHTML_EXPORT HTMLTableCellElement : public HTMLElement
|
|
{
|
|
friend class HTMLTableElement;
|
|
|
|
public:
|
|
HTMLTableCellElement();
|
|
HTMLTableCellElement(const HTMLTableCellElement &other);
|
|
HTMLTableCellElement(const Node &other) : HTMLElement()
|
|
{(*this)=other;}
|
|
protected:
|
|
HTMLTableCellElement(HTMLTableCellElementImpl *impl);
|
|
public:
|
|
|
|
HTMLTableCellElement & operator = (const HTMLTableCellElement &other);
|
|
HTMLTableCellElement & operator = (const Node &other);
|
|
|
|
~HTMLTableCellElement();
|
|
|
|
/**
|
|
* The index of this cell in the row.
|
|
*
|
|
*/
|
|
long cellIndex() const;
|
|
|
|
/**
|
|
* see cellIndex
|
|
*
|
|
* This function is obsolete - the cellIndex property is actually supposed to be read-only
|
|
* (http://www.w3.org/DOM/updates/REC-DOM-Level-1-19981001-errata.html)
|
|
*/
|
|
void setCellIndex( long );
|
|
|
|
/**
|
|
* Abbreviation for header cells. See the <a
|
|
* href="http://www.w3.org/TR/REC-html40/struct/tables.html#adef-abbr">
|
|
* abbr attribute definition </a> in HTML 4.0.
|
|
*
|
|
*/
|
|
DOMString abbr() const;
|
|
|
|
/**
|
|
* see abbr
|
|
*/
|
|
void setAbbr( const DOMString & );
|
|
|
|
/**
|
|
* Horizontal alignment of data in cell. See the <a
|
|
* href="http://www.w3.org/TR/REC-html40/struct/tables.html#adef-align-TD">
|
|
* align attribute definition </a> in HTML 4.0.
|
|
*
|
|
*/
|
|
DOMString align() const;
|
|
|
|
/**
|
|
* see align
|
|
*/
|
|
void setAlign( const DOMString & );
|
|
|
|
/**
|
|
* Names group of related headers. See the <a
|
|
* href="http://www.w3.org/TR/REC-html40/struct/tables.html#adef-axis">
|
|
* axis attribute definition </a> in HTML 4.0.
|
|
*
|
|
*/
|
|
DOMString axis() const;
|
|
|
|
/**
|
|
* see axis
|
|
*/
|
|
void setAxis( const DOMString & );
|
|
|
|
/**
|
|
* Cell background color. See the <a
|
|
* href="http://www.w3.org/TR/REC-html40/present/graphics.html#adef-bgcolor">
|
|
* bgcolor attribute definition </a> in HTML 4.0. This attribute
|
|
* is deprecated in HTML 4.0.
|
|
*
|
|
*/
|
|
DOMString bgColor() const;
|
|
|
|
/**
|
|
* see bgColor
|
|
*/
|
|
void setBgColor( const DOMString & );
|
|
|
|
/**
|
|
* Alignment character for cells in a column. See the <a
|
|
* href="http://www.w3.org/TR/REC-html40/struct/tables.html#adef-char">
|
|
* char attribute definition </a> in HTML 4.0.
|
|
*
|
|
*/
|
|
DOMString ch() const;
|
|
|
|
/**
|
|
* see ch
|
|
*/
|
|
void setCh( const DOMString & );
|
|
|
|
/**
|
|
* Offset of alignment character. See the <a
|
|
* href="http://www.w3.org/TR/REC-html40/struct/tables.html#adef-charoff">
|
|
* charoff attribute definition </a> in HTML 4.0.
|
|
*
|
|
*/
|
|
DOMString chOff() const;
|
|
|
|
/**
|
|
* see chOff
|
|
*/
|
|
void setChOff( const DOMString & );
|
|
|
|
/**
|
|
* Number of columns spanned by cell. See the <a
|
|
* href="http://www.w3.org/TR/REC-html40/struct/tables.html#adef-colspan">
|
|
* colspan attribute definition </a> in HTML 4.0.
|
|
*
|
|
*/
|
|
long colSpan() const;
|
|
|
|
/**
|
|
* see colSpan
|
|
*/
|
|
void setColSpan( long );
|
|
|
|
/**
|
|
* List of \c id attribute values for header cells.
|
|
* See the <a
|
|
* href="http://www.w3.org/TR/REC-html40/struct/tables.html#adef-headers">
|
|
* headers attribute definition </a> in HTML 4.0.
|
|
*
|
|
*/
|
|
DOMString headers() const;
|
|
|
|
/**
|
|
* see headers
|
|
*/
|
|
void setHeaders( const DOMString & );
|
|
|
|
/**
|
|
* Cell height. See the <a
|
|
* href="http://www.w3.org/TR/REC-html40/struct/tables.html#adef-height-TH">
|
|
* height attribute definition </a> in HTML 4.0. This attribute is
|
|
* deprecated in HTML 4.0.
|
|
*
|
|
*/
|
|
DOMString height() const;
|
|
|
|
/**
|
|
* see height
|
|
*/
|
|
void setHeight( const DOMString & );
|
|
|
|
/**
|
|
* Suppress word wrapping. See the <a
|
|
* href="http://www.w3.org/TR/REC-html40/struct/tables.html#adef-nowrap">
|
|
* nowrap attribute definition </a> in HTML 4.0. This attribute is
|
|
* deprecated in HTML 4.0.
|
|
*
|
|
*/
|
|
bool noWrap() const;
|
|
|
|
/**
|
|
* see noWrap
|
|
*/
|
|
void setNoWrap( bool );
|
|
|
|
/**
|
|
* Number of rows spanned by cell. See the <a
|
|
* href="http://www.w3.org/TR/REC-html40/struct/tables.html#adef-rowspan">
|
|
* rowspan attribute definition </a> in HTML 4.0.
|
|
*
|
|
*/
|
|
long rowSpan() const;
|
|
|
|
/**
|
|
* see rowSpan
|
|
*/
|
|
void setRowSpan( long );
|
|
|
|
/**
|
|
* Scope covered by header cells. See the <a
|
|
* href="http://www.w3.org/TR/REC-html40/struct/tables.html#adef-scope">
|
|
* scope attribute definition </a> in HTML 4.0.
|
|
*
|
|
*/
|
|
DOMString scope() const;
|
|
|
|
/**
|
|
* see scope
|
|
*/
|
|
void setScope( const DOMString & );
|
|
|
|
/**
|
|
* Vertical alignment of data in cell. See the <a
|
|
* href="http://www.w3.org/TR/REC-html40/struct/tables.html#adef-valign">
|
|
* valign attribute definition </a> in HTML 4.0.
|
|
*
|
|
*/
|
|
DOMString vAlign() const;
|
|
|
|
/**
|
|
* see vAlign
|
|
*/
|
|
void setVAlign( const DOMString & );
|
|
|
|
/**
|
|
* Cell width. See the <a
|
|
* href="http://www.w3.org/TR/REC-html40/struct/tables.html#adef-width-TH">
|
|
* width attribute definition </a> in HTML 4.0. This attribute is
|
|
* deprecated in HTML 4.0.
|
|
*
|
|
*/
|
|
DOMString width() const;
|
|
|
|
/**
|
|
* see width
|
|
*/
|
|
void setWidth( const DOMString & );
|
|
};
|
|
|
|
// --------------------------------------------------------------------------
|
|
|
|
class HTMLTableColElementImpl;
|
|
|
|
/**
|
|
* Regroups the \c COL and \c COLGROUP
|
|
* elements. See the <a
|
|
* href="http://www.w3.org/TR/REC-html40/struct/tables.html#edef-COL">
|
|
* COL element definition </a> in HTML 4.0.
|
|
*
|
|
*/
|
|
class KHTML_EXPORT HTMLTableColElement : public HTMLElement
|
|
{
|
|
friend class HTMLTableElement;
|
|
|
|
public:
|
|
HTMLTableColElement();
|
|
HTMLTableColElement(const HTMLTableColElement &other);
|
|
HTMLTableColElement(const Node &other) : HTMLElement()
|
|
{(*this)=other;}
|
|
protected:
|
|
HTMLTableColElement(HTMLTableColElementImpl *impl);
|
|
public:
|
|
|
|
HTMLTableColElement & operator = (const HTMLTableColElement &other);
|
|
HTMLTableColElement & operator = (const Node &other);
|
|
|
|
~HTMLTableColElement();
|
|
|
|
/**
|
|
* Horizontal alignment of cell data in column. See the <a
|
|
* href="http://www.w3.org/TR/REC-html40/struct/tables.html#adef-align-TD">
|
|
* align attribute definition </a> in HTML 4.0.
|
|
*
|
|
*/
|
|
DOMString align() const;
|
|
|
|
/**
|
|
* see align
|
|
*/
|
|
void setAlign( const DOMString & );
|
|
|
|
/**
|
|
* Alignment character for cells in a column. See the <a
|
|
* href="http://www.w3.org/TR/REC-html40/struct/tables.html#adef-char">
|
|
* char attribute definition </a> in HTML 4.0.
|
|
*
|
|
*/
|
|
DOMString ch() const;
|
|
|
|
/**
|
|
* see ch
|
|
*/
|
|
void setCh( const DOMString & );
|
|
|
|
/**
|
|
* Offset of alignment character. See the <a
|
|
* href="http://www.w3.org/TR/REC-html40/struct/tables.html#adef-charoff">
|
|
* charoff attribute definition </a> in HTML 4.0.
|
|
*
|
|
*/
|
|
DOMString chOff() const;
|
|
|
|
/**
|
|
* see chOff
|
|
*/
|
|
void setChOff( const DOMString & );
|
|
|
|
/**
|
|
* Indicates the number of columns in a group or affected by a
|
|
* grouping. See the <a
|
|
* href="http://www.w3.org/TR/REC-html40/struct/tables.html#adef-span-COL">
|
|
* span attribute definition </a> in HTML 4.0.
|
|
*
|
|
*/
|
|
long span() const;
|
|
|
|
/**
|
|
* see span
|
|
*/
|
|
void setSpan( long );
|
|
|
|
/**
|
|
* Vertical alignment of cell data in column. See the <a
|
|
* href="http://www.w3.org/TR/REC-html40/struct/tables.html#adef-valign">
|
|
* valign attribute definition </a> in HTML 4.0.
|
|
*
|
|
*/
|
|
DOMString vAlign() const;
|
|
|
|
/**
|
|
* see vAlign
|
|
*/
|
|
void setVAlign( const DOMString & );
|
|
|
|
/**
|
|
* Default column width. See the <a
|
|
* href="http://www.w3.org/TR/REC-html40/struct/tables.html#adef-width-COL">
|
|
* width attribute definition </a> in HTML 4.0.
|
|
*
|
|
*/
|
|
DOMString width() const;
|
|
|
|
/**
|
|
* see width
|
|
*/
|
|
void setWidth( const DOMString & );
|
|
};
|
|
|
|
// --------------------------------------------------------------------------
|
|
|
|
class HTMLTableElementImpl;
|
|
class HTMLCollection;
|
|
class HTMLTableSectionElement;
|
|
class HTMLTableCaptionElement;
|
|
class HTMLElement;
|
|
class DOMString;
|
|
|
|
/**
|
|
* 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 \c CAPTION , \c THEAD , and
|
|
* \c 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 <a
|
|
* href="http://www.w3.org/TR/REC-html40/struct/tables.html#edef-TABLE">
|
|
* TABLE element definition </a> in HTML 4.0.
|
|
*
|
|
*/
|
|
class KHTML_EXPORT HTMLTableElement : public HTMLElement
|
|
{
|
|
public:
|
|
HTMLTableElement();
|
|
HTMLTableElement(const HTMLTableElement &other);
|
|
HTMLTableElement(const Node &other) : HTMLElement()
|
|
{(*this)=other;}
|
|
|
|
protected:
|
|
HTMLTableElement(HTMLTableElementImpl *impl);
|
|
public:
|
|
|
|
HTMLTableElement & operator = (const HTMLTableElement &other);
|
|
HTMLTableElement & operator = (const Node &other);
|
|
|
|
~HTMLTableElement();
|
|
|
|
/**
|
|
* Returns the table's \c CAPTION , or void if none
|
|
* exists.
|
|
*
|
|
*/
|
|
HTMLTableCaptionElement caption() const;
|
|
|
|
/**
|
|
* see caption
|
|
*/
|
|
void setCaption( const HTMLTableCaptionElement & );
|
|
|
|
/**
|
|
* Returns the table's \c THEAD , or \c null
|
|
* if none exists.
|
|
*
|
|
*/
|
|
HTMLTableSectionElement tHead() const;
|
|
|
|
/**
|
|
* see tHead
|
|
*/
|
|
void setTHead( const HTMLTableSectionElement & );
|
|
|
|
/**
|
|
* Returns the table's \c TFOOT , or \c null
|
|
* if none exists.
|
|
*
|
|
*/
|
|
HTMLTableSectionElement tFoot() const;
|
|
|
|
/**
|
|
* see tFoot
|
|
*/
|
|
void setTFoot( const HTMLTableSectionElement & );
|
|
|
|
/**
|
|
* Returns a collection of all the rows in the table, including
|
|
* all in \c THEAD , \c TFOOT , all
|
|
* \c TBODY elements.
|
|
*
|
|
*/
|
|
HTMLCollection rows() const;
|
|
|
|
/**
|
|
* Returns a collection of the table bodies (including implicit ones).
|
|
*
|
|
*/
|
|
HTMLCollection tBodies() const;
|
|
|
|
/**
|
|
* Specifies the table's position with respect to the rest of the
|
|
* document. See the <a
|
|
* href="http://www.w3.org/TR/REC-html40/struct/tables.html#adef-align-TABLE">
|
|
* align attribute definition </a> in HTML 4.0. This attribute is
|
|
* deprecated in HTML 4.0.
|
|
*
|
|
*/
|
|
DOMString align() const;
|
|
|
|
/**
|
|
* see align
|
|
*/
|
|
void setAlign( const DOMString & );
|
|
|
|
/**
|
|
* Cell background color. See the <a
|
|
* href="http://www.w3.org/TR/REC-html40/present/graphics.html#adef-bgcolor">
|
|
* bgcolor attribute definition </a> in HTML 4.0. This attribute
|
|
* is deprecated in HTML 4.0.
|
|
*
|
|
*/
|
|
DOMString bgColor() const;
|
|
|
|
/**
|
|
* see bgColor
|
|
*/
|
|
void setBgColor( const DOMString & );
|
|
|
|
/**
|
|
* The width of the border around the table. See the <a
|
|
* href="http://www.w3.org/TR/REC-html40/struct/tables.html#adef-border-TABLE">
|
|
* border attribute definition </a> in HTML 4.0.
|
|
*
|
|
*/
|
|
DOMString border() const;
|
|
|
|
/**
|
|
* see border
|
|
*/
|
|
void setBorder( const DOMString & );
|
|
|
|
/**
|
|
* Specifies the horizontal and vertical space between cell
|
|
* content and cell borders. See the <a
|
|
* href="http://www.w3.org/TR/REC-html40/struct/tables.html#adef-cellpadding">
|
|
* cellpadding attribute definition </a> in HTML 4.0.
|
|
*
|
|
*/
|
|
DOMString cellPadding() const;
|
|
|
|
/**
|
|
* see cellPadding
|
|
*/
|
|
void setCellPadding( const DOMString & );
|
|
|
|
/**
|
|
* Specifies the horizontal and vertical separation between cells.
|
|
* See the <a
|
|
* href="http://www.w3.org/TR/REC-html40/struct/tables.html#adef-cellspacing">
|
|
* cellspacing attribute definition </a> in HTML 4.0.
|
|
*
|
|
*/
|
|
DOMString cellSpacing() const;
|
|
|
|
/**
|
|
* see cellSpacing
|
|
*/
|
|
void setCellSpacing( const DOMString & );
|
|
|
|
/**
|
|
* Specifies which external table borders to render. See the <a
|
|
* href="http://www.w3.org/TR/REC-html40/struct/tables.html#adef-frame">
|
|
* frame attribute definition </a> in HTML 4.0.
|
|
*
|
|
*/
|
|
DOMString frame() const;
|
|
|
|
/**
|
|
* see frame
|
|
*/
|
|
void setFrame( const DOMString & );
|
|
|
|
/**
|
|
* Specifies which internal table borders to render. See the <a
|
|
* href="http://www.w3.org/TR/REC-html40/struct/tables.html#adef-rules">
|
|
* rules attribute definition </a> in HTML 4.0.
|
|
*
|
|
*/
|
|
DOMString rules() const;
|
|
|
|
/**
|
|
* see rules
|
|
*/
|
|
void setRules( const DOMString & );
|
|
|
|
/**
|
|
* Supplementary description about the purpose or structure of a
|
|
* table. See the <a
|
|
* href="http://www.w3.org/TR/REC-html40/struct/tables.html#adef-summary">
|
|
* summary attribute definition </a> in HTML 4.0.
|
|
*
|
|
*/
|
|
DOMString summary() const;
|
|
|
|
/**
|
|
* see summary
|
|
*/
|
|
void setSummary( const DOMString & );
|
|
|
|
/**
|
|
* Specifies the desired table width. See the <a
|
|
* href="http://www.w3.org/TR/REC-html40/struct/tables.html#adef-width-TABLE">
|
|
* width attribute definition </a> in HTML 4.0.
|
|
*
|
|
*/
|
|
DOMString width() const;
|
|
|
|
/**
|
|
* see width
|
|
*/
|
|
void setWidth( const DOMString & );
|
|
|
|
/**
|
|
* Create a table header row or return an existing one.
|
|
*
|
|
* @return A new table header element ( \c THEAD ).
|
|
*
|
|
*/
|
|
HTMLElement createTHead ( );
|
|
|
|
/**
|
|
* Delete the header from the table, if one exists.
|
|
*
|
|
* @return
|
|
*
|
|
*/
|
|
void deleteTHead ( );
|
|
|
|
/**
|
|
* Create a table footer row or return an existing one.
|
|
*
|
|
* @return A footer element ( \c TFOOT ).
|
|
*
|
|
*/
|
|
HTMLElement createTFoot ( );
|
|
|
|
/**
|
|
* Delete the footer from the table, if one exists.
|
|
*
|
|
* @return
|
|
*
|
|
*/
|
|
void deleteTFoot ( );
|
|
|
|
/**
|
|
* Create a new table caption object or return an existing one.
|
|
*
|
|
* @return A \c CAPTION element.
|
|
*
|
|
*/
|
|
HTMLElement createCaption ( );
|
|
|
|
/**
|
|
* Delete the table caption, if one exists.
|
|
*
|
|
* @return
|
|
*
|
|
*/
|
|
void deleteCaption ( );
|
|
|
|
/**
|
|
* Insert a new empty row in the table.
|
|
* The new row is inserted immediately before and in the same section
|
|
* as the current indexth row in the table. If index is -1 or 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.
|
|
* The index starts from 0 and is relative to the logical order
|
|
* (not document order) of all the rows contained inside the table.
|
|
*
|
|
* @return The newly created row.
|
|
*
|
|
*/
|
|
HTMLElement insertRow ( long index );
|
|
|
|
/**
|
|
* Delete a table row.
|
|
*
|
|
* @param index The index of the row to be deleted.
|
|
* This index starts from 0 and is relative to the logical order
|
|
* (not document order) of all the rows contained inside the table.
|
|
* If the index is -1 the last row in the table is deleted.
|
|
*
|
|
* @return
|
|
*
|
|
*/
|
|
void deleteRow ( long index );
|
|
};
|
|
|
|
// --------------------------------------------------------------------------
|
|
|
|
class HTMLTableRowElementImpl;
|
|
class HTMLCollection;
|
|
class HTMLElement;
|
|
class DOMString;
|
|
|
|
/**
|
|
* A row in a table. See the <a
|
|
* href="http://www.w3.org/TR/REC-html40/struct/tables.html#edef-TR">
|
|
* TR element definition </a> in HTML 4.0.
|
|
*
|
|
*/
|
|
class KHTML_EXPORT HTMLTableRowElement : public HTMLElement
|
|
{
|
|
friend class HTMLTableElement;
|
|
|
|
public:
|
|
HTMLTableRowElement();
|
|
HTMLTableRowElement(const HTMLTableRowElement &other);
|
|
HTMLTableRowElement(const Node &other) : HTMLElement()
|
|
{(*this)=other;}
|
|
|
|
protected:
|
|
HTMLTableRowElement(HTMLTableRowElementImpl *impl);
|
|
public:
|
|
|
|
HTMLTableRowElement & operator = (const HTMLTableRowElement &other);
|
|
HTMLTableRowElement & operator = (const Node &other);
|
|
|
|
~HTMLTableRowElement();
|
|
|
|
/**
|
|
* The index of this row, relative to the entire table.
|
|
* This is in logical order and not in document order.
|
|
* The rowIndex does take into account sections
|
|
* (THEAD, TFOOT or TBODY) within the table,
|
|
* placing THEAD rows first in the index, followed by
|
|
* TBODY rows, followed by TFOOT rows.
|
|
*/
|
|
long rowIndex() const;
|
|
|
|
/**
|
|
* see rowIndex
|
|
*
|
|
* This function is obsolete - the rowIndex property is actually supposed to be read-only
|
|
* (http://www.w3.org/DOM/updates/REC-DOM-Level-1-19981001-errata.html)
|
|
*/
|
|
void setRowIndex( long );
|
|
|
|
/**
|
|
* The index of this row, relative to the current section (
|
|
* \c THEAD , \c TFOOT , or \c TBODY
|
|
* ).
|
|
*
|
|
*/
|
|
long sectionRowIndex() const;
|
|
|
|
/**
|
|
* see sectionRowIndex
|
|
*
|
|
* This function is obsolete - the sectionRowIndex property is actually supposed to be read-only
|
|
* (http://www.w3.org/DOM/updates/REC-DOM-Level-1-19981001-errata.html)
|
|
*/
|
|
void setSectionRowIndex( long );
|
|
|
|
/**
|
|
* The collection of cells in this row.
|
|
*
|
|
*/
|
|
HTMLCollection cells() const;
|
|
|
|
/**
|
|
* see cells
|
|
*
|
|
* This function is obsolete - the cells property is actually supposed to be read-only
|
|
* (http://www.w3.org/DOM/updates/REC-DOM-Level-1-19981001-errata.html)
|
|
*/
|
|
void setCells( const HTMLCollection & );
|
|
|
|
/**
|
|
* Horizontal alignment of data within cells of this row. See the
|
|
* <a
|
|
* href="http://www.w3.org/TR/REC-html40/struct/tables.html#adef-align-TD">
|
|
* align attribute definition </a> in HTML 4.0.
|
|
*
|
|
*/
|
|
DOMString align() const;
|
|
|
|
/**
|
|
* see align
|
|
*/
|
|
void setAlign( const DOMString & );
|
|
|
|
/**
|
|
* Background color for rows. See the <a
|
|
* href="http://www.w3.org/TR/REC-html40/present/graphics.html#adef-bgcolor">
|
|
* bgcolor attribute definition </a> in HTML 4.0. This attribute
|
|
* is deprecated in HTML 4.0.
|
|
*
|
|
*/
|
|
DOMString bgColor() const;
|
|
|
|
/**
|
|
* see bgColor
|
|
*/
|
|
void setBgColor( const DOMString & );
|
|
|
|
/**
|
|
* Alignment character for cells in a column. See the <a
|
|
* href="http://www.w3.org/TR/REC-html40/struct/tables.html#adef-char">
|
|
* char attribute definition </a> in HTML 4.0.
|
|
*
|
|
*/
|
|
DOMString ch() const;
|
|
|
|
/**
|
|
* see ch
|
|
*/
|
|
void setCh( const DOMString & );
|
|
|
|
/**
|
|
* Offset of alignment character. See the <a
|
|
* href="http://www.w3.org/TR/REC-html40/struct/tables.html#adef-charoff">
|
|
* charoff attribute definition </a> in HTML 4.0.
|
|
*
|
|
*/
|
|
DOMString chOff() const;
|
|
|
|
/**
|
|
* see chOff
|
|
*/
|
|
void setChOff( const DOMString & );
|
|
|
|
/**
|
|
* Vertical alignment of data within cells of this row. See the <a
|
|
* href="http://www.w3.org/TR/REC-html40/struct/tables.html#adef-valign">
|
|
* valign attribute definition </a> in HTML 4.0.
|
|
*
|
|
*/
|
|
DOMString vAlign() const;
|
|
|
|
/**
|
|
* see vAlign
|
|
*/
|
|
void setVAlign( const DOMString & );
|
|
|
|
/**
|
|
* Insert an empty \c TD cell into this row.
|
|
* If index is -1 or equal to the number of cells, the new
|
|
* cell is appended.
|
|
*
|
|
* @param index The place to insert the cell.
|
|
*
|
|
* @return The newly created cell.
|
|
*
|
|
*/
|
|
HTMLElement insertCell ( long index );
|
|
|
|
/**
|
|
* Delete a cell from the current row.
|
|
*
|
|
* @param index The index of the cell to delete, starting from 0.
|
|
* If the index is -1 the last cell in the row is deleted.
|
|
*
|
|
* @return
|
|
*
|
|
*/
|
|
void deleteCell ( long index );
|
|
};
|
|
|
|
// --------------------------------------------------------------------------
|
|
|
|
class HTMLTableSectionElementImpl;
|
|
class HTMLCollection;
|
|
class HTMLElement;
|
|
class DOMString;
|
|
|
|
/**
|
|
* The \c THEAD , \c TFOOT , and \c TBODY
|
|
* elements.
|
|
*
|
|
*/
|
|
class KHTML_EXPORT HTMLTableSectionElement : public HTMLElement
|
|
{
|
|
friend class HTMLTableElement;
|
|
|
|
public:
|
|
HTMLTableSectionElement();
|
|
HTMLTableSectionElement(const HTMLTableSectionElement &other);
|
|
HTMLTableSectionElement(const Node &other) : HTMLElement()
|
|
{(*this)=other;}
|
|
|
|
|
|
protected:
|
|
HTMLTableSectionElement(HTMLTableSectionElementImpl *impl);
|
|
public:
|
|
|
|
HTMLTableSectionElement & operator = (const HTMLTableSectionElement &other);
|
|
HTMLTableSectionElement & operator = (const Node &other);
|
|
|
|
~HTMLTableSectionElement();
|
|
|
|
/**
|
|
* Horizontal alignment of data in cells. See the \c align
|
|
* attribute for HTMLTheadElement for details.
|
|
*
|
|
*/
|
|
DOMString align() const;
|
|
|
|
/**
|
|
* see align
|
|
*/
|
|
void setAlign( const DOMString & );
|
|
|
|
/**
|
|
* Alignment character for cells in a column. See the <a
|
|
* href="http://www.w3.org/TR/REC-html40/struct/tables.html#adef-char">
|
|
* char attribute definition </a> in HTML 4.0.
|
|
*
|
|
*/
|
|
DOMString ch() const;
|
|
|
|
/**
|
|
* see ch
|
|
*/
|
|
void setCh( const DOMString & );
|
|
|
|
/**
|
|
* Offset of alignment character. See the <a
|
|
* href="http://www.w3.org/TR/REC-html40/struct/tables.html#adef-charoff">
|
|
* charoff attribute definition </a> in HTML 4.0.
|
|
*
|
|
*/
|
|
DOMString chOff() const;
|
|
|
|
/**
|
|
* see chOff
|
|
*/
|
|
void setChOff( const DOMString & );
|
|
|
|
/**
|
|
* Vertical alignment of data in cells. See the \c valign
|
|
* attribute for HTMLTheadElement for details.
|
|
*
|
|
*/
|
|
DOMString vAlign() const;
|
|
|
|
/**
|
|
* see vAlign
|
|
*/
|
|
void setVAlign( const DOMString & );
|
|
|
|
/**
|
|
* The collection of rows in this table section.
|
|
*
|
|
*/
|
|
HTMLCollection rows() const;
|
|
|
|
/**
|
|
* Insert a row into this section.
|
|
* The new row is inserted immediately before the current indexth
|
|
* row in this section. If index is -1 or equal to the number of rows
|
|
* in this sectino, the new row is appended.
|
|
*
|
|
* @param index The row number where to insert a new row.
|
|
*
|
|
* @return The newly created row.
|
|
*
|
|
*/
|
|
HTMLElement insertRow ( long index );
|
|
|
|
/**
|
|
* Delete a row from this section.
|
|
*
|
|
* @param index The index of the row to be deleted,
|
|
* or -1 to delete the last row. This index starts from 0 and is relative only
|
|
* to the rows contained inside this section, not all the rows in the table.
|
|
*
|
|
*/
|
|
void deleteRow ( long index );
|
|
};
|
|
|
|
} //namespace
|
|
|
|
#endif
|