Legato
Legato

GoFiler Legato Script Reference

 

Legato v 1.5d

Application v 5.25a

  

 

Chapter EightData Functions (continued)

WorkbookGetSheet Function

Overview

The WorkbookGetSheet function retrieves sheet of an open workbook.

Syntax/Parameters

Syntax

handle = WorkbookGetSheet ( handle hWorkbook, string name | int index );

Parameters

hWorkbook

A handle to a Workbook Object.

name

A string specifying the name of the sheet to reference. Or,

index

A zero-base int specifying the sheet position.

Return Value

Returns a handle to a Data Sheet Object or NULL_HANDLE on failure. Use the GetLastError and GetLastErrorMessage to retrieve additional information.

Remarks

When a workbook is opened, the sheet positions are mapped but the data is not loaded. Getting a sheet from, the workbook creates a Data Sheet Object and then loads the sheet’s data into the object. A handle to the newly create object is then returned.

The handle should be closed when actions have been completed using the CloseHandle function.

The state of the Workbook Object is not altered and it does not store the Data Sheet handle on completion.

Related Functions

Platform Support

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

Legato IDE, Legato Basic

Page revised 2024-12-13