---
name: "ctrlSetProperty"
type: command
status: ok
groups: ["GUI Control"]
arma3_since: "2.24"
branch: "dev"
locality: {"argument": "local", "effect": "local", "server_exec": false}
source: https://community.bistudio.com/wiki/ctrlSetProperty
revid: 379135
updated: 2026-10-12T14:41:15Z
---

# ctrlSetProperty

*Command · GUI Control · Arma 3 v2.24 · branch: dev*

Locality: arguments **local** · effect **local**

## Description

Sets one or multiple given properties of given control.

## Syntax

### Syntax 1

```sqf
control ctrlSetProperty property
```

**Parameters:**

- `control`: [Control](../topics/Control.md)
- `property`: [Array](../topics/Array.md) in format [name, value]:
  - name: [String](../topics/String.md) - Name of the property, case insensitive
  - value: [Anything](../topics/Anything.md)- Value depends on the property

**Returns:** [Nothing](../topics/Nothing.md)

### Syntax 2

```sqf
control ctrlSetProperty properties
```

**Parameters:**

- `control`: [Control](../topics/Control.md)
- `properties`: [HashMap](../topics/HashMap.md) in format:
  - key: [String](../topics/String.md) - Name of the property, case insensitive
  - value: [Anything](../topics/Anything.md) - Value depends on the property

## Examples

### Example 1

```sqf
_ctrl ctrlSetProperty ["x", 0.015];
```

### Example 2

```sqf
_ctrl ctrlSetProperty #{
    "x": 0.015, 
    "colorBackground": [1, 0.4, 1, 1]
}
```

## See also

[ctrlGetProperty](../commands/ctrlGetProperty.md)

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