<Table>.ToText (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Table functions

Prefix syntax

ToText

Presentation

Example

Use conditions

Limit

See also

<Table>.ToText (Function)

In french: <Table>.VersTexte

Creates a character string from the data found in a Table or TreeView Table control. This string can be saved in a specific format thereafter.

Example

sText is string
sText = TABLE_TABLE1.ToText(taNoTitle, ";")
fSaveText("Export.csv", sText)

Syntax

<Result> = <Table control>.ToText([<Options> [, <Column separator> [, <Row separator> [, <Start row> [, <End row>]]]]])

<Result>: Character string

Character string containing the data of the Table control. In this string, the columns are separated by <Separator> and the rows are separated by CR characters (Carriage Return).
Empty string ("") if an error occurs or if the Table control is empty

<Table control>: Control name

Name of the control to be used. This control can correspond to:
a Table control.
a TreeView Table control.

<Options>: Optional constant

Configures the information that must be taken into account in the string.
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.
taColumnsTitles
(Default value) The title of the columns is inserted.
taNoTitle Only the data is copied.
taNoTotal Does not export:
the rows containing totals, mean and automatic count (these rows are exported by default).
the rows containing custom calculations (these rows are exported by default).
This constant is not available.
taSelectedLines Exports the selected rows only (all the rows are exported by default).
taWithInvisibleColumns Also exports the invisible control columns.
The columns defined as non printable and non exportable are exported. These columns are defined:
programmatically: VisibleInExportAndPrint property set to False.
in the "General" tab of the column description window: "Export and print" set to "Never".

<Column separator>: Optional character string

Separator used between the columns. The default separator is the tabulation (TAB).

<Row separator>: Optional character string

Separator used between the rows. The separator used by default is the CR character (Carriage Return).

<Start row>: Optional integer

Number of the row where the export will start.
If this parameter is not specified, the start row is the first row of the control.

<End row>: Optional integer

Number of the row where the export will end.
If this parameter is not specified, the end row is the last row of the control.

Remarks

Use conditions

<Table>.ToText can be used on:

Table or TreeView Table controls based on a data file.
Table or TreeView Table controls populated programmatically.
single-selection or multi-selection controls.

Limit

The merged columns are ignored.

Component: wd280std.dll