Legato
Legato

GoFiler Legato Script Reference

 

Legato v 1.5b

Application v 5.24b

  

 

Chapter NineDialog Functions (continued)

DataControlSetColumnPositions Function

Overview

The DataControlSetColumnPositions function allows column positions to be set for a data control.

Syntax/Parameters

Syntax

int = DataControlSetColumnPositions ( int id, [int p1, int p2, ...] | [int list[] ] );

Parameters

id

An int containing the control ID of the data control.

p1, p2, p3, ...

A list of one or more int parameters specifying the column position; or,

list[]

An int array of column positions.

Return Value

Returns an int as ERROR_NONE or a formatted error code on failure. Common error codes are as follows: 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

Column positions of the data control are part of a dialog box, and the integers are in pixel units. The position stops must be sorted in ascending order.

Unlike list boxes, data controls have cells so text does not overflow into the next position. Instead it is clipped.

A maximum of 255 positions may be added but only by array. When adding as individual parameters, the number is limited by the maximum script parameters, which is 32 (less the id).

Related Functions

Platform Support

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

Legato IDE, Legato Basic