CC-Tweaked/doc/events/monitor_touch.md

---
module: [kind=event] monitor_touch
---

<!--
SPDX-FileCopyrightText: 2021 The CC: Tweaked Developers

SPDX-License-Identifier: MPL-2.0
-->

The [`monitor_touch`] event is fired when an adjacent or networked Advanced Monitor is right-clicked.

## Return Values
1. [`string`]: The event name.
2. [`string`]: The side or network ID of the monitor that was touched.
3. [`number`]: The X coordinate of the touch, in characters.
4. [`number`]: The Y coordinate of the touch, in characters.

## Example
Prints a message when a monitor is touched:
```lua
while true do
  local event, side, x, y = os.pullEvent("monitor_touch")
  print("The monitor on side " .. side .. " was touched at (" .. x .. ", " .. y .. ")")
end
```