---
name: "CT TOOLBOX"
type: topic
aliases: ["DialogControls-Toolbox"]
source: https://community.bistudio.com/wiki/CT_TOOLBOX
revid: 268260
updated: 2021-06-12T11:04:18Z
---

# CT TOOLBOX

### Introduction

A Toolbox is a set of options, ordered by columns and rows. Only one can be active at a time and one is always selected (the first one by default). For Toolbox with multiple selections see [CT_CHECKBOXES](../topics/CT_CHECKBOXES.md).

#### Related commands & functions

- Commands: General
- Commands: UI Eventhandlers
- Commands: Listbox

#### Related User Interface Eventhandlers

- [Events: General](../topics/User_Interface_Event_Handlers.md#generic-events)
- [Events: Listbox](../topics/User_Interface_Event_Handlers.md#listbox-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_TOOLBOX 6
```

#### C

##### checked_strings

**Type:** Array

**Description:** Options texts to display when an option is selected.

```cpp
checked_strings[] = {"[Entry 1]","[Entry 2]","[Entry 3]","[Entry 4]","[Entry 5]","[Entry 6]"};
```

##### color

**Type:** Array

**Description:** n/a

```cpp
color[] = {0.95,0.95,0.95,1};
```

##### colorBackground

**Type:** Array

**Description:** Color of the background when option is not selected.

```cpp
colorBackground[] = {0.95,0.95,0.95,1};
```

##### colorDisable

**Type:** Array

**Description:** n/a

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

##### colorSelect

**Type:** Array

**Description:** n/a

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

##### colorSelectedBg

**Type:** Array

**Description:** Color of the background when option is selected.

```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])",0.5};
```

##### colorTextDisable

**Type:** Array

**Description:** n/a

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

##### colorTextSelect

**Type:** Array

**Description:** Color of the selected option text.

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

##### columns

**Type:** Number, String

**Description:** Amount of columns to arrange options into.

Number example:

```cpp
columns = 3;
```

String example:

```cpp
columns = "4 - 1";
```

#### N

##### names

**Type:** Array

**Description:** n/a

```cpp
names[] = {"MOVE","GETOUT","UNLOAD","TR UNLOAD","%1/cfgWaypoints/A3/Land","%1/cfgWaypoints/A3/Artillery","UNHOOK"};
```

#### R

##### rows

**Type:** Number

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

```cpp
rows = 2;
```

#### S

##### strings

**Type:** Array

**Description:** Options texts to display.

```cpp
strings[] = {"100m","200m","500m"};
```

#### T

##### tooltips

**Type:** Array

**Description:** Tooltips for each option.

```cpp
tooltips[] = {"Objects","Compositions","Triggers","Systems","Markers"};
```

#### 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[] = {0,1,2,3,4,5,6};
```

### 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).

#### RscExample

```cpp
class RscToolbox
{
    deletable = 0;
    fade = 0;
    access = 0;
    type = CT_TOOLBOX;
    style = ST_CENTER;
    colorText[] = {0.95,0.95,0.95,1};
    color[] = {0.95,0.95,0.95,1};
    colorTextSelect[] = {0.95,0.95,0.95,1};
    colorSelect[] = {0.95,0.95,0.95,1};
    colorTextDisable[] = {0.4,0.4,0.4,1};
    colorDisable[] = {0.4,0.4,0.4,1};
    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])",
        0.5
    };
    shadow = 0;
    strings[] =
    {
        "",
        ""
    };
    x = 0;
    y = 0;
    w = 0.3;
    h = 0.025;
    rows = 1;
    columns = 2;
    font = "RobotoCondensed";
    sizeEx = GUI_TEXT_SIZE_SMALL;
};
```

<sub>Source: [BI Community Wiki — CT TOOLBOX](https://community.bistudio.com/wiki/CT_TOOLBOX) (revision 268260).</sub>