bundles/org.eclipse.draw2d/src/org/eclipse/draw2d/InputEvent.java

/*******************************************************************************
 * Copyright (c) 2000, 2010 IBM Corporation and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *     IBM Corporation - initial API and implementation
 *******************************************************************************/
package org.eclipse.draw2d;

import org.eclipse.draw2d.rap.swt.SWT;

/**
 * The base class for Draw2d events.
 */
public abstract class InputEvent extends java.util.EventObject {

	private int state;

	private boolean consumed = false;

	/** @see SWT#ALT */
	public static final int ALT = SWT.ALT;
	/** @see SWT#CONTROL */
	public static final int CONTROL = SWT.CONTROL;
	/** @see SWT#SHIFT */
	public static final int SHIFT = SWT.SHIFT;
	/** @see SWT#BUTTON1 */
	public static final int BUTTON1 = SWT.BUTTON1;
	/** @see SWT#BUTTON2 */
	public static final int BUTTON2 = SWT.BUTTON2;
	/** @see SWT#BUTTON3 */
	public static final int BUTTON3 = SWT.BUTTON3;
	/** @see SWT#BUTTON4 */
	public static final int BUTTON4 = SWT.BUTTON4;
	/** @see SWT#BUTTON5 */
	public static final int BUTTON5 = SWT.BUTTON5;
	/**
	 * A bitwise OR'ing of {@link #BUTTON1}, {@link #BUTTON2}, {@link #BUTTON3},
	 * {@link #BUTTON4} and {@link #BUTTON5}
	 */
	public static final int ANY_BUTTON = SWT.BUTTON_MASK;

	/**
	 * Constructs a new InputEvent.
	 * 
	 * @param dispatcher
	 *            the event dispatcher
	 * @param source
	 *            the source of the event
	 * @param state
	 *            the state
	 */
	public InputEvent(EventDispatcher dispatcher, IFigure source, int state) {
		super(source);
		this.state = state;
	}

	/**
	 * Marks this event as consumed so that it doesn't get passed on to other
	 * listeners.
	 */
	public void consume() {
		consumed = true;
	}

	/**
	 * Returns the event statemask, which is a bitwise OR'ing of any of the
	 * following: {@link #ALT}, {@link #CONTROL}, {@link #SHIFT},
	 * {@link #BUTTON1}, {@link #BUTTON2}, {@link #BUTTON3}, {@link #BUTTON4}
	 * and {@link #BUTTON5}.
	 * 
	 * @return the state
	 */
	public int getState() {
		return state;
	}

	/**
	 * @return whether this event has been consumed.
	 */
	public boolean isConsumed() {
		return consumed;
	}

}