Legato
Legato

GoFiler Legato Script Reference

 

Legato v 1.5b

Application v 5.24b

  

 

Chapter NineDialog Functions (continued)

CheckboxSetState Function

Overview

The CheckboxSetState function sets the check state of a radio button or checkbox.

Syntax/Parameters

Syntax

int = CheckboxSetState ( int id, [int state] );

Parameters

id

An int containing the control ID of a radio button or checkbox.

state

An optional int containing a flag indicating the state to which the checkbox or radio button should be set. The following flags are possible values: 

  Return code   Code  Description
  BST_CHECKED   0x00000001  Button is checked
  BST_INDETERMINATE   0x00000002  Button is grayed, indicating an indeterminate state (applies only if the button has the BS_3STATE or BS_AUTO3STATE style).
  BST_UNCHECKED   0x00000000  Button is cleared

 

The default value is BST_CHECKED.

Return Value

Returns an int 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

This function largely relates to radio and checkbox controls. Note that only one radio button of a radio button group can be checked at any given time.

Related Functions

Platform Support

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

Legato IDE, Legato Basic