Legato
Legato

GoFiler Legato Script Reference

 

Legato v 1.5d

Application v 5.25a

  

 

Chapter NineDialog Functions (continued)

CheckboxGetState Function

Overview

The CheckboxGetState function retrieves the check state of a radio button or checkbox.

Syntax/Parameters

Syntax

int = CheckboxGetState ( int id );

Parameters

id

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

Return Value

Returns an int representing the checked state of the control. On error, BST_UNCHECKED (0) is returned. To check for a control or other error, use the IsError or GetLastError functions to retrieve a formatted error code. The following return codes are possible:

  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 function will return 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 a given time.

Related Functions

Platform Support

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

Legato IDE, Legato Basic