ea.internal.gui

Class Fenster

java.lang.Object

java.awt.Component

java.awt.Container

java.awt.Window

java.awt.Frame

ea.internal.gui.Fenster

All Implemented Interfaces:

java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, javax.accessibility.Accessible

public class Fenster
extends java.awt.Frame

Das Fenster als Oberfenster.
In ihm fängt sich die Maus, sie kann also das Fenster nicht mehr nach dem Betreten verlassen.

Author:

Michael Andonie, Niklas Keller

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class java.awt.Frame

java.awt.Frame.AccessibleAWTFrame

Nested classes/interfaces inherited from class java.awt.Window

java.awt.Window.AccessibleAWTWindow, java.awt.Window.Type

Nested classes/interfaces inherited from class java.awt.Container

java.awt.Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

java.awt.Component.AccessibleAWTComponent, java.awt.Component.BaselineResizeBehavior, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy

Field Summary

Fields

Modifier and Type	Field and Description
static Fenster	instanz Statische Hilfsinstanz zur Vereinfachung der frameabhängigen Abfragen

Fields inherited from class java.awt.Frame

CROSSHAIR_CURSOR, DEFAULT_CURSOR, E_RESIZE_CURSOR, HAND_CURSOR, ICONIFIED, MAXIMIZED_BOTH, MAXIMIZED_HORIZ, MAXIMIZED_VERT, MOVE_CURSOR, N_RESIZE_CURSOR, NE_RESIZE_CURSOR, NORMAL, NW_RESIZE_CURSOR, S_RESIZE_CURSOR, SE_RESIZE_CURSOR, SW_RESIZE_CURSOR, TEXT_CURSOR, W_RESIZE_CURSOR, WAIT_CURSOR

Fields inherited from class java.awt.Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Constructors

Constructor and Description
Fenster(int x, int y) Einfacher Alternativkonstruktor. Erstellt ein normales Fenster mit der eingegeben Groesse.
Fenster(int breite, int hoehe, java.lang.String titel, boolean vollbild, int fensterX, int fensterY) Konstruktor fuer Objekte der Klasse Fenster.

Method Summary

Modifier and Type	Method and Description
void	anmelden(Maus m) Meldet eine Maus an. Im Gegensatz zu den TastenReagierbar-Listenern kann nur eine Maus am Fenster angemeldet sein.
void	anmelden(TastenReagierbar t) Meldet einen TastenReagierbar - Listener an.
void	druckAufheben() Deaktiviert den eventuell vorhandenen gemerkten Druck auf allen Tasten. Wird innerhalb der Engine benutzt, sobald das Fenster deaktiviert etc.
BoundingRechteck	fenstermasse() Gibt die Fenstermasse in einem BoundingRechteck an.
void	fillSimple(SimpleGraphic g) Fuellt ein simples Grafikobjekt in die anzeige.
Kamera	getCam()
Maus	getMaus() Gibt die Maus aus.
Knoten	getStatNode()
boolean	hatMaus() Testet, ob eine Maus im Spiel vorhanden ist.
void	hintergrundAnmelden(Raum hintergrund) Meldet den hintergrund dieses Fensters und damit des Spiels an. Gibt es bereits einen, so wird dieser fortan nicht mehr gezeichnet, dafuer nun dieser.
static Fenster	instanz() Gibt die aktuellste Instanz dieser KLasse wieder.
boolean	istGedrueckt(int tastencode) Überprüft, ob eine bestimmte Taste auf der Tastatur heruntergedrückt wurde.
void	loeschen() Löscht das Fenster und terminiert damit das Spiel. Daher nur dann einsetzen, wenn die Anwendung beendet werden soll!! Der vorherige Zustand ist nicht wiederherstellbar!! Als alternative Methode zum ausschliesslichen Loeschen des Fensters steht softLoeschen() zur Verfuegung.
boolean	mausBewegt() Gibt an, ob die Maus den Bildschirm bewegen kann.
Raum	mausBild() Gibt das gespeicherte Bild-Objekt der Maus wieder.
void	mausLoeschen() Loescht das Maus-Objekt des Fensters. Hatte das Fenster keine, ergibt sich selbstredend keine Aenderung.
void	maximieren() Maximiert das Fenster (bringt es aus der Taskleiste wieder auf den Bildschirm)
static java.awt.FontMetrics	metrik(java.awt.Font f) Statische Methode zum Oeffentlichen Berechnen der Fontmetriken des offenen Fensters.
void	minimieren() Minimiert das Fenster (bringt es in die Taskleiste).
void	removeMouseListener()
void	removeSimple(SimpleGraphic g) Entfernt ein simples Grafikobjekt.
void	tastenLosgelassenAnmelden(TastenLosgelassenReagierbar t) Meldet einen TastenLosgelassenReagierbar-Listener an. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!ACHTUNG!!!!!!!!!!!!!!!!!!!!!!!! !!!!!!!!!!!!!!! TastenReagierbar und TastenLosgelassenReagierbar sind 2 vollkommen unterschiedliche Interfaces! Das eine wird beim Runterdruecken, das andere beim Loslassen der Tasten aktiviert.
void	tastenLosgelassenReagierbarAnmelden(TastenLosgelassenReagierbar t) Meldet einen TastenLosgelassenReagierbar-Listener an als exakt parallele Methode zu tastenLosgelassenAnmelden(), jedoch eben ein etwas laengerer, aber vielleicht auch logischerer Name; fuehrt jedoch exakt die selbe Methode aus! !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!ACHTUNG!!!!!!!!!!!!!!!!!!!!!!!! !!!!!!!!!!!!!!! TastenReagierbar und TastenLosgelassenReagierbar sind 2 vollkommen unterschiedliche Interfaces! Das eine wird beim Runterdruecken, das andere beim Loslassen der Tasten aktiviert.
boolean	vollbild() Gibt zurueck, ob dieses Fenster ein Vollbild ist oder nicht.
Zeichner	zeichner() Gibt den Zeichner des Fensters aus.
int	zuordnen(int keyCode) Deprecated. Seit v3.0.3. Durch Taste.vonJava(int) ersetzt.

Methods inherited from class java.awt.Frame

addNotify, getAccessibleContext, getCursorType, getExtendedState, getFrames, getIconImage, getMaximizedBounds, getMenuBar, getState, getTitle, isResizable, isUndecorated, paramString, remove, removeNotify, setBackground, setCursor, setExtendedState, setIconImage, setMaximizedBounds, setMenuBar, setOpacity, setResizable, setShape, setState, setTitle, setUndecorated

Methods inherited from class java.awt.Window

addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, getBackground, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getIconImages, getInputContext, getListeners, getLocale, getModalExclusionType, getMostRecentFocusOwner, getOpacity, getOwnedWindows, getOwner, getOwnerlessWindows, getShape, getToolkit, getType, getWarningString, getWindowFocusListeners, getWindowListeners, getWindows, getWindowStateListeners, hide, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isAutoRequestFocus, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isOpaque, isShowing, isValidateRoot, pack, paint, postEvent, processEvent, processWindowEvent, processWindowFocusEvent, processWindowStateEvent, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setAutoRequestFocus, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImages, setLocation, setLocation, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setSize, setSize, setType, setVisible, show, toBack, toFront

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, setLayout, transferFocusDownCycle, update, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resize, resize, revalidate, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setMaximumSize, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.awt.MenuContainer

getFont, postEvent

Field Detail

instanz

public static Fenster instanz

Statische Hilfsinstanz zur Vereinfachung der frameabhängigen Abfragen

Constructor Detail

Fenster

public Fenster(int x,
               int y)

Einfacher Alternativkonstruktor.
Erstellt ein normales Fenster mit der eingegeben Groesse.

Parameters:

x - Die Breite

y - Die Hoehe

Fenster

public Fenster(int breite,
               int hoehe,
               java.lang.String titel,
               boolean vollbild,
               int fensterX,
               int fensterY)

Konstruktor fuer Objekte der Klasse Fenster.

Parameters:

breite - Die Breite des Fensters. (Bei erfolgreichem Vollbild die neue Standartbildschirmbreite)

hoehe - Die Hoehe des Fensters. (Bei erfolgreichem Vollbild die neue Standartbildschirmhoehe)

titel - Der Titel, der auf dem Fenster gezeigt wird (Auch bei Vollbild nicht zu sehen).Wenn kein Titel erwuenscht ist, kann ein leerer String ("") eingegeben werden.

vollbild - Ob das Fenster ein echtes Vollbild sein soll, sprich den gesamten Bildschirm ausfuellen soll und nicht mehr wie ein Fenster aussehen soll.
Es kann sein, dass Vollbild zum Beispiel aufgrund eines Veralteten Javas oder inkompatiblen PCs nicht moeglich ist, in diesem Fall wird ein normales Fenster mit den eingegeben Werten erzeugt.
Daher ist das x/y - Feld eine Pflichteingabe.

fensterX - Die X-Koordinate des Fensters auf dem Computerbildschirm.

fensterY - Die Y-Koordinate des Fensters auf dem Computerbildschirm.

Method Detail

removeMouseListener

@NoExternalUse
public void removeMouseListener()

loeschen

public void loeschen()

Löscht das Fenster und terminiert damit das Spiel.
Daher nur dann einsetzen, wenn die Anwendung beendet werden soll!! Der vorherige Zustand ist nicht wiederherstellbar!!
Als alternative Methode zum ausschliesslichen Loeschen des Fensters steht softLoeschen() zur Verfuegung.

hatMaus

public boolean hatMaus()

Testet, ob eine Maus im Spiel vorhanden ist.

Returns:

TRUE, wenn eine Maus im Spiel ist.

getCam

public Kamera getCam()

Returns:

Die Kamera, passend zu diesem Fenster

zuordnen

@Deprecated
public int zuordnen(int keyCode)

Deprecated. Seit v3.0.3. Durch Taste.vonJava(int) ersetzt.

Ordnet vom Java-KeyCode-System in das EA-System um.

Seit Version 3.0.3 ersetzt durch Taste.vonJava(int).

Parameters:

keyCode - Der Java-KeyCode

Returns:

Entsprechender EA-KeyCode oder -1, falls es keinen passenden EA-KeyCode gibt.

mausLoeschen

public void mausLoeschen()

Loescht das Maus-Objekt des Fensters.
Hatte das Fenster keine, ergibt sich selbstredend keine Aenderung.

metrik

public static java.awt.FontMetrics metrik(java.awt.Font f)

Statische Methode zum Oeffentlichen Berechnen der Fontmetriken des offenen Fensters.

Parameters:

f - Der zu ueberpruefende Font

Returns:

Das zu dem Font und aktiven Fenster gehoerende FontMetrics-Objekt

instanz

public static Fenster instanz()

Gibt die aktuellste Instanz dieser KLasse wieder.

Returns:

Das aktuellste Fenster

minimieren

public void minimieren()

Minimiert das Fenster (bringt es in die Taskleiste).

maximieren

public void maximieren()

Maximiert das Fenster (bringt es aus der Taskleiste wieder auf den Bildschirm)

vollbild

public boolean vollbild()

Gibt zurueck, ob dieses Fenster ein Vollbild ist oder nicht.

Returns:

true, wenn das Fenster ein Vollbild ist, sonst false.

hintergrundAnmelden

public void hintergrundAnmelden(Raum hintergrund)

Meldet den hintergrund dieses Fensters und damit des Spiels an.
Gibt es bereits einen, so wird dieser fortan nicht mehr gezeichnet, dafuer nun dieser. Sollten mehrere Objekte erwuenscht sein, gezeichnet zu werden, so empfiehlt es sich, diese in einem Knoten-Objekt zu sammeln und dann anzumelden.
Achtung!
Diese Objekte sollten nicht an der Physik angemeldet werden, dies fuehrt natuerlich zu ungewollten Problemen!

Parameters:

hintergrund - Der anzumeldende Hintergrund

anmelden

public void anmelden(TastenReagierbar t)

Meldet einen TastenReagierbar - Listener an.

Parameters:

t - Der neu anzumeldende Listener.

tastenLosgelassenReagierbarAnmelden

public void tastenLosgelassenReagierbarAnmelden(TastenLosgelassenReagierbar t)

Meldet einen TastenLosgelassenReagierbar-Listener an als exakt parallele Methode zu tastenLosgelassenAnmelden(), jedoch eben ein etwas laengerer, aber vielleicht auch logischerer Name; fuehrt jedoch exakt die selbe Methode aus!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!ACHTUNG!!!!!!!!!!!!!!!!!!!!!!!! !!!!!!!!!!!!!!!
TastenReagierbar und TastenLosgelassenReagierbar sind 2 vollkommen unterschiedliche Interfaces! Das eine wird beim Runterdruecken, das andere beim Loslassen der Tasten aktiviert.

See Also:

tastenLosgelassenAnmelden(TastenLosgelassenReagierbar)

tastenLosgelassenAnmelden

public void tastenLosgelassenAnmelden(TastenLosgelassenReagierbar t)

Meldet einen TastenLosgelassenReagierbar-Listener an.
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!ACHTUNG!!!!!!!!!!!!!!!!!!!!!!!! !!!!!!!!!!!!!!!
TastenReagierbar und TastenLosgelassenReagierbar sind 2 vollkommen unterschiedliche Interfaces! Das eine wird beim Runterdruecken, das andere beim Loslassen der Tasten aktiviert.

anmelden

public void anmelden(Maus m)

Meldet eine Maus an.
Im Gegensatz zu den TastenReagierbar-Listenern kann nur eine Maus am Fenster angemeldet sein.

Parameters:

m - Die anzumeldende Maus

mausBewegt

public boolean mausBewegt()

Gibt an, ob die Maus den Bildschirm bewegen kann.

Returns:

TRUE, wenn die Maus den Bildschirm bewegen kann, FALSE, wenn nicht.
Ist keine Maus angemeldet, ist das Ergebnis ebenfalls FALSE.

getStatNode

public Knoten getStatNode()

Returns:

Der Statische Basisknoten.

getMaus

public Maus getMaus()

Gibt die Maus aus.

Returns:

Die aktuelle Maus. Kann null sein!!

fenstermasse

public BoundingRechteck fenstermasse()

Gibt die Fenstermasse in einem BoundingRechteck an.

Returns:

ein BoundingRechteck mit Position (0|0), dessen Hoehe & Breite die Masse des Fensters in Pixel angeben.

See Also:

BoundingRechteck

zeichner

public Zeichner zeichner()

Gibt den Zeichner des Fensters aus.

Returns:

Der Zeichner des Fensters.

removeSimple

public void removeSimple(SimpleGraphic g)

Entfernt ein simples Grafikobjekt.

Parameters:

g - Das darzustellende Grafikobjekt

fillSimple

public void fillSimple(SimpleGraphic g)

Fuellt ein simples Grafikobjekt in die anzeige.

Parameters:

g - Das darzustellende Grafikobjekt.

mausBild

public Raum mausBild()

Gibt das gespeicherte Bild-Objekt der Maus wieder.

Returns:

Das Bild mit seiner Position und Groesse von der Maus.

druckAufheben

public void druckAufheben()

Deaktiviert den eventuell vorhandenen gemerkten Druck auf allen Tasten.
Wird innerhalb der Engine benutzt, sobald das Fenster deaktiviert etc. wurde.

istGedrueckt

public boolean istGedrueckt(int tastencode)

Überprüft, ob eine bestimmte Taste auf der Tastatur heruntergedrückt wurde.

Parameters:

tastencode - Der Code der Taste, für die getestet werden soll.

Returns:

true, falls die entsprechende Taste gerade heruntergedrückt wurde, sonst false.

Throws:

java.lang.ArrayIndexOutOfBoundsException - Sollte einen Zahl < 0 oder > 44 verwendet werden.