4 replies to this topic

[3istee]

Hello,
this tutorial shall teach the very basics about the mouse events.

Note: For this tutorial you need to know how os.pullEvent() works and what events are.
If you don't, you can look it up here:
Wiki
Forum post

mouse_click

Spoiler

Arguments: Left-/Rightclick (1/2), x, y
Triggers whenever someone clicks in the screen.

If it was a leftclick the first argument is 1, else it is 2.
X and y obviously are where the user clicked

Example:

event,arg,x,y = os.pullEvent("mouse_click")
term.setCursorPos(x,y)
write("X")

Example Use: Clickable Button

mouse_drag

Spoiler

Arguments: Left-/Rightclick (1/2), x, y

Triggers whenever someone clicks and holds a mousebutton in the screen.
Keeps triggering as long as the mouse button is held.

If it was a leftclick the first argument is 1, else it is 2.
X and y are where the user clicked/the mouse was while the button was held down.

Example:

event,arg,x,y = os.pullEvent("mouse_drag")
term.setCursorPos(x,y)
write("X")

Example Use: Painting/Games

mouse_scroll

Spoiler

Arguments: Up/Down (-1/1), x, y
Triggers whenever someone uses the mousewheel while the mouse is in the screen.

The first argument tells in which direction the user scrolled; -1 is up and 1 is down.
X and y are where the mouse was as the user scrolled.

Example:

event,arg,x,y = os.pullEvent("mouse_scroll")
term.setCursorPos(x,y)
write("X")
term.scroll(arg)

Example Use: Scrolling text ._.

[Rwkeith]

Good simple tutorial for starting a GUI.

[PixelToast]

more readable than the wiki +1

[remiX]

Mouse drag and mouse click have 3 numbers for the first argument, the middle scroll is also triggered if clicked / dragged.

[Frederikam]

Sounds simple enough, i'll give it a try at some date.