Table editing functions

Table functions add and remove table rows and columns, change column widths and row heights, convert measurements from pixels to percents and back, and perform other standard table-editing tasks.

dom.convertWidthsToPercent()

Availability

Dreamweaver 3.

Description

This function converts all WIDTH attributes in the current table from pixels to percentages.

Arguments

None.

Returns

Nothing.

dom.convertWidthsToPixels()

Availability

Dreamweaver 4.

Description

This function converts all WIDTH attributes in the current table from percentages to pixels.

Arguments

None.

Returns

Nothing.

dom.decreaseColspan()

Availability

Dreamweaver 3.

Description

This function decreases the column span by one.

Arguments

None.

Returns

Nothing.

Enabler

See "dom.canDecreaseColspan()" on page 1058.

dom.decreaseRowspan()

Availability

Dreamweaver 3.

Description

This function decreases the row span by one.

Arguments

None.

Returns

Nothing.

Enabler

See "dom.canDecreaseRowspan()" on page 1059.

dom.deleteTableColumn()

Availability

Dreamweaver 3.

Description

This function removes the selected table column or columns.

Arguments

None.

Returns

Nothing.

Enabler

See "dom.canDeleteTableColumn()" on page 1059.

dom.deleteTableRow()

Availability

Dreamweaver 3.

Description

This function removes the selected table row or rows.

Arguments

None.

Returns

Nothing.

Enabler

See "dom.canDeleteTableRow()" on page 1060.

dom.doDeferredTableUpdate()

Availability

Dreamweaver 3.

Description

If the Faster Table Editing option is selected in the General preferences, this function forces the table layout to reflect recent changes without moving the selection outside the table. This function has no effect if the Faster Table Editing option is not selected.

Arguments

None.

Returns

Nothing.

dom.getShowTableWidths()

Availability

Dreamweaver MX 2004.

Description

Returns whether table widths appear in standard or expanded tables mode (non-Layout mode). For information on whether Dreamweaver displays table tabs in Layout mode, see "dom.getShowLayoutTableTabs()" on page 960.

Arguments

None.

Returns

A Boolean value: true if Dreamweaver shows table widths in standard or expanded tables mode; false otherwise.

dom.getTableExtent()

Availability

Dreamweaver 3.

Description

This function gets the number of columns and rows in the selected table.

Arguments

None.

Returns

An array that contains two whole numbers. The first array item is the number of columns, and the second array item is the number of rows. If no table is selected, nothing returns.

dom.increaseColspan()

Availability

Dreamweaver 3.

Description

This function increases the column span by one.

Arguments

None.

Returns

Nothing.

Enabler

See "dom.canIncreaseColspan()" on page 1061.

dom.increaseRowspan()

Availability

Dreamweaver 3.

Description

This function increases the row span by one.

Arguments

None.

Returns

Nothing.

Enabler

See "dom.canDecreaseRowspan()" on page 1059.

dom.insertTableColumns()

Availability

Dreamweaver 3.

Description

This function inserts the specified number of table columns into the current table.

Arguments

 numberOfCols, bBeforeSelection 

• The numberOfCols argument is the number of columns to insert.

• The bBeforeSelection argument is a Boolean value: TRue indicates that the columns should be inserted before the column that contains the selection; false otherwise.

Returns

Nothing.

Enabler

See "dom.canInsertTableColumns()" on page 1061.

dom.insertTableRows()

Availability

Dreamweaver 3.

Description

This function inserts the specified number of table rows into the current table.

Arguments

 numberOfRows, bBeforeSelection 

• The numberOfRows argument is the number of rows to insert.

• The bBeforeSelection argument is a Boolean value: true indicates that the rows should be inserted above the row that contains the selection; false otherwise.

Returns

Nothing.

Enabler

See "dom.canInsertTableRows()" on page 1062.

dom.mergeTableCells()

Availability

Dreamweaver 3.

Description

This function merges the selected table cells.

Arguments

None.

Returns

Nothing.

Enabler

See "dom.canMergeTableCells()" on page 1063.

dom.removeAllTableHeights()

Availability

Dreamweaver 3.

Description

This function removes all HEIGHT attributes from the selected table.

Arguments

None.

Returns

Nothing.

dom.removeAllTableWidths()

Availability

Dreamweaver 3.

Description

This function removes all WIDTH attributes from the selected table.

Arguments

None.

Returns

Nothing.

dom.removeColumnWidth()

Availability

Dreamweaver MX 2004.

Description

This function removes all WIDTH attributes from a single, selected column.

Arguments

None.

Returns

Nothing.

dom.selectTable()

Availability

Dreamweaver 3.

Description

Selects an entire table.

Arguments

None.

Returns

Nothing.

Enabler

See "dom.canSelectTable()" on page 1064.

dom.setShowTableWidths()

Availability

Dreamweaver MX 2004.

Description

Toggles the display of table widths on and off in standard or Expanded Tables mode (non-Layout mode). This function sets the value for the current document and any future document unless otherwise specified. For information on setting the display of table tabs in Layout mode, see "dom.setShowLayoutTableTabs()" on page 967.

Arguments

 bShow 

• The bShow is a Boolean argument that indicates whether to display table widths for tables when the current document is in standard or Expanded Tables mode (non-Layout mode). If bShow is true, Dreamweaver displays the widths. If bShow is false, Dreamweaver does not display the widths.

Returns

Nothing.

dom.setTableCellTag()

Availability

Dreamweaver 3.

Description

This function specifies the tag for the selected cell.

Arguments

 tdOrTh 

• The tdOrTh argument must be either "td" or "th".

Returns

Nothing.

dom.setTableColumns()

Availability

Dreamweaver 3.

Description

This function sets the number of columns in the selected table.

Arguments

 numberOfCols 

• The numberOfCols argument specifies the number of columns to set in the table.

Returns

Nothing.

dom.setTableRows()

Availability

Dreamweaver 3.

Description

This function sets the number of rows in the selected table.

Arguments

 numberOfCols 

• The numberOfRows argument specifies the number of rows to set in the selected table.

Returns

Nothing.

dom.showInsertTableRowsOrColumnsDialog()

Availability

Dreamweaver 3.

Description

This function opens the Insert Rows or Columns dialog box.

Arguments

None.

Returns

Nothing.

Enabler

See "dom.canInsertTableColumns()" on page 1061 or "dom.canInsertTableRows()" on page 1062.

dom.splitTableCell()

Availability

Dreamweaver 3.

Description

This function splits the current table cell into the specified number of rows or columns. If one or both of the arguments is omitted, the Split Cells dialog box appears.

Arguments

 {colsOrRows}, {numberToSplitInto} 

• The colsOrRows argument, which is optional, must be either "columns" or "rows".

• The numberToSplitInto argument, which is optional, is the number of rows or columns into which the cell will be split.

Returns

Nothing.

Enabler

See "dom.canSplitTableCell()" on page 1066.