1
0
mirror of https://github.com/SquidDev-CC/CC-Tweaked synced 2024-11-05 09:36:19 +00:00
CC-Tweaked/doc/events/mouse_click.md
SquidDev 9ae0f4a993 Add some initial documentation for events
Credit to @BradyFromDiscord for writing these. See #640 and #565.

Co-authored-by: Brady <bradyakent@gmail.com
2021-01-14 18:37:20 +00:00

1.2 KiB

module: [kind=event] mouse_click

This event is fired when the terminal is clicked with a mouse. This event is only fired on advanced computers (including advanced turtles and pocket computers).

Return values

  1. @{string}: The event name.
  2. @{number}: The mouse button that was clicked.
  3. @{number}: The X-coordinate of the click.
  4. @{number}: The Y-coordinate of the click.

Mouse buttons

Several mouse events (@{mouse_click}, @{mouse_up}, @{mouse_scroll}) contain a "mouse button" code. This takes a numerical value depending on which button on your mouse was last pressed when this event occurred.

Button codeMouse button
1Left button
2Middle button
3Right button

Example

Print the button and the coordinates whenever the mouse is clicked.

while true do
  local event, button, x, y = os.pullEvent("mouse_click")
  print(("The mouse button %s was pressed at %d, %d"):format(button, x, y))
end