Legato
Legato

GoFiler Legato Script Reference

 

Legato v 1.5b

Application v 5.24b

  

 

Chapter NineDialog Functions (continued)

ControlSetPosition Function

Overview

The ControlSetPosition function sets position and size of a control.

Syntax/Parameters

Syntax

int = ControlSetPosition ( int id, int x, int y, [int w, int h] );

Parameters

id

An int that identifies the dialog control that will receive focus.

x

An int specifying the position of the upper left corner in dialog client coordinates in pixels. Zero is the most left position on the page.

y

An int specifying the position of the upper left corner in dialog client coordinates in pixels. Zero is the top position on the page.

w     h

A optional pair of int value specifying the width and height in pixels. If the width and height are not given, the existing control width and height are used.

Return Value

Returns an int value as ERROR_NONE on success, ERROR_RANGE if id is an invalid control ID for the open dialog, or ERROR_INVALID_HANDLE if no dialog is open.

Remarks

While dialog resource are specified in dialog units, the position for moving a control is specified in pixels. The top corner of the dialog page client area is 0, 0.

The height and width specify the control’s window size. This includes non-client drawing items such as borders, scrollbars, and captions.

Related Functions

Platform Support

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

Legato IDE, Legato Basic