---
name: "CT CHECKBOXES"
type: topic
aliases: ["DialogControls-CheckBoxes"]
source: https://community.bistudio.com/wiki/CT_CHECKBOXES
revid: 295501
updated: 2021-11-15T22:55:38Z
---

# CT CHECKBOXES

### Introduction

The Checkboxes (also known as textual checkboxes) are a set of state change buttons, ordered by columns and rows. Unlike the Toolbox Control more than one button can become active. Maximum number of checkboxes available for a single control is 32. It is possible to create more than 32 checkboxes, however over-the-limit checkboxes will just become duplicates. `CT_CHECKBOXES` fully inherits from [CT_TOOLBOX](../topics/CT_TOOLBOX.md), the difference is that with CheckBoxes one can make multiple selections or have no item selected. When CheckBoxes style is `ST_PICTURE`, the `strings` property is treated as array of textures, and `checked_strings` property is ignored.

#### Related commands & functions

- Commands: General
- Commands: UI Eventhandlers
- Commands: Listbox
- [ctrlSetChecked](../commands/ctrlSetChecked.md)
- [ctrlChecked](../commands/ctrlChecked.md)

#### Related User Interface Eventhandlers

- [Events: General](../topics/User_Interface_Event_Handlers.md#generic-events)
- [Events: Listbox](../topics/User_Interface_Event_Handlers.md#listbox-events)
- [Events: Checkbox](../topics/User_Interface_Event_Handlers.md#checkbox-events)

### Alphabetical Order

> [!NOTE]
> TokenNames common to most controls, such as x, y, w, h, text, idc... can be found [**here**](../topics/Arma~3A_GUI_Configuration.md#common-properties).

> [!WARNING]
> Not all of the listed attributes might have an effect nor might the list be complete. All attributes were gathered with [this](https://github.com/7erra/BIKI.VR/blob/master/fnc/generateCTPage.sqf) config crawler.

```cpp
#define CT_CHECKBOXES 7
```

#### C

##### checked_strings

**Type:** Array

**Description:** Checkboxes texts to display when checkboxes are checked

```cpp
checked_strings[] = {"CHECKED"};
```

##### color

**Type:** Array

**Description:** n/a

```cpp
color[] = {0,0,0,0};
```

##### colorBackground

**Type:** Array

**Description:** Color of the background when checkbox is not in focus (doesn't matter if checked or not).

```cpp
colorBackground[] = {0,0,0,0};
```

##### colorDisable

**Type:** Array

**Description:** n/a

```cpp
colorDisable[] = {0.4,0.4,0.4,1};
```

##### colorSelect

**Type:** Array

**Description:** n/a

```cpp
colorSelect[] = {0,0,0,1};
```

##### colorSelectedBg

**Type:** Array

**Description:** Color of the background when checkbox is in focus (doesn't matter if checked or not).

```cpp
colorSelectedBg[] = {"(profilenamespace getvariable ['GUI_BCG_RGB_R',0.13])","(profilenamespace getvariable ['GUI_BCG_RGB_G',0.54])","(profilenamespace getvariable ['GUI_BCG_RGB_B',0.21])",1};
```

##### colorText

**Type:** Array

**Description:** Color of the unchecked checkbox text

```cpp
colorText[] = {0.4,0.4,0.4,1};
```

##### colorTextDisable

**Type:** Array

**Description:** n/a

```cpp
colorTextDisable[] = {0.4,0.4,0.4,1};
```

##### colorTextSelect

**Type:** Array

**Description:** Color of the checked checkbox text

```cpp
colorTextSelect[] = {0,0.8,0,1};
```

##### columns

**Type:** Number

**Description:** Amount of columns to arrange checkboxes into

```cpp
columns = 1;
```

#### R

##### rows

**Type:** Number

**Description:** Amount of rows to arrange checkboxes into.

```cpp
rows = 1;
```

#### S

##### strings

**Type:** Array

**Description:** Checkboxes texts to display

```cpp
strings[] = {"UNCHECKED"};
```

#### T

##### tooltips

**Type:** Array

**Description:** Tooltips for each checkbox.

```cpp
tooltips[] = {"tip0","tip1","tip2","tip3","tip4","tip5","tip6","tip7","tip8","tip9","tip10","tip11","tip12","tip13","tip14","tip15","tip16","tip17","tip18","tip19","tip20","tip21","tip22","tip23","tip24","tip25","tip26","tip27","tip28","tip29","tip30","tip31"};;
```

#### V

##### values

**Type:** Array

**Description:** Numerical values associated with items. Can be retrieved or set with [lbValue](../commands/lbValue.md) and [lbSetValue](../commands/lbSetValue.md).

```cpp
values[] = {1,2,3,4};
```

### Default Classes

> [!NOTE]
> **Arma 3:** **AddOns:** Classes need to be initialised first with `class SomeClass;`
>
> ---
>
> **Missions:** Since Arma 3 v2.02 one can use `import SomeClass;` to initialise a class (see the [import](../topics/import_~28Config~29.md) keyword).
>
> In older versions, use `"Default" call BIS_fnc_exportGUIBaseClasses;` and paste the result into the [description.ext](../topics/Description.ext.md).

Neither the export nor the configFile contains a base class for this control type.

### Example Classes

```cpp
class MyCheckBoxes
{
    onLoad = "_this select 0 ctrlSetChecked [1, true]; _this select 0 ctrlSetChecked [7, true]; _this select 0 ctrlSetChecked [15, true];";

    idc = -1;
    type = 7; // CT_CHECKBOXES
    style = 2; // ST_CENTER

    x = 0.25;
    y = 0.25;
    w = 0.5;
    h = 0.5;

    colorText[] = {0, 1, 0, 1};
    colorTextSelect[] = {1, 0, 0, 1};

    colorBackground[] = {0, 0, 1, 0.3};
    colorSelectedBg[] = {0, 0, 0, 0.2};

    font = "RobotoCondensed";
    sizeEx = 0.04;

    onCheckBoxesSelChanged = "hint str _this";

    columns = 8;
    rows = 4;

    strings[] = {"0","1","2","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","23","24","25","26","27","28","29","30","31"};
    checked_strings[] = {"[0]","[1]","[2]","[3]","[4]","[5]","[6]","[7]","[8]","[9]","[10]","[11]","[12]","[13]","[14]","[15]","[16]","[17]","[18]","[19]","[20]","[21]","[22]","[23]","[24]","[25]","[26]","[27]","[28]","[29]","[30]","[31]"};
    values[] = {0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31};
    tooltips[] = {"tip0","tip1","tip2","tip3","tip4","tip5","tip6","tip7","tip8","tip9","tip10","tip11","tip12","tip13","tip14","tip15","tip16","tip17","tip18","tip19","tip20","tip21","tip22","tip23","tip24","tip25","tip26","tip27","tip28","tip29","tip30","tip31"};
};
```

<sub>Source: [BI Community Wiki — CT CHECKBOXES](https://community.bistudio.com/wiki/CT_CHECKBOXES) (revision 295501).</sub>