Applet.java, [...]: New versions from Classpath.

* java/applet/Applet.java, java/applet/AppletContext.java,
	java/applet/AppletStub.java, java/applet/AudioClip.java,
	java/awt/CardLayout.java,
	java/awt/ContainerOrderFocusTraversalPolicy.java,
	java/awt/Cursor.java, java/awt/Event.java, java/awt/Frame.java,
	java/awt/GridBagConstraints.java, java/awt/GridBagLayout.java,
	java/awt/GridLayout.java, java/awt/color/ColorSpace.java,
	java/awt/color/ICC_ColorSpace.java,
	java/awt/color/ICC_Profile.java,
	java/awt/color/ICC_ProfileGray.java,
	java/awt/color/ICC_ProfileRGB.java,
	java/awt/datatransfer/DataFlavor.java,
	java/awt/dnd/DragSourceContext.java, java/awt/dnd/DropTarget.java,
	java/awt/dnd/DropTargetContext.java, java/awt/event/KeyEvent.java:
	New versions from Classpath.
	* Makefile.in: Rebuilt.
	* Makefile.am (awt_java_source_files): Added ICC_ProfileGray and
	ICC_ProfileRGB.

From-SVN: r58964
This commit is contained in:
Tom Tromey 2002-11-10 00:16:43 +00:00 committed by Tom Tromey
parent adf94cac56
commit f7aa343f42
25 changed files with 1261 additions and 612 deletions

View file

@ -1,23 +1,23 @@
/* AppletContext.java -- Access the applet's runtime environment.
Copyright (C) 1999 Free Software Foundation, Inc.
/* AppletContext.java -- access the applet's runtime environment
Copyright (C) 1999, 2002 Free Software Foundation, Inc.
This file is part of GNU Classpath.
GNU Classpath is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2, or (at your option)
any later version.
GNU Classpath is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with GNU Classpath; see the file COPYING. If not, write to the
Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
02111-1307 USA.
Linking this library statically or dynamically with other modules is
making a combined work based on this library. Thus, the terms and
conditions of the GNU General Public License cover the whole
@ -39,81 +39,116 @@ exception statement from your version. */
package java.applet;
import java.awt.Image;
import java.io.InputStream;
import java.io.IOException;
import java.net.URL;
import java.util.Enumeration;
import java.util.Iterator;
/**
* This interface allows an applet access to the browser to retrieve
* additional data files and display documents. It also allows the
* applet to find out other applets in the same document.
*
* @author Aaron M. Renn (arenn@urbanophile.com)
*/
* This interface allows an applet access to the browser to retrieve
* additional data files and display documents. It also allows the
* applet to find out other applets in the same document.
*
* @author Aaron M. Renn (arenn@urbanophile.com)
* @since 1.0
* @status updated to 1.4
*/
public interface AppletContext
{
/**
* Returns an audio clip from the specified URL.
*
* @param url The URL of the audio clip.
*
* @return The retrieved audio clip // FIXME: What happens on error?
*/
* Returns an audio clip from the specified URL.
*
* @param url the URL of the audio clip
* @return the retrieved audio clip
* @throws NullPointerException if url is null
*/
AudioClip getAudioClip(URL url);
/**
* Returns an image from the specified URL. Note that the image is not
* actually retrieved until the applet attempts to display it, so this
* method returns immediately.
*
* @param url The URL of the image.
*
* @return The retrieved image. // FIXME: What happens on eror?
*/
* Returns an image from the specified URL. Note that the image is not
* actually retrieved until the applet attempts to display it, so this
* method returns immediately.
*
* @param url the absolute URL of the image
* @return the retrieved image
* @throws NullPointerException if url is null
*/
Image getImage(URL url);
/**
* Returns the applet in the document for this object that has the
* specified name.
*
* @param name The applet name.
*
* @return The requested applet, or <code>null</code> if an applet with
* the requested name cannot be found.
*/
* Returns the applet in the document for this object that has the
* specified name.
*
* @param name the applet name
* @return the requested applet, or <code>null</code> if not found
*/
Applet getApplet(String name);
/**
* Returns a list of all the applets in the document for this object.
*
* @return A list of all the applets in the document for this object.
*/
* Returns a list of all the applets in the document for this object.
*
* @return a list of all the applets
*/
Enumeration getApplets();
/**
* Displays the web page pointed to by the specified URL in the window
* for this object. This page replaces the document that is currently
* there.
*
* @param url The URL of the web page to load.
*/
* Displays the web page pointed to by the specified URL in the window
* for this object. This page replaces the document that is currently
* there.
*
* @param url the URL of the web page to load; unspecified on an error
*/
void showDocument(URL url);
/**
* Displays the web page pointed to be the sepcified URL in the window
* with the specified name. The standard names "_top", "_blank",
* "_parent", and "_self" are allowed.
*
* @param url The URL of the web page to load.
* @param target The target window.
*/
* Displays the web page pointed to be the sepcified URL in the window
* with the specified name. The standard names "_top", "_blank",
* "_parent", and "_self" are allowed. An applet viewer may disregard
* this request.
*
* @param url the URL of the web page to load
* @param target the target window
*/
void showDocument(URL url, String target);
/**
* Displays the specified message in the status window if that window
* exists.
*
* @param message The status message.
*/
* Displays the specified message in the status window if that window
* exists.
*
* @param message the status message, may be null
*/
void showStatus(String message);
/**
* Associate a stream to a key for this applet context, possibly replacing
* the old value. Stream associations are local to the applet context, for
* security purposes.
*
* @param key the key to associate with
* @param stream the stream value to tie to the key, or null to remove
* @throws IOException if the stream is too large
* @since 1.4
*/
public void setStream(String key, InputStream stream) throws IOException;
/**
* Return the stream associated with a given key in this applet context, or
* null if nothing is associated. Stream associations are local to the
* applet context, for security purposes.
*
* @param key the key to look up
* @return the associated stream, or null
* @since 1.4
*/
public InputStream getStream(String key);
/**
* Iterate over all keys that have associated streams. Sttream associated
* are local to the applet context, for security purposes.
*
* @return an iterator over the association keys
* @since 1.4
*/
public Iterator getStreamKeys();
} // interface AppletContext