---
name: "ctrlGetProperty"
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/ctrlGetProperty
revid: 379130
updated: 2026-10-09T16:30:40Z
---

# ctrlGetProperty

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

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

## Description

Returns one or multiple given properties of given control.

## Syntax

### Syntax 1

```sqf
control ctrlGetProperty property
```

**Parameters:**

- `control`: [Control](../topics/Control.md)
- `property`: [String](../topics/String.md) - Any property available for given control type. Case insensitive

**Returns:** [Anything](../topics/Anything.md) - Return value depends on the property

### Syntax 2

```sqf
control ctrlGetProperty properties
```

**Parameters:**

- `control`: [Control](../topics/Control.md)
- `properties`: [Array](../topics/Array.md) of [String](../topics/String.md)s - Properties available for given control type. Case insensitive

**Returns:** [HashMap](../topics/HashMap.md) in format:
- key: [String](../topics/String.md) -  Name of the property
- value: [Anything](../topics/Anything.md) - Value depends on the property

## Examples

### Example 1

```sqf
_ctrl ctrlGetProperty "x"; // Return 0.015
```

### Example 2

```sqf
_ctrl ctrlGetProperty ["x", "colorBackground"]; // Return {"x": 0.015, "colorBackground": [1, 0.4, 1, 1]}
```

## See also

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

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