Tutorials : The Java Game Development Tutorial :

Handle mouse events

I think there is no game that doesn't "interact" with the player. In our case, as a programmer, you have two possibilities to allow the player to interact with the computer: the player has to use the mouse or the keyboard. In the next two chapters I want to tell you how to handle mouse and keyboard events in an applet. Again this is much easier to do in an applet than in a real application programmed for example using Java Swing. Also you won't be able to use the things you will learn here about event handling in an application, because event handling is very different in applications. But every good book about Java tells you how to handle events in applications so I think it will be no problem for you to learn it by yourself if you need to.

Now I want to change our "ball movement" applet so that the ball changes the direction if the user clicks on the applet.

To do this you have to implement just one method in our Main class called mouseDown. This method should look like this:

// Method to handle mouse down events
public boolean mouseDown (Event e, int x, int y)
{
// Change direction
x_speed = - (x_speed);

// DON'T FORGET (although not necessary here)!!
return true;
}

Of course you can handle other events than the mouseDown event. Java makes it possible to overwrite the following methods the same way as I did above and handle other mouse events that way. Here comes a list of the methods:

1. Mouse click events:
1. public boolean mouseDown (Event e, int x, int y): handles events that occur if mouse button is pressed down
2. public boolean mouseUp (Event e, int x, int y): handles events that occur if mouse button is released again.
3. Use the variable e.clickCount to get the number of clicks performed. That's how you can handle for example double clicks! You'll see a example for this in chapter 5 ("Our first game").
2. Mouse movement:
1. public boolean mouseMove (Event e, int x, int y): handles events that occur if mouse is moved over the applet
2. public boolean mouseDrag (Event e, int x, int y): handles events that occur if mouse is moved over the applet with pressed mouse button
3. Mouse position:
1. public boolean mouseEnter(Event e, int x, int y): handles events that occur if mouse enters the applet
2. public boolean mouseExit (Event e, int x, int y): handles events that occur if mouse leaves the applet

With the help of the variables int x and int y you can get the coordinates where the event happened, which is very important for many games. Also you have to take care of the return statement "return true;" that often has no meaning for the functionality of your game but is expected by the method.

Sourcecode download
Take a look at the applet

Next chapter

How to Add Java Applets to Your Site

New on the Java Boutique:

New Review:

Time Management Made Easy with the Quartz Enterprise Job Scheduler
Why not just use the Java timer API? This open source scheduling API boasts simplicity, ease-of-integration, a well-rounded feature set, and it's free!

New Applet:

Reverse Complement
Reverse Complement is a simple applet that converts DNA or RNA sequences into three useful formats.

Elsewhere on internet.com:

WebDeveloper Java
Lots of Java information on webdeveloper.com

WDVL Java
Thorough Java resource at the Web Developer's Virtual Library.

ScriptSearch Java
Hundreds of free Java code files to download.

jGuru: Your View of the Java Universe
Customizable portal with online training, FAQs, regular news updates, and tutorials.