/*
 * Java-Gnome Bindings Library
 *
 * * Copyright 1998-2004 the Java-Gnome Team, all rights reserved.
 *
 * The Java-Gnome Team Members:
 *   Jean Van Wyk <jeanvanwyk@iname.com>
 *   Jeffrey S. Morgan <jeffrey.morgan@bristolwest.com>
 *   Dan Bornstein <danfuzz@milk.com>
 *
 * The Java-Gnome bindings library is free software distributed under
 * the terms of the GNU Library General Public License version 2.
 */

package org.gnu.gtk.event;
import java.io.Serializable;

import org.gnu.glib.EventType;

/**
 * @author Jeffrey S. Morgan
 *
 * The base event class for all Gtk events.
 * 
 * @see FocusEvent
 * @see KeyEvent
 * @see LifeCycleEvent
 * @see MouseEvent
 */
public class GtkEvent implements Serializable {
	/** The type of event */
	protected EventType type;

	/** The object on which the event initially occurred. */
	protected Object source;
	
	/**
	 * Construct a GtkEvent object with the specified source object and type.
	 * 
	 * @param source the object where the event originated.
	 * @param type the event type.
	 * 
	 * @throws IllegalArgumentException if the source object is null
	 */
	public GtkEvent(Object source, EventType type) {
		if (null == source)
			throw new IllegalArgumentException("null source");
		this.source = source;
		this.type = type;
	}

	/**
	 * Returns the object on which the event originally occured
	 * @return Object on which the event originally occured
	 */
	public Object getSource() {
		return source;
	}

	/**
	 * @return The type of the event.
	 */
	public EventType getType() {
		return type;
	}

	/**
	 * Generates a string representation of the event. Useful for debugging
	 * applications.
	 * @return string representation of event.
	 */
    public String toString() {
        return getClass().getName() + "[source=" + source + ",id=" + type.getName() + "]";
    }
}