Legato
Legato

GoFiler Legato Script Reference

 

Legato v 1.4j

Application v 5.22b

  

 

Chapter NineDialog Functions (continued)

ControlGetHandle Function

Overview

The ControlGetHandle function retrieves the window handle for the specified control.

Syntax/Parameters

Syntax

handle = ControlGetHandle ( int id );

Parameters

id

An int that identifies the dialog control.

Return Value

Returns a handle for the control or a NULL_HANDLE on failure. Use the GetLastError function to retrieve error information.

Remarks

Windows handles are assigned to each control on a dialog; however, the script engine manages these handles for the programmer. They do not require cleanup, and the handle and the window are automatically closed when the dialog closes. Using Windows handles is an advanced feature applicable in custom or high-level dialog functions.

This function can only be used within a dialog procedure.

Related Functions

Platform Support

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

Legato IDE, Legato Basic