15.7. The Table Menu

15.7.1. Insert Table

The Insert Table command inserts a new table into your document.

This command works only if the DTD of your document contains an appropriate table definition and a table is allowed to occur at the current location of the insertion cursor. For SGML and valid XML documents, epcEdit supports tables in the HTML and CALS formats. Well-formed XML documents do not reference a DTD; therefore no table model is available and no table can be inserted in well-formed XML documents.

When the Insert Table command is invoked, epcEdit displays a dialog for defining the initial characteristics of the table.

Figure 15-37. The Insert Table Dialog

The Columns and Rows contain the initial numbers of columns and rows. The Insert table header and Insert table footer can be checked to create a table header and table footer if they are supported by your table model.

After clicking on the OK button, epcEdit will create the required elements for the initial table structure and move the insertion cursor into the table element. The table content can then be modified in the document window or with epcEdit's built-in table editor. Please refer to Figure 11-1 for details about the table editor.

15.7.2. Delete Table

The Delete Table command deletes the table currently shown in the table editor.

This command is only available if the table editor is active. Please refer to Figure 11-1 for more details about the table editor.

15.7.3. Columns

This command is only available if the table editor is active. When invoked, it displays a sub-menu that contains commands for manipulating the columns in the current table.

Figure 15-38. The columns sub-menu

Please refer to Figure 11-1 for more details about the table editor.

15.7.3.1. Insert column left

The Insert column left command creates a new column in the current table just to the left of the column containing the current cell. The new column is populated with initially empty table cells.

15.7.3.2. Insert column right

The Insert column right command creates a new column in the current table just to the right of the column containing the current cell. The new column is populated with initially empty table cells.

15.7.3.3. Delete column

The Delete column command deletes the column containing the current cell.

15.7.3.4. Properties

The Properties command displays a dialog for modifying the properties of the column containing the current cell.

Figure 15-39. The Column Properties Dialog

This dialog is only available if the table model of your document supports column properties. You can specify the column width in the Width field and select the unit of measurement in the combo box to the right.

Clicking on the Apply button adjusts the column width of the column containing the current cell to these settings. Pressing the Dismiss button closes the dialog.

15.7.4. Rows

This command is only available if the table editor is active. When invoked, it displays a sub-menu that contains commands for manipulating the rows in the current table.

Please refer to Figure 11-1 for more details about the table editor.

Figure 15-40. The rows sub-menu

15.7.4.1. Insert row above

The Insert row above command creates a new row in the current table just above the row containing the current cell. The new row is populated with initially empty table cells.

15.7.4.2. Insert row below

The Insert row above command creates a new row in the current table just below the row containing the current cell. The new row is populated with initially empty table cells.

15.7.4.3. Delete row

The Delete row command deletes the row containing the current cell.

15.7.5. Cells

This command is only available if the table editor is active. When invoked, it displays a sub-menu that contains commands for manipulating the current cell in the current table.

Please refer to Figure 11-1 for more details about the table editor.

Figure 15-41. The cells sub-menu

15.7.5.1. Merge cell left

The Merge cell left command merges the current cell with its neighbor to the left. The content of both cells is combined into one with the content of the former left cell preceding the content of the current cell.

Merging is only possible if the current cell and its left neighbor span vertically over the same rows.The resulting cell will span horizontally all the columns that were spanned by the former current cell and its left neighbor.

15.7.5.2. Merge cell right

The Merge cell right command merges the current cell with its neighbor to the right. The content of both cells is combined into one with the content of the former right cell following the content of the current cell.

Merging is only possible if the current cell and its right neighbor span vertically over the same rows. The resulting cell will span horizontally all the columns that were spanned by the former current cell and its right neighbor.

15.7.5.3. Merge cell up

The Merge cell up command merges the current cell with its upper neighbor. The content of both cells is combined into one with the content of the former upper cell preceding the content of the current cell.

Merging is only possible if the current cell and its upper neighbor span horizontally over the same columns. The resulting cell will span vertically over all the rows that were spanned by the former current cell and its upper neighbor.

15.7.5.4. Merge cell down

The Merge cell down command merges the current cell with its lower neighbor. The content of both cells is combined into one with the content of the current cell preceding the content of the lower cell.

Merging is only possible if the current cell and its lower neighbor span horizontally over the same columns. The resulting cell will span vertically over all the rows that were spanned by the former current cell and its lower neighbor.

15.7.5.5. Split cell vertically

If the current cell spans over more than one row, the Split cell vertically command splits the current cell vertically into as many cells as were spanned by the original cell.

When a cell is vertically split, the content of the original cell remains in the upper cell and the new table cells that are created below the original cell are initially empty.

Splitting is only possible if the current cell has a vertical spanning. Cells that do not span over several rows can not be split.

15.7.5.6. Split cell horizontally

If the current cell spans over more than one row, the Split cell horizontally command splits the current cell horizontally into as many cells as were spanned by the original cell.

When a cell is horizontally split, the content of the original cell remains in the left cell and the new table cells that are created to the right of the original cell are initially empty.

Splitting is only possible if the current cell has a horizontal spanning. Cells that do not span over several columns can not be split.