---
name: "ctrlChecked"
type: command
status: ok
groups: ["GUI Control"]
arma3_since: "0.50"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/ctrlChecked
revid: 353343
updated: 2024-03-15T17:11:52Z
---

# ctrlChecked

*Command · GUI Control · Arma 3 v0.50*

## Description

Returns the current state of given CT_CHECKBOXES control. Since Arma 3 v1.72 it is possible to query multiple checkboxes by providing checkbox index. For more information see CT_CHECKBOXES.

> [!NOTE]
> The `"CheckBoxesSelChanged"` control EH returns the control, index of changed checkbox and its current checked state. The checked state however is not a [Boolean](../topics/Boolean.md) but [Number](../topics/Number.md) 0 or 1. To convert [ctrlChecked](../commands/ctrlChecked.md) command output into number as well, use [parseNumber](../commands/parseNumber.md) command

## Syntax

### Syntax 1

```sqf
ctrlChecked control
```

**Parameters:**

- `control`: [Control](../topics/Control.md) - CT_CHECKBOXES control. If control contain multiple checkboxes, only checkbox with index 0 is queried.

**Returns:** [Boolean](../topics/Boolean.md) - [true](../commands/true.md) checked, [false](../commands/false.md) unchecked

### Syntax 2

*since arma3 1.72*

```sqf
control ctrlChecked index
```

**Parameters:**

- `control`: [Control](../topics/Control.md) - CT_CHECKBOXES control
- `index`: [Number](../topics/Number.md) - checkbox index

**Returns:** [Boolean](../topics/Boolean.md) - [true](../commands/true.md) checked, [false](../commands/false.md) unchecked

## Examples

### Example 1

```sqf
ctrlChecked _control;
```

### Example 2

```sqf
_control ctrlChecked 3;
```

## See also

[ctrlSetChecked](../commands/ctrlSetChecked.md) · [cbChecked](../commands/cbChecked.md) · [cbSetChecked](../commands/cbSetChecked.md)

<sub>Source: [BI Community Wiki — ctrlChecked](https://community.bistudio.com/wiki/ctrlChecked) (revision 353343).</sub>