Legato
Legato

GoFiler Legato Script Reference

 

Legato v 1.5b

Application v 5.24b

  

 

Chapter EightData Functions (continued)

DataSheetSetRowDataWord Function

Overview

The DataSheetSetRowDataWord function sets the 32-bit caller data dword associated with the row.

Syntax/Parameters

Syntax

int = DataSheetSetRowDataWord ( handle hSheet, int index, dword data );

Parameters

hSheet

A handle to a Data Sheet object.

index

A zero-based int representing the row index.

data

A 32-bit dword containing the data to set for the row.

Return Value

Returns an int as ERROR_NONE or a formatted error code on failure.

Remarks

The caller row data is a 32-bit value associated with each row and is used by many functions and views to control or group content on templates. The Data Sheet object must have a row array to be able to use this function (although if it does not, the return value will be 0 which is effectively like referencing an uninitialized row data word).

The row array is automatically created if as required.

The caller data can also be retrieved using the DataSheetGetRowProps function. The caller row data is the same as the keyword “CallerData” for row properties.

Related Functions

Platform Support

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

Legato IDE, Legato Basic

Page revised 2024-10-21