---
name: "ctrlMapMouseOver"
type: command
status: ok
groups: ["GUI Control - Map"]
arma3_since: "0.50"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/ctrlMapMouseOver
revid: 369404
updated: 2024-09-03T18:43:23Z
---

# ctrlMapMouseOver

*Command · GUI Control - Map · Arma 3 v0.50 · introduced in Arma 2 v1.00*

## Description

Returns description of map sign mouse cursor is over. Works with in-game map as well as 2D editor map in edit mode.

## Syntax

```sqf
ctrlMapMouseOver control
```

**Parameters:**

- `control`: [Control](../topics/Control.md) - map control

**Returns:** [Array](../topics/Array.md) - possible values:
- ["unit", [Object](../topics/Object.md)]
- ["vehicle", [Object](../topics/Object.md)]
- ["vehicleGroup", [Object](../topics/Object.md)]
- ["object", [Object](../topics/Object.md)]
- ["waypoint", Waypoint]
- ["trigger", [Object](../topics/Object.md)]
- ["marker", [String](../topics/String.md)]
- ["task", [Task](../topics/Task.md)]
- ["customMark"]

## Examples

### Example 1

```sqf
(uiNamespace getVariable "_map") ctrlMapCursor ["Track","HC_overFriendly"];

_mouseover = if (count (ctrlMapMouseOver (uiNamespace getVariable "_map")) > 0) then
{
    ctrlMapMouseOver (uiNamespace getVariable "_map")
}
else
{
    [""]
};

if (_mouseover select 0 == "task" && str(_logic getVariable "onTaskAssigned") != str{}) then
{
    //--- Task
    (uiNamespace getVariable "_map") ctrlMapCursor ["Track","HC_overMission"];
}
else
{
    //--- Waypoint
    (uiNamespace getVariable "_map") ctrlMapCursor ["Track","HC_move"];
};
```

### Example 2

```sqf
onEachFrame {hintSilent str ctrlMapMouseOver (findDisplay 12 displayCtrl 51)};
```

## See also

[findDisplay](../commands/findDisplay.md) · [displayCtrl](../commands/displayCtrl.md) · [BIS_fnc_createTooltip](../functions/BIS_fnc_createTooltip.md)

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