.TH "DOM::HTMLTableElement" kde3 "11 Jun 2005" "Version Version 3.4.1" "khtml Library" \" -*- nroff -*-
.ad l
.nh
.SH NAME
DOM::HTMLTableElement \- The create* and delete* methods on the table allow authors to construct and modify tables.  

.PP
.SH SYNOPSIS
.br
.PP
\fC#include <html_table.h>\fP
.PP
Inherits \fBDOM::HTMLElement\fP.
.PP
.SS "Public Member Functions"

.in +1c
.ti -1c
.RI "\fBHTMLTableElement\fP (const \fBHTMLTableElement\fP &other)"
.br
.ti -1c
.RI "\fBHTMLTableElement\fP (const \fBNode\fP &other)"
.br
.ti -1c
.RI "\fBHTMLTableElement\fP & \fBoperator=\fP (const \fBHTMLTableElement\fP &other)"
.br
.ti -1c
.RI "\fBHTMLTableElement\fP & \fBoperator=\fP (const \fBNode\fP &other)"
.br
.ti -1c
.RI "\fBHTMLTableCaptionElement\fP \fBcaption\fP () const "
.br
.ti -1c
.RI "void \fBsetCaption\fP (const \fBHTMLTableCaptionElement\fP &)"
.br
.ti -1c
.RI "\fBHTMLTableSectionElement\fP \fBtHead\fP () const "
.br
.ti -1c
.RI "void \fBsetTHead\fP (const \fBHTMLTableSectionElement\fP &)"
.br
.ti -1c
.RI "\fBHTMLTableSectionElement\fP \fBtFoot\fP () const "
.br
.ti -1c
.RI "void \fBsetTFoot\fP (const \fBHTMLTableSectionElement\fP &)"
.br
.ti -1c
.RI "\fBHTMLCollection\fP \fBrows\fP () const "
.br
.ti -1c
.RI "\fBHTMLCollection\fP \fBtBodies\fP () const "
.br
.ti -1c
.RI "\fBDOMString\fP \fBalign\fP () const "
.br
.ti -1c
.RI "void \fBsetAlign\fP (const \fBDOMString\fP &)"
.br
.ti -1c
.RI "\fBDOMString\fP \fBbgColor\fP () const "
.br
.ti -1c
.RI "void \fBsetBgColor\fP (const \fBDOMString\fP &)"
.br
.ti -1c
.RI "\fBDOMString\fP \fBborder\fP () const "
.br
.ti -1c
.RI "void \fBsetBorder\fP (const \fBDOMString\fP &)"
.br
.ti -1c
.RI "\fBDOMString\fP \fBcellPadding\fP () const "
.br
.ti -1c
.RI "void \fBsetCellPadding\fP (const \fBDOMString\fP &)"
.br
.ti -1c
.RI "\fBDOMString\fP \fBcellSpacing\fP () const "
.br
.ti -1c
.RI "void \fBsetCellSpacing\fP (const \fBDOMString\fP &)"
.br
.ti -1c
.RI "\fBDOMString\fP \fBframe\fP () const "
.br
.ti -1c
.RI "void \fBsetFrame\fP (const \fBDOMString\fP &)"
.br
.ti -1c
.RI "\fBDOMString\fP \fBrules\fP () const "
.br
.ti -1c
.RI "void \fBsetRules\fP (const \fBDOMString\fP &)"
.br
.ti -1c
.RI "\fBDOMString\fP \fBsummary\fP () const "
.br
.ti -1c
.RI "void \fBsetSummary\fP (const \fBDOMString\fP &)"
.br
.ti -1c
.RI "\fBDOMString\fP \fBwidth\fP () const "
.br
.ti -1c
.RI "void \fBsetWidth\fP (const \fBDOMString\fP &)"
.br
.ti -1c
.RI "\fBHTMLElement\fP \fBcreateTHead\fP ()"
.br
.ti -1c
.RI "void \fBdeleteTHead\fP ()"
.br
.ti -1c
.RI "\fBHTMLElement\fP \fBcreateTFoot\fP ()"
.br
.ti -1c
.RI "void \fBdeleteTFoot\fP ()"
.br
.ti -1c
.RI "\fBHTMLElement\fP \fBcreateCaption\fP ()"
.br
.ti -1c
.RI "void \fBdeleteCaption\fP ()"
.br
.ti -1c
.RI "\fBHTMLElement\fP \fBinsertRow\fP (long index)"
.br
.ti -1c
.RI "void \fBdeleteRow\fP (long index)"
.br
.in -1c
.SS "Protected Member Functions"

.in +1c
.ti -1c
.RI "\fBHTMLTableElement\fP (HTMLTableElementImpl *impl)"
.br
.in -1c
.SH "Detailed Description"
.PP 
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 \fCCAPTION\fP , \fCTHEAD\fP , and \fCTFOOT\fP elements may exist in a table. Therefore, if one exists, and the \fBcreateTHead()\fP or \fBcreateTFoot()\fP method is called, the method returns the existing THead or TFoot element. See the \fCTABLE element definition \fP in HTML 4.0. 
.PP
Definition at line 441 of file html_table.h.
.SH "Member Function Documentation"
.PP 
.SS "\fBHTMLTableCaptionElement\fP HTMLTableElement::caption () const"
.PP
Returns the table's \fCCAPTION\fP , or void if none exists. 
.PP
Definition at line 418 of file html_table.cpp.
.SS "void HTMLTableElement::setCaption (const \fBHTMLTableCaptionElement\fP &)"
.PP
see caption 
.PP
Definition at line 424 of file html_table.cpp.
.SS "\fBHTMLTableSectionElement\fP HTMLTableElement::tHead () const"
.PP
Returns the table's \fCTHEAD\fP , or \fCnull\fP if none exists. 
.PP
Definition at line 431 of file html_table.cpp.
.SS "void HTMLTableElement::setTHead (const \fBHTMLTableSectionElement\fP &)"
.PP
see tHead 
.PP
Definition at line 437 of file html_table.cpp.
.SS "\fBHTMLTableSectionElement\fP HTMLTableElement::tFoot () const"
.PP
Returns the table's \fCTFOOT\fP , or \fCnull\fP if none exists. 
.PP
Definition at line 445 of file html_table.cpp.
.SS "void HTMLTableElement::setTFoot (const \fBHTMLTableSectionElement\fP &)"
.PP
see tFoot 
.PP
Definition at line 451 of file html_table.cpp.
.SS "\fBHTMLCollection\fP HTMLTableElement::rows () const"
.PP
Returns a collection of all the rows in the table, including all in \fCTHEAD\fP , \fCTFOOT\fP , all \fCTBODY\fP elements. 
.PP
Definition at line 459 of file html_table.cpp.
.SS "\fBHTMLCollection\fP HTMLTableElement::tBodies () const"
.PP
Returns a collection of the table bodies (including implicit ones). 
.PP
Definition at line 465 of file html_table.cpp.
.SS "\fBDOMString\fP HTMLTableElement::align () const"
.PP
Specifies the table's position with respect to the rest of the document. 
.PP
See the \fCalign attribute definition \fP in HTML 4.0. This attribute is deprecated in HTML 4.0. 
.PP
Definition at line 471 of file html_table.cpp.
.SS "void HTMLTableElement::setAlign (const \fBDOMString\fP &)"
.PP
see align 
.PP
Definition at line 477 of file html_table.cpp.
.SS "\fBDOMString\fP HTMLTableElement::bgColor () const"
.PP
Cell background color. 
.PP
See the \fCbgcolor attribute definition \fP in HTML 4.0. This attribute is deprecated in HTML 4.0. 
.PP
Definition at line 482 of file html_table.cpp.
.SS "void HTMLTableElement::setBgColor (const \fBDOMString\fP &)"
.PP
see bgColor 
.PP
Definition at line 488 of file html_table.cpp.
.SS "\fBDOMString\fP HTMLTableElement::border () const"
.PP
The width of the border around the table. 
.PP
See the \fCborder attribute definition \fP in HTML 4.0. 
.PP
Definition at line 493 of file html_table.cpp.
.SS "void HTMLTableElement::setBorder (const \fBDOMString\fP &)"
.PP
see border 
.PP
Definition at line 499 of file html_table.cpp.
.SS "\fBDOMString\fP HTMLTableElement::cellPadding () const"
.PP
Specifies the horizontal and vertical space between cell content and cell borders. 
.PP
See the \fCcellpadding attribute definition \fP in HTML 4.0. 
.PP
Definition at line 504 of file html_table.cpp.
.SS "void HTMLTableElement::setCellPadding (const \fBDOMString\fP &)"
.PP
see cellPadding 
.PP
Definition at line 510 of file html_table.cpp.
.SS "\fBDOMString\fP HTMLTableElement::cellSpacing () const"
.PP
Specifies the horizontal and vertical separation between cells. 
.PP
See the \fCcellspacing attribute definition \fP in HTML 4.0. 
.PP
Definition at line 515 of file html_table.cpp.
.SS "void HTMLTableElement::setCellSpacing (const \fBDOMString\fP &)"
.PP
see cellSpacing 
.PP
Definition at line 521 of file html_table.cpp.
.SS "\fBDOMString\fP HTMLTableElement::frame () const"
.PP
Specifies which external table borders to render. 
.PP
See the \fCframe attribute definition \fP in HTML 4.0. 
.PP
Definition at line 526 of file html_table.cpp.
.SS "void HTMLTableElement::setFrame (const \fBDOMString\fP &)"
.PP
see frame 
.PP
Definition at line 532 of file html_table.cpp.
.SS "\fBDOMString\fP HTMLTableElement::rules () const"
.PP
Specifies which internal table borders to render. 
.PP
See the \fCrules attribute definition \fP in HTML 4.0. 
.PP
Definition at line 537 of file html_table.cpp.
.SS "void HTMLTableElement::setRules (const \fBDOMString\fP &)"
.PP
see rules 
.PP
Definition at line 543 of file html_table.cpp.
.SS "\fBDOMString\fP HTMLTableElement::summary () const"
.PP
Supplementary description about the purpose or structure of a table. 
.PP
See the \fCsummary attribute definition \fP in HTML 4.0. 
.PP
Definition at line 548 of file html_table.cpp.
.SS "void HTMLTableElement::setSummary (const \fBDOMString\fP &)"
.PP
see summary 
.PP
Definition at line 554 of file html_table.cpp.
.SS "\fBDOMString\fP HTMLTableElement::width () const"
.PP
Specifies the desired table width. 
.PP
See the \fCwidth attribute definition \fP in HTML 4.0. 
.PP
Definition at line 559 of file html_table.cpp.
.SS "void HTMLTableElement::setWidth (const \fBDOMString\fP &)"
.PP
see width 
.PP
Definition at line 565 of file html_table.cpp.
.SS "\fBHTMLElement\fP HTMLTableElement::createTHead ()"
.PP
Create a table header row or return an existing one. 
.PP
\fBReturns:\fP
.RS 4
A new table header element ( \fCTHEAD\fP ). 
.RE
.PP

.PP
Definition at line 570 of file html_table.cpp.
.SS "void HTMLTableElement::deleteTHead ()"
.PP
Delete the header from the table, if one exists. 
.PP
\fBReturns:\fP
.RS 4
.RE
.PP

.PP
Definition at line 576 of file html_table.cpp.
.SS "\fBHTMLElement\fP HTMLTableElement::createTFoot ()"
.PP
Create a table footer row or return an existing one. 
.PP
\fBReturns:\fP
.RS 4
A footer element ( \fCTFOOT\fP ). 
.RE
.PP

.PP
Definition at line 582 of file html_table.cpp.
.SS "void HTMLTableElement::deleteTFoot ()"
.PP
Delete the footer from the table, if one exists. 
.PP
\fBReturns:\fP
.RS 4
.RE
.PP

.PP
Definition at line 588 of file html_table.cpp.
.SS "\fBHTMLElement\fP HTMLTableElement::createCaption ()"
.PP
Create a new table caption object or return an existing one. 
.PP
\fBReturns:\fP
.RS 4
A \fCCAPTION\fP element. 
.RE
.PP

.PP
Definition at line 594 of file html_table.cpp.
.SS "void HTMLTableElement::deleteCaption ()"
.PP
Delete the table caption, if one exists. 
.PP
\fBReturns:\fP
.RS 4
.RE
.PP

.PP
Definition at line 600 of file html_table.cpp.
.SS "\fBHTMLElement\fP HTMLTableElement::insertRow (long index)"
.PP
Insert a new empty row in the table. 
.PP
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.
.PP
\fBParameters:\fP
.RS 4
\fIindex\fP 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.
.RE
.PP
\fBReturns:\fP
.RS 4
The newly created row. 
.RE
.PP

.PP
Definition at line 606 of file html_table.cpp.
.SS "void HTMLTableElement::deleteRow (long index)"
.PP
Delete a table row. 
.PP
\fBParameters:\fP
.RS 4
\fIindex\fP 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.
.RE
.PP
\fBReturns:\fP
.RS 4
.RE
.PP

.PP
Definition at line 616 of file html_table.cpp.

.SH "Author"
.PP 
Generated automatically by Doxygen for khtml Library from the source code.
