JAVA-Doku Klassen - java.applet.Applet

JAVA - Klassen - java.applet.Applet

Startseite

JAVA - Klassen - java.applet.Applet

Die Klasse java.applet.Applet ist für die Applets zuständig, die man in eine HTML-Datei einbauen kann.

Constructor

Methoden

Vererbung

Constructor

public Applet()

Methoden

public void destroy() Die Methode public void destroy() wird automatisch aufgerufen, wenn entweder der Browser geschlossen wird bzw. auf eine andere Internet-Seite gegangen wird.
Die Methode public void destroy() wird vom Browser oder vom Appletviewer aufgerufen um das Applet zu informieren daß es "zurückgefordert" wurde und daß es alle Ressourcen (Speicher) freigeben ("zerstören") soll, die es zugeteilt bekommen hat. Vor der destroy-Methode wird immer die Methode public void stop() aufgerufen.
Ein Applet sollte diese Methode überschreiben, wenn etwas ausgeführt werden soll, bevor es "zerstört" werden soll. Z.B. ein Applet, daß mit Threads arbeitet benutzt meist die Methode public void init(), um es zu erzeugen, und die Methode public void destroy(), um es wieder zu zerstören.
Voraussetzung, daß die Methode ausgeführt werden kann, ist, daß das Applet zur Zeit (wo die Methode destroy aufgerufen werden soll) nichts ausführt.

public AppletContext getAppletContext() Die Methode public AppletContext getAppletContext() bestimmt den Applet-Kontext (Zusammenhang), welcher es dem Applet ermöglicht, Daten abzufragen und die Umgebung zu beeinflussen, in der es läuft.
Diese Umgebung des Applets beschreibt das Dokument, das das Applet beinhaltet.
Rückgabe: Applet-Kontext

public String getAppletInfo() Gibt Informationen über dieses Applet zurück. Ein Applet sollte diese Methode überschreiben, um einen String über den Autor, die Version und das Copyright des Applets zurückzugeben.
Die Ausführung von dieser Methode setzt voraus, daß von der Appletklasse null zurückgeben wird.
Rückgabe: String (Text), der Informationen über den Autor, die Version und das Copyright des Applets zurückgibt

public AudioClip getAudioClip(URL url) Gibt das AudioClip-Objekt zurück, daß durch das URL-Objekt bestimmt wird.
Diese Methode wird immer sofort gestartet, auch wenn der Audioclip nicht existiert. Wenn das Applet versucht, den Audioclip abzuspielen, werden die Daten geladen.
Parameter:
url - absolute URL welche den Ort des Audioclip festlegt
Rückgabe: Audioclip, der durch URL bestimmt wird

public AudioClip getAudioClip(URL url, String name) Gibt das AudioClip-Objekt zurück, daß durch das URL-Objekt und den Namen bestimmt wird.
Diese Methode wird immer sofort gestartet, auch wenn der Audioclip nicht existiert. Wenn das Applet versucht, den Audioclip abzuspielen, werden die Daten geladen.
Parameter:
url - absolute URL welche den Ort des Audioclip festlegt
name - der "relative" Ort des Audioclip in Beziehung zur angegebenen URL
Rückgabe: Audioclip, der durch URL bestimmt wird

public URL getCodeBase() Liefert die Basis-URL des Applets.
Rückgabe: die URL#_top_ des Applets

public URL getDocumentBase() Liefert die URL des Dokumentes, in das das Applet eingebaut ist.
Rückgabe: die URL#_top_ des Dokumentes, das das Applet enthält

public Image getImage(URL url) Gibt ein Image-Objekt zurück, das am Bildschirm ausgegeben werden kann. Die URL muß als absolut angegeben werden. Diese Methode wird immer sofort gestartet, auch wenn kein Image vorhanden ist. Sobald das Applet versucht, das Bild zu zeichnen, werden die Daten geladen. Die Methode Graphiks, die das Bild zeichnet, malt das Bild schrittweise auf den Schirm.
Parameter:
url - absolute URL welche den Ort des Image festlegt
Rückgabe: Image, das durch die URL bestimmt wird

public Image getImage(URL url, String name) Gibt ein Image-Objekt zurück, das am Bildschirm ausgegeben werden kann. Die URL muß als absolut angegeben werden. Diese Methode wird immer sofort gestartet, auch wenn kein Image vorhanden ist. Sobald das Applet versucht, das Bild zu zeichnen, werden die Daten geladen. Die Methode Graphiks, die das Bild zeichnet, malt das Bild schrittweise auf den Schirm.
Parameter:
url - absolute URL welche den Ort des Image festlegt
name - der "relative" Ort des Image in Beziehung zur angegebenen URL
Rückgabe: Image, das durch die URL bestimmt wird

public Locale getLocale() Gibt den Ort des Applet zurück, sofern diese festgelegt wurde. Wenn kein Ort eingestellt wurde, wird der voreingestellte Ort zurückgegeben.
Rückgabe: Ort des Applets
Überschreibt: die Methode getLocale der Klasse java.awt.Component

public String getParameter(String name) Gibt den Wert (value) des genannten Parameters im HTML-tag zurück. Z.B.
<applet code="Clock.class" width=50 height=50> <param name=Color value="blue"> </applet>
Der Name des Parameters ist "Color" und der Wert ist "blue".
Die angegebenen Werte sind nicht case sensitive. Der Parameterwert wird als String eingelesen, auch wenn eine Zahl angegeben wurde.
Parameter:
name - der Parametername
Rückgabe: Wert des Parameters

public String[][] getParameterInfo() Liefert Informationen über die Parameter zurück, um das Applet anwenden zu können. Ein Applet sollte diese Methode überschreiben, um ein Array von Strings (Texten), die die Paramter beschreiben, zurückzugeben.
Jedes Element des Arrays sollte drei Strings enthalten, die den Namen, den Typ und eine Beschreibung enthalten, z.B.
String pinfo[][] = { {"fps", "1-10", "frames per second"}, {"repeat", "boolean", "repeat image loop"}, {"imgs", "url", "../../images directory"} };
Die Ausführung der Methode setzt voraus, daß das Applet Null zurückgibt.
Rückgabe: ein Array, das die Parameter des Applets beschreibt, die gebraucht werden

public void init() Die Methode public void init() wird vom Browser oder vom Appletviewer aufgerufen und informiert das Applet, daß es ins System geladen wurde. Die Methode wird immer als erstes gestartet, noch vor der Methode public void start().
In ihr wird alles geladen, was beim Starten vorhanden sein muß. Dazu zählen z.B. Parameter, Bilder, Musikdateien, grafische Objekte (Buttons, Checkboxen usw.) uvm.
Voraussetzung, daß die Methode ausgeführt werden kann, ist, daß das Applet zur Zeit nichts ausführt.

public boolean isActive() Legt fest, ob das Applet aktiv ist. Ein Applet wird aktiviert noch bevor die Methode public void start() aufgerufen wird. Es wird inaktiv, bevor die Methode public void stop() ausgeführt wird.
Rückgabe: true, wenn das Applet aktiv, und false, wenn das Applet inaktiv ist

public static final AudioClip newAudioClip(URL url) Lädt ein Audioclip von der angegebenen URL.
Parameter:
url - zeigt auf den Audioclip
Rückgabe: Audioclip, der durch die URL festgelegt wurde

public void play(URL url) Spielt den Audioclip, der durch die URL festgelegt wurde. Es passiert nichts, wenn der Audioclip nicht gefunden wird.
Parameter:
url - absolute URL, die den Ort des Audioclip angibt

public void play(URL url, String name) Spielt den Audioclip, der durch die URL festgelegt wurde. Es passiert nichts, wenn der Audioclip nicht gefunden wird.
Parameter:
url - absolute URL, die den Ort des Audioclip angibt
name - Ort des Audioclip, relativ zur angegebenen URL

public void resize(Dimension d) Ändert die Größe des Applets.
Parameter:
d - Dimension-Objekt, das die neuen Maße angbibt
Überschreibt: Methode resize der Klasse java.awt.Component

public void resize(int width, int height) Ändert die Größe des Applets.
Parameter:
width - neue Breite des Applets
height - neue Höhe des Applets
Überschreibt: Methode resize der Klasse java.awt.Component

public final void setStub(AppletStub stub) Fügt den Rumpf des Applets ein. Diese Methode wird automatisch vom System aufgerufen.
Parameter:
stub - der neue Rumpf

public void showStatus(String msg) Mit der Methode public void showStatus(String msg) wird der String msg in der Statusleiste des Browser oder des Appletviewers angezeigt. Diese Statusleiste befindet sich meistens am unteren Rand. Mit der Methode kann ein aktueller Status angezeigt werden.
Parameter:
msg - Text, der in der Statusleiste ausgeben werden soll.

public void start() Die Methode public void start() wird vom Browser oder vom Appletviewer aufgerufen und teilt dem Applet mit, daß es starten soll (d.h. mit den Ausführungen beginnen soll). start() wird nach der Methode public void init() und immer wenn die die Internet-Seite wieder besucht wird aufgerufen.
Ein Applet sollte diese Methode überschreiben, immer wenn es etwas ausführen möchte sobald die Internetseite angesehen wird, z.B. wenn eine Animation wieder gestartet werden soll und sie vorher mit der Methode stop() angehalten wurde.
Voraussetzung, daß die Methode ausgeführt wird, ist, daß das Applet gerade nichts macht.

public void stop() Die Methode public void stop() wird vom Browser oder vom Appletviewer aufgerufen und teilt dem Applet mit, daß es anhalten soll (d.h. die Ausführungen beenden). stop() wird aufgerufen, sobald eine andere Internet-Seite aufgerufen wird, die das Applet nicht mehr beinhaltet. Sie wird noch vor der Methode public void destroy() ausgeführt.
Ein Applet sollte diese Methode überschreiben, immer wenn es etwas ausführen möchte sobald die Internetseite verlassen wird, z.B. wenn eine Animation angehalten werden soll, die vorher mit der Methode start() aufgerufen wurde.
Voraussetzung, daß die Methode ausgeführt wird, ist, daß das Applet gerade nichts macht.

Vererbung

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--java.awt.Panel
                    |
                    +--java.applet.Applet

Brit Schröter

public void destroy()	Die Methode public void destroy() wird automatisch aufgerufen, wenn entweder der Browser geschlossen wird bzw. auf eine andere Internet-Seite gegangen wird. Die Methode public void destroy() wird vom Browser oder vom Appletviewer aufgerufen um das Applet zu informieren daß es "zurückgefordert" wurde und daß es alle Ressourcen (Speicher) freigeben ("zerstören") soll, die es zugeteilt bekommen hat. Vor der destroy-Methode wird immer die Methode public void stop() aufgerufen. Ein Applet sollte diese Methode überschreiben, wenn etwas ausgeführt werden soll, bevor es "zerstört" werden soll. Z.B. ein Applet, daß mit Threads arbeitet benutzt meist die Methode public void init(), um es zu erzeugen, und die Methode public void destroy(), um es wieder zu zerstören. Voraussetzung, daß die Methode ausgeführt werden kann, ist, daß das Applet zur Zeit (wo die Methode destroy aufgerufen werden soll) nichts ausführt.
public AppletContext getAppletContext()	Die Methode public AppletContext getAppletContext() bestimmt den Applet-Kontext (Zusammenhang), welcher es dem Applet ermöglicht, Daten abzufragen und die Umgebung zu beeinflussen, in der es läuft. Diese Umgebung des Applets beschreibt das Dokument, das das Applet beinhaltet. Rückgabe: Applet-Kontext
public String getAppletInfo()	Gibt Informationen über dieses Applet zurück. Ein Applet sollte diese Methode überschreiben, um einen String über den Autor, die Version und das Copyright des Applets zurückzugeben. Die Ausführung von dieser Methode setzt voraus, daß von der Appletklasse null zurückgeben wird. Rückgabe: String (Text), der Informationen über den Autor, die Version und das Copyright des Applets zurückgibt
public AudioClip getAudioClip(URL url)	Gibt das AudioClip-Objekt zurück, daß durch das URL-Objekt bestimmt wird. Diese Methode wird immer sofort gestartet, auch wenn der Audioclip nicht existiert. Wenn das Applet versucht, den Audioclip abzuspielen, werden die Daten geladen. Parameter: url - absolute URL welche den Ort des Audioclip festlegt Rückgabe: Audioclip, der durch URL bestimmt wird
public AudioClip getAudioClip(URL url, String name)	Gibt das AudioClip-Objekt zurück, daß durch das URL-Objekt und den Namen bestimmt wird. Diese Methode wird immer sofort gestartet, auch wenn der Audioclip nicht existiert. Wenn das Applet versucht, den Audioclip abzuspielen, werden die Daten geladen. Parameter: url - absolute URL welche den Ort des Audioclip festlegt name - der "relative" Ort des Audioclip in Beziehung zur angegebenen URL Rückgabe: Audioclip, der durch URL bestimmt wird
public URL getCodeBase()	Liefert die Basis-URL des Applets. Rückgabe: die URL#_top_ des Applets
public URL getDocumentBase()	Liefert die URL des Dokumentes, in das das Applet eingebaut ist. Rückgabe: die URL#_top_ des Dokumentes, das das Applet enthält
public Image getImage(URL url)	Gibt ein Image-Objekt zurück, das am Bildschirm ausgegeben werden kann. Die URL muß als absolut angegeben werden. Diese Methode wird immer sofort gestartet, auch wenn kein Image vorhanden ist. Sobald das Applet versucht, das Bild zu zeichnen, werden die Daten geladen. Die Methode Graphiks, die das Bild zeichnet, malt das Bild schrittweise auf den Schirm. Parameter: url - absolute URL welche den Ort des Image festlegt Rückgabe: Image, das durch die URL bestimmt wird
public Image getImage(URL url, String name)	Gibt ein Image-Objekt zurück, das am Bildschirm ausgegeben werden kann. Die URL muß als absolut angegeben werden. Diese Methode wird immer sofort gestartet, auch wenn kein Image vorhanden ist. Sobald das Applet versucht, das Bild zu zeichnen, werden die Daten geladen. Die Methode Graphiks, die das Bild zeichnet, malt das Bild schrittweise auf den Schirm. Parameter: url - absolute URL welche den Ort des Image festlegt name - der "relative" Ort des Image in Beziehung zur angegebenen URL Rückgabe: Image, das durch die URL bestimmt wird
public Locale getLocale()	Gibt den Ort des Applet zurück, sofern diese festgelegt wurde. Wenn kein Ort eingestellt wurde, wird der voreingestellte Ort zurückgegeben. Rückgabe: Ort des Applets Überschreibt: die Methode getLocale der Klasse *java.awt.Component*
public String getParameter(String name)	Gibt den Wert (value) des genannten Parameters im HTML-tag zurück. Z.B. <applet code="Clock.class" width=50 height=50> <param name=Color value="blue"> </applet> Der Name des Parameters ist "Color" und der Wert ist "blue". Die angegebenen Werte sind nicht case sensitive. Der Parameterwert wird als String eingelesen, auch wenn eine Zahl angegeben wurde. Parameter: name - der Parametername Rückgabe: Wert des Parameters
public String[][] getParameterInfo()	Liefert Informationen über die Parameter zurück, um das Applet anwenden zu können. Ein Applet sollte diese Methode überschreiben, um ein Array von Strings (Texten), die die Paramter beschreiben, zurückzugeben. Jedes Element des Arrays sollte drei Strings enthalten, die den Namen, den Typ und eine Beschreibung enthalten, z.B. String pinfo[][] = { {"fps", "1-10", "frames per second"}, {"repeat", "boolean", "repeat image loop"}, {"imgs", "url", "../../images directory"} }; Die Ausführung der Methode setzt voraus, daß das Applet Null zurückgibt. Rückgabe: ein Array, das die Parameter des Applets beschreibt, die gebraucht werden
public void init()	Die Methode public void init() wird vom Browser oder vom Appletviewer aufgerufen und informiert das Applet, daß es ins System geladen wurde. Die Methode wird immer als erstes gestartet, noch vor der Methode public void start(). In ihr wird alles geladen, was beim Starten vorhanden sein muß. Dazu zählen z.B. Parameter, Bilder, Musikdateien, grafische Objekte (Buttons, Checkboxen usw.) uvm. Voraussetzung, daß die Methode ausgeführt werden kann, ist, daß das Applet zur Zeit nichts ausführt.
public boolean isActive()	Legt fest, ob das Applet aktiv ist. Ein Applet wird aktiviert noch bevor die Methode public void start() aufgerufen wird. Es wird inaktiv, bevor die Methode public void stop() ausgeführt wird. Rückgabe: true, wenn das Applet aktiv, und false, wenn das Applet inaktiv ist
public static final AudioClip newAudioClip(URL url)	Lädt ein Audioclip von der angegebenen URL. Parameter: url - zeigt auf den Audioclip Rückgabe: Audioclip, der durch die URL festgelegt wurde
public void play(URL url)	Spielt den Audioclip, der durch die URL festgelegt wurde. Es passiert nichts, wenn der Audioclip nicht gefunden wird. Parameter: url - absolute URL, die den Ort des Audioclip angibt
public void play(URL url, String name)	Spielt den Audioclip, der durch die URL festgelegt wurde. Es passiert nichts, wenn der Audioclip nicht gefunden wird. Parameter: url - absolute URL, die den Ort des Audioclip angibt name - Ort des Audioclip, relativ zur angegebenen URL
public void resize(Dimension d)	Ändert die Größe des Applets. Parameter: d - Dimension-Objekt, das die neuen Maße angbibt Überschreibt: Methode resize der Klasse *java.awt.Component*
public void resize(int width, int height)	Ändert die Größe des Applets. Parameter: width - neue Breite des Applets height - neue Höhe des Applets Überschreibt: Methode resize der Klasse *java.awt.Component*
public final void setStub(AppletStub stub)	Fügt den Rumpf des Applets ein. Diese Methode wird automatisch vom System aufgerufen. Parameter: stub - der neue Rumpf
public void showStatus(String msg)	Mit der Methode public void showStatus(String msg) wird der String msg in der Statusleiste des Browser oder des Appletviewers angezeigt. Diese Statusleiste befindet sich meistens am unteren Rand. Mit der Methode kann ein aktueller Status angezeigt werden. Parameter: msg - Text, der in der Statusleiste ausgeben werden soll.
public void start()	Die Methode public void start() wird vom Browser oder vom Appletviewer aufgerufen und teilt dem Applet mit, daß es starten soll (d.h. mit den Ausführungen beginnen soll). start() wird nach der Methode public void init() und immer wenn die die Internet-Seite wieder besucht wird aufgerufen. Ein Applet sollte diese Methode überschreiben, immer wenn es etwas ausführen möchte sobald die Internetseite angesehen wird, z.B. wenn eine Animation wieder gestartet werden soll und sie vorher mit der Methode stop() angehalten wurde. Voraussetzung, daß die Methode ausgeführt wird, ist, daß das Applet gerade nichts macht.
public void stop()	Die Methode public void stop() wird vom Browser oder vom Appletviewer aufgerufen und teilt dem Applet mit, daß es anhalten soll (d.h. die Ausführungen beenden). stop() wird aufgerufen, sobald eine andere Internet-Seite aufgerufen wird, die das Applet nicht mehr beinhaltet. Sie wird noch vor der Methode public void destroy() ausgeführt. Ein Applet sollte diese Methode überschreiben, immer wenn es etwas ausführen möchte sobald die Internetseite verlassen wird, z.B. wenn eine Animation angehalten werden soll, die vorher mit der Methode start() aufgerufen wurde. Voraussetzung, daß die Methode ausgeführt wird, ist, daß das Applet gerade nichts macht.