Class Greenfoot

java.lang.Object
  extended by Greenfoot

public class Greenfoot
extends Object

Diese Dienstklasse stellt Methoden zum Kontrollieren und Interagieren mit dem System bereit. So können z.B. die Tastatureingaben und die Mausaktionen abgefragt werden.

Version:
2.0
Author:
Gunnar Johannesmeyer

Constructor Summary
Greenfoot()
          Der Konstruktor.
 
Method Summary
static void delay(int time)
          Verzögert die aktuellen Ausführung um die angegebenen Zeitschritte.
static String getKey()
          Liefert die zuletzt gedrückte Taste zurück (seit dem letzten Aufruf).
static Mouseinfo getMouseInfo()
          Liefert ein Objekt Mouseinfo zurück, welches Informationen über den Status der Maus enthält.
static int getRandomNumber(int limit)
          Liefert eine Zufallszahl zwischen 0 (inklusive) und limit (exklusiv) zurück.
static boolean isKeyDown(String keyName)
          Abfrage, ob eine bestimmte Taste zurzeit gedrückt ist.
static boolean mouseClicked(Object obj)
          Ist true, wenn mit der Maus auf ein im Parameter übergebenes Objekt geklickt (heißt: gedrückt und losgelassen) wurde.
static boolean mouseDragEnded(Object obj)
          Ist wahr, wenn ein Verschieben eines Objektes beendet wurde.
static boolean mouseDragged(Object obj)
          Ist wahr, wenn die Maus auf dem angegebenen Objekt verschoben wurde.
static boolean mouseMoved(Object obj)
          Ist wahr, wenn die Maus auf dem angegebenen Objekt bewegt wurde.
static boolean mousePressed(Object obj)
          Ist wahr, wenn die Maus auf dem angegebene Objekt gedrückt wurde (Veränderung vom nicht gedrücktem Zustand in den gedrückten Zustand).
static void playSound(String soundFile)
          Spielt eine Sounddatei ab.
static void setSpeed(int speed)
          Legt die Ausführungsgeschwindigkeit fest.
static void start()
          Startet die Ausführung des Programms bzw. nimmt deren Ausführung wieder auf.
static void stop()
          Pausiert die Ausführung des Programms.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

Greenfoot

public Greenfoot()
Der Konstruktor. Wird automatisch von der Greenfoot-Entwicklungsumgebung aufgerufen.

Method Detail

delay

public static void delay(int time)
Verzögert die aktuellen Ausführung um die angegebenen Zeitschritte. Die Länge eines Zeitschrittes ist in der Greenfoot-Entwicklungsumgebung definiert (der Geschwindigkeitsschieber). Beachte: Der Befehl kann auch dazu verwendet werden, die Greenfootwelt neu zu zeichnen. (Standardmäßig werden erst die 'act' Methoden aller Objekte durchlaufen und anschließend die Welt neu gezeichnet).

See Also:
setSpeed(int)

getKey

public static String getKey()
Liefert die zuletzt gedrückte Taste zurück (seit dem letzten Aufruf). Wenn seit dem letzten Aufruf der Methode keine Taste gedrückt wurde, wird null zurückgegeben. Wenn mehr als eine Taste gedrückt wurde, wird nur die als letztes gedrückte Taste zurückgeliefert.

Returns:
Der Name der zuletzt gedrückten Taste

getMouseInfo

public static Mouseinfo getMouseInfo()
Liefert ein Objekt Mouseinfo zurück, welches Informationen über den Status der Maus enthält.

Returns:
Information über den aktuellen Status der Maus. Oder null, wenn nichts seit der letzten Überprüfung mit der Maus passiert ist.

getRandomNumber

public static int getRandomNumber(int limit)
Liefert eine Zufallszahl zwischen 0 (inklusive) und limit (exklusiv) zurück.

isKeyDown

public static boolean isKeyDown(String keyName)
Abfrage, ob eine bestimmte Taste zurzeit gedrückt ist.

Schlüsselnamen für Tastaturabfrage

Die Methoden getKey() und isKeyDown() werden dafür benutzt, um Tastatureingaben abzufragen. Die Tastatureingaben werden mit folgenden Schlüsselworten beschrieben (die Anfrage getKey() liefern die Schlüsselnamen zurück, isKeyDown() kann entscheiden, ob die zugeordnete Taste gedrückt wurde):

Parameters:
keyName - Der Name der zu überprüfenden Taste (siehe Schlüsselnamen).
Returns:
true, wenn die Taste gedrückt wird, ansonsten false.

mouseClicked

public static boolean mouseClicked(Object obj)
Ist true, wenn mit der Maus auf ein im Parameter übergebenes Objekt geklickt (heißt: gedrückt und losgelassen) wurde. Wenn der Parameter vom Typ Actor ist, wird nur dann true zurückgeliefert, wenn mit der Maus auf das übergebene Objekt geklickt wurde. Wenn sich mehrere Objekte auf derselben Position befinden, wird nur das Objekt, welches sich am weitesten oben befindet, den Mausklick erreichen. Wenn das Objekt World als Parameter übergeben wird, wird nur dann true zurückgeliefert, wenn mit der Maus auf den Hintergrund der Welt geklickt wurde. Wenn der Parameter null ist, wird immer dann true zurückgeliefert, wenn die Maustaste geklickt wurde, unabhängig davon, ob ein Objekt getroffen wurde oder nicht.

Parameters:
obj - Normalerweise ein Actor, die World oder null.
Returns:
true, wenn die Maustaste geklickt (gedrückt und losgelassen) wurde, anderenfalls false.

mouseDragEnded

public static boolean mouseDragEnded(Object obj)
Ist wahr, wenn ein Verschieben eines Objektes beendet wurde. Dies ist dann der Fall, wenn die Maus mit gedrückter Maustaste verschoben wurde und anschließend die Maustaste losgelassen wurde. Wenn der Übergabewert ein Actor ist, wird nur dann true zurückgeliefert, wenn das Verschieben auf dem angegebenen Objekt auch gestartet wurde. Wenn sind mehrere Objekte auf derselben Position befinden, wird nur das Objekt, welches sich am weitesten oben befindet, den Mausdruck erreichen. Wenn das Objekt World als Parameter übergeben wird, wird nur dann true zurückgeliefert, wenn das Verschieben der Maus auf dem Hintergrund der Welt gestartet wurde. Wenn der Parameter null ist, wird immer dann true zurückgeliefert, wenn die Maustaste gedrückt wurde, unabhängig davon, ob ein Objekt getroffen wurde oder nicht.

Parameters:
obj - Normalerweise ein Actor, die World oder null.
Returns:
true, wenn die Maus mit gedrückter Maustaste verschoben wurde (siehe Beschreibung oben), anderenfalls false.

mouseDragged

public static boolean mouseDragged(Object obj)
Ist wahr, wenn die Maus auf dem angegebenen Objekt verschoben wurde. Dazu muss das Verschieben der Maus bei gedrückter Maustaste auf einem Objekt beginnen. Die Maus kann bei gedrückter Maustaste auf außerhalb des Objektes bewegt werden. Das Verschieben endet erst beim Loslassen der Maustaste. Wenn der Übergabewert ein Actor ist, wird nur dann true zurückgeliefert, wenn das Verschieben auf dem angegebenen Objekt auch gestartet wurde. Wenn sich mehrere Objekte auf derselben Position befinden, wird nur das Objekt, welches sich am weitesten oben befindet, den Mausdruck erreichen. Wenn das Objekt World als Parameter übergeben wird, wird nur dann true zurückgeliefert, wenn das Verschieben der Maus auf den Hintergrund der Welt gestartet wurde. Wenn der Parameter null ist, wird immer dann true zurückgeliefert, wenn die Maustaste gedrückt wurde, unabhängig davon, ob ein Objekt getroffen wurde oder nicht.

Parameters:
obj - Normalerweise ein Actor, die World oder null.
Returns:
true, wenn die Maus mit gedrückter Maustaste verschoben wurde (siehe Beschreibung oben), anderenfalls false.

mouseMoved

public static boolean mouseMoved(Object obj)
Ist wahr, wenn die Maus auf dem angegebenen Objekt bewegt wurde. Wenn der Übergabewert ein Actor ist, wird nur dann true zurückgeliefert, wenn die Maus auf dem angegebenen Objekt bewegt wird. Wenn sich mehrere Objekte auf derselben Position befinden, wird nur das Objekt, welches sich am weitesten oben befindet, die Mausbewegung erreichen. Wenn das Objekt World als Parameter übergeben wird, wird nur dann true zurückgeliefert, wenn die Maus auf den Hintergrund der Welt bewegt wurde. Wenn der Parameter null ist, wird immer dann true zurückgeliefert, wenn die Maus bewegt wurde, unabhängig davon, ob sich ein Objekt unter Maus befand oder nicht.

Parameters:
obj - Normalerweise ein Actor, die World oder null.
Returns:
true, wenn die Maus bewegt wurde (siehe Beschreibung oben), anderenfalls false.

mousePressed

public static boolean mousePressed(Object obj)
Ist wahr, wenn die Maus auf dem angegebene Objekt gedrückt wurde (Veränderung vom nicht gedrücktem Zustand in den gedrückten Zustand). Wenn der Parameter ein Actor ist, wird nur dann true zurückgeliefert, wenn mit der Maus auf das übergebenen Objekt gedrückt wurde. Wenn sich mehrere Objekte auf derselben Position befinden, wird nur das Objekt, welches sich am weitesten oben befindet, den Mausklick erreichen. Wenn das Objekt World als Parameter übergeben wird, wird nur dann true zurückgeliefert, wenn mit der Maus auf den Hintergrund der Welt gedrückt wurde. Wenn der Parameter null ist, wird immer dann true zurückgeliefert, wenn die Maustaste gedrückt wurde, unabhängig davon, ob ein Objekt getroffen wurde oder nicht.

Parameters:
obj - Normalerweise ein Actor, die World oder null.
Returns:
true, wenn die Maustaste gedrückt wurde (siehe Beschreibung oben), anderenfalls false.

playSound

public static void playSound(String soundFile)
Spielt eine Sounddatei ab. Die folgenden Formate werden unterstützt: AIFF, AU und WAV. Groß- und Kleinschreibung werden unterschieden. Der Dateiname kann angegeben werden

Parameters:
filename - Normalerweise (siehe oben) der Name der Datei im Ordner Sound des Projektordners.
Throws:
IllegalArgumentException - Wenn die Datei nicht geladen werden konnte.

setSpeed

public static void setSpeed(int speed)
Legt die Ausführungsgeschwindigkeit fest.

Parameters:
speed - Die neue Ausführungsgeschwindigkeit: Der Wert muss im Bereich 1 bis 100 liegen.

start

public static void start()
Startet die Ausführung des Programms bzw. nimmt deren Ausführung wieder auf.

stop

public static void stop()
Pausiert die Ausführung des Programms.