TableToExcel (Function)

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Printing in an XLS file

Related examples

See also

TableToExcel (Function)

In french: TableVersExcel

Creates an Excel file from the data found in a Table or TreeView Table control .

Note: This file can be opened by Excel or by OpenOffice Calc (depending on the software installed on the current computer).

Versions 16 and later

This function is now available for the WINDEV applications in Linux.

New in version 16

This function is now available for the WINDEV applications in Linux.

Versions 18 and later

This function can now be used to handle the treeview tables in the WEBDEV sites.

New in version 18

This function can now be used to handle the treeview tables in the WEBDEV sites.

Versions 23 and later

This function is now available for WEBDEV sites in Linux.

New in version 23

This function is now available for WEBDEV sites in Linux.

Example

sFile is string
// Asks for the file name
sFile = fSelect("", "", "Choose the export file", ...
"Excel files (*.xls) *.xls", "xls", fselCreate + fselExist)
// If the name was not specified, cancels the export
// Otherwise, exports the content of TABLE_TABLE1
IF sFile <> "" THEN TableToWord(TABLE_TABLE1, sFile, taNoTitle)

Syntax

Selecting all rows or the first N rows found in the Table or TreeView Table control Hide the details

<Result> = TableToExcel(<Table control> , <Name of XLS file> [, <Options> [, <Number of Exported Rows>]])

<Result>: Boolean

True if the file was created,
False otherwise. To find out the error details, use ErrorInfo.

<Table control>: Control name

Name of control to use. This control can correspond to:
a Table control.
a TreeView Table control.

<Name of XLS file>: Character string (with quotes)

Name and full path of Excel file to create. The file is replaced by the new file if it already exists.

<Options>: Optional Integer constant

Configures the XLS file to create.
taWithInvisibleColumns Also exports the invisible control columns.
Versions 22 and later
The columns defined as non printable and non exportable are exported. These columns are defined:
by programming: ..VisibleInExportAndPrint set to False.
in the "General" tab of the description window of columns: "Export and print" to "Never".
New in version 22
The columns defined as non printable and non exportable are exported. These columns are defined:
by programming: ..VisibleInExportAndPrint set to False.
in the "General" tab of the description window of columns: "Export and print" to "Never".
The columns defined as non printable and non exportable are exported. These columns are defined:
by programming: ..VisibleInExportAndPrint set to False.
in the "General" tab of the description window of columns: "Export and print" to "Never".
taWithLayout Exports the color and the font used in the control.
taColumnDisplayedOrder Exports the columns according to the order of columns currently displayed in the control (and not according to the order of columns defined in the editor).
This constant is not available.
taMerge If the XLS file already exists, merges the existing content with the new content: the formulas, the formatting, ... of existing cells is kept. The existing data is not stored. Only the data of columns and rows found as well in the existing XLS file is kept.
taSelectedLines Exports the selected rows only (all the rows are exported by default). Does not export the totals.
taNoTitle Only the data is copied into the file.
taNoTotal Does not export:
the rows containing totals, mean and automatic count (these rows are exported by default).
Versions 22 and later
the rows containing custom calculations (these rows are exported by default).
New in version 22
the rows containing custom calculations (these rows are exported by default).
the rows containing custom calculations (these rows are exported by default).
This constant is not available.
taColumnsTitles
(default value) The title of columns is inserted into the file.

<Number of Exported Rows>: Optional integer

Number of rows to export. Only the rows found between 1 and <Number of exported rows> will be exported.
All rows found in the Table control will be exported if this parameter is not specified.

Selecting the rows found in the Table or TreeView Table control Hide the details

<Result> = TableToExcel(<Table control> , <Name of XLS file> [, <Options> [, <Start row> [, <End row>]]])

<Result>: Boolean

True if the file was created,
False otherwise. To find out the error details, use ErrorInfo.

<Table control>: Control name

Name of control to use. This control can correspond to:
a Table control.
a TreeView Table control.

<Name of XLS file>: Character string (with quotes)

Name and full path of Excel file to create. The file is replaced by the new file if it already exists.

<Options>: Optional Integer constant

Configuration of XLS file to create.
taWithInvisibleColumns Also exports the invisible control columns.
Versions 22 and later
The columns defined as non printable and non exportable are exported. These columns are defined:
by programming: ..VisibleInExportAndPrint set to False.
in the "General" tab of the description window of columns: "Export and print" to "Never".
New in version 22
The columns defined as non printable and non exportable are exported. These columns are defined:
by programming: ..VisibleInExportAndPrint set to False.
in the "General" tab of the description window of columns: "Export and print" to "Never".
The columns defined as non printable and non exportable are exported. These columns are defined:
by programming: ..VisibleInExportAndPrint set to False.
in the "General" tab of the description window of columns: "Export and print" to "Never".
taWithLayout Exports the color and the font used in the control.
taColumnDisplayedOrder Exports the columns according to the order of columns currently displayed in the control (and not according to the order of columns defined in the editor).
This constant is not available.
taMerge If the XLS file already exists, merges the existing content with the new content: the formulas, the formatting, ... of existing cells is kept.
taSelectedLines Exports the selected rows only (all the rows are exported by default).
Does not export the totals.
taNoTitle Only the data is copied into the file.
taNoTotal Does not export:
the rows containing totals, mean and automatic count (these rows are exported by default).
Versions 22 and later
the rows containing custom calculations (these rows are exported by default).
New in version 22
the rows containing custom calculations (these rows are exported by default).
the rows containing custom calculations (these rows are exported by default).
This constant is not available.

<Start row>: Optional integer

Number of the row where the export will start. All the control rows will be exported if this parameter and <End row> are not specified.

<End row>: Optional integer

Number of the row where the export will end. All the control rows will be exported if this parameter and <Start row> are not specified.

Remarks

Use conditions

TableToExcel can be used on:

a browsing or memory control.
a single-selection or multiselection control.

Various

The Excel files cannot exceed 65536 rows and 256 columns if the extension used is ".xls". This limit can be exceeded by using the ".xlsx" extension in order to create files in Excel 2007 format. Caution: in this case, the former versions of Excel must be equipped with the "Office 2007 compatibility pack", that can be downloaded from the Microsoft site in order to open the generated documents.
The created file can be opened by Excel 97 (or later) or by OpenOffice Calc 2 (or later).
The "High-Precision Numeric" columns (38 significant digits) will be exported as exponential numbers.
The merge operation performed on the Table control columns is ignored.
The columns in Unicode format are exported in Unicode format into Excel.
The Check Box columns are exported as check boxes.
The following elements are not exported into the Excel file:
- The images,
- The charts,
- The bar codes.

Printing in an XLS file

A print can be directly performed in an XLS file by iPreview or iDestination or from the print preview. The created XLS file is configured by iParameterXLS.

Related Examples:

Unit examples (WINDEV): The TableTo functions

[ + ] Exporting table data with the WLanguage functions.
The following topics are presented in this example:
1/ interfacing with Word and Excel
2/ sending data to the clipboard
3/ generating a text file
This example explains how to export the content of a table to a Word document, an Excel workbook, the clipboard or a text file via the following WLanguage functions: TableToWord, TableToExcel, ToClipboard, TableToText.

Component : wd240xls.dll