The table Embedded Text Widget (ETW) allows you to produce rows and
columns of tabular data in a Wylib document.
This type of ETW may be used in several different types of documents
such as letters and product documentation.
Tables can be formatted in a way similar to a figure, where a caption
is shown under the table, and the
REF (reference) widget.
can be used to create a numerical reference to the table.
Like all ETW's, there is a main menu in the upper left part of the widget
where all the widget's functionality can be accessed.
Just under the menu button are two shortcut buttons (Column and Row)
to allow faster access to two common functions also found in the menu.
Tabular data can be imported and/or exported from CSV files such as
might be created from a spreadsheet program.
- Tag:
-
When the table is created, you will be asked to provide a tag name.
This is a short name consisting of alpha characters which may be
used to refer to this table.
So each table within a document should have a unique tag name.
Once the table has been created, the tag can not be changed.
If you need to change it, export the data to a file, create a new
table with the desired tag name, and import the data into the new table.
- Style:
This controls how the table will be formatted.
The "Plain" method will indent the table with the value provided
in the Indent field.
There will be no caption or centering of the table.
The "Figure" method will center the table and will provide a caption
consiting of the Title you provide.
This is the only method that will allow you to refer to the table
using the
REF (reference) widget.
The Indent value will be ignored.
The "Centered" method will center the table but will not provide a caption.
No references may be used, and the Indent value will be ignored.
consiting of the Title you provide.
- Indent:
-
When the Style is set to "Plain," this value will determine how
far the table will be indented from the left side of the page.
- Title:
-
The text you enter here will be shown as a caption for the table
if the Style is set to "Figure."
Otherwise, the title is not used when rendering the document.
- (Cells)
-
There is one cell at the intersection of each row and column.
Rows and columns may be added or deleted as described below.
Once you have the desired number of cells, you can type any text
value into each of the cells.
The widget menu contains a number of functions to allow you to control
the size and attributes of the table.
The menu functions are as follows:
- Add Columns
This will increase the number of columns in the table.
The program will ask you how many columns you wish to add.
The added columns will be added at the right side of the table.
Note that there is a menu at the top of each column that will allow
you to add columns into the center of the table and/or delete
columns from the center of the table.
- Add Rows
This will increase the number of rows in the table.
The program will ask you how many rows you wish to add.
The added rows will be added at the bottom of the table.
Note that there is a menu on the left side of each row that will allow
you to add rows into the center of the table and/or delete
rows from the center of the table.
- Remove Columns
This will decrease the number of columns in the table.
The program will ask you how many columns you wish to remove.
The columns will be removed from the right side of the table.
Note that there is a menu at the top of each column that will allow
you to add columns into the center of the table and/or delete
columns from the center of the table.
- Remove Rows
This will decrease the number of rows in the table.
The program will ask you how many rows you wish to remove.
The rows will be removed from the bottom of the table.
Note that there is a menu on the left side of each row that will allow
you to add rows into the center of the table and/or delete
rows from the center of the table.
- Clear Table
-
This will remove all the data from the cells in the table and will
reset the header fields to their default values.
- Import
-
This will allow you to load the table cells with data from a CSV
from the disk.
A CSV file can be created (exported) from most spreadsheet programs.
- Export
-
This will allow you to create a CSV file on the disk which contains
the data from the cells of the table.
The data can then be viewed and/or edited in most common spreadsheet programs.
- Set Delimiter
-
CSV files consist of rows of data wherein each row is separated by a delimiter character.
In a standard CSV file, the delimiter is normally a comma (,).
It is possible to specify a different delimiter character using this menu function.
Row and Column Menu Options
Each row and column has a special menu that will act upon that specific
row or column.
Typically these menu items are used for adding or deleting rows or
columns from within the center of the table.
The menu functions are as follows:
- Bump 1
-
This will insert one column (or row) before the column (or row) from whose menu the command is executed.
- Bump n
-
This will insert multiple columns (or rows) before the column (or row) from whose menu the command is executed.
- Delete 1
-
This will remove the column (or row) from whose menu the command is executed.
- Delete n
-
This will remove multiple columns (or rows) starting with the column (or row) from whose menu the command is executed.
- Display Width
-
This will adjust how wide the column is as it is displayed on the screen.
It has no effect on the way the document is ultimately formatted (printed).
During formatting, all columns are adjusted for a "best fit" to the actual data in the column.