Legato
Legato

GoFiler Legato Script Reference

 

Legato v 1.5d

Application v 5.25a

  

 

Chapter NineDialog Functions (continued)

DataControlAddString Function

Overview

The DataControlAddString function adds a row to a data control. The string can be either tab delimited or comma delimited format.

Syntax/Parameters

Syntax

int = DataControlAddString ( int id, string data );

Parameters

id

An int containing the control ID of the data control.

data

A UTF encoded string to add to the data control. The number of columns will automatically be expanded as required.

Return Value

Returns an int as ERROR_NONE or a formatted error code on failure, ERROR_RANGE if id is an invalid control ID for the open dialog, or ERROR_INVALID_HANDLE if no dialog is open. Use the GetLastError function to retrieve error information.

Remarks

This function is similar to ListBoxAddItem except it will also accept CSV data but it works with a data control and will also insert cells of information as delimited by tabs or CSV.

Detection of the data mode is performed by scanning the data parameter for tab characters, finding none, scanning for a comma, and, if found, the mode is set to comma.

Related Functions

Platform Support

Go13, Go16, GoFiler Complete, GoFiler Corporate, GoFiler, GoFiler Lite, GoXBRL

Legato IDE, Legato Basic