de.guibuilder.framework
Class GuiRootPane

java.lang.Object
  extended by java.awt.Component
      extended by java.awt.Container
          extended by javax.swing.JComponent
              extended by javax.swing.JRootPane
                  extended by de.guibuilder.framework.GuiRootPane
All Implemented Interfaces:
java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, javax.accessibility.Accessible

public final class GuiRootPane
extends javax.swing.JRootPane

Von JRootPane abgeleitete Klasse, die die Aufgaben eines Hauptfensters (Formular, Dialog, Applet, InternalFrame) übernimmt.

Der Vorteil dieser Klasse besteht darin, daß sie von (fast!) allen Komponenten über die Methode getRootPane() erreichbar ist.

Hier werden alle Fenster-bezogenen Aufgaben erledigt; alle Container-bezogenen Methoden werden an das MainPanel delegiert.

Since:
0.8a
See Also:
GuiContainer, GuiPanel, Serialized Form

Nested Class Summary
 
Nested classes/interfaces inherited from class javax.swing.JComponent
javax.swing.JComponent.AccessibleJComponent
 
Nested classes/interfaces inherited from class java.awt.Component
java.awt.Component.BaselineResizeBehavior
 
Field Summary
 
Fields inherited from class javax.swing.JRootPane
COLOR_CHOOSER_DIALOG, ERROR_DIALOG, FILE_CHOOSER_DIALOG, FRAME, INFORMATION_DIALOG, NONE, PLAIN_DIALOG, QUESTION_DIALOG, WARNING_DIALOG
 
Fields inherited from class javax.swing.JComponent
TOOL_TIP_TEXT_KEY, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
 
Fields inherited from class java.awt.Component
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
 
Method Summary
 void activateTab(java.lang.String name)
          Aktiviert die Registerkarte mit dem angegebenen Namen.
 void addToolBar(GuiToolbar tb)
          Fügt dem Fenster eine Toolbar hinzu.
 void enableTab(java.lang.String name, boolean b)
          En- oder disabled die Registerkarte mit dem angegebenen Namen.
 GuiTable getCurrentTable()
          Liefert die zuletzt angeklickte Tabelle oder null, wenn keine vorhanden oder noch nicht angeklickt wurde.
 GuiTabset getCurrentTabset()
           
 GuiTree getCurrentTree()
          Liefert die aktuelle Tree-Komponete oder null, wenn keine vorhanden.
 javax.swing.JInternalFrame getFrameByName(java.lang.String name)
          Liefert den Frame (als JInternalFrame) mit dem angegebenen Namen.
 java.util.Vector<javax.swing.JInternalFrame> getFrames()
          Liefert einen Vector aller Frames
 GuiMenuBar getGuiMenuBar()
          Liefert die MenuBar.
 java.lang.String getHelpTopic()
          Liefert den jeweiligen HelpTopic.
 GuiPanel getMainPanel()
          Liefert das HauptPanel als Wurzel für alle Komponenten außer Menü, Toolbar und StatusBar.
 electric.xml.Document getMemberDocument()
          Liefert ein XML-Document mit allen enthaltenen GuiMembers.
 java.lang.String getOid()
          Liefert die Object-Id oder null, wenn kein Dabaseobject gehalten wird.
 GuiWindow getParentWindow()
          Liefert das Hauptfenster.
 java.lang.String getRef()
           
 GuiSplit getSplit()
          Liefert ein ggf. vorhandenes SplitPanel.
 GuiLabel getStatusBar()
          Liefert die StatusBar für die Anzeige von Statustexten.
 GuiTab getTabByName(java.lang.String name)
          Liefert die Karte mit dem angegebenen Namen.
 java.util.Vector<GuiTabset> getTabsets()
          Liefert einen Vector alle Sätze von Registerkarten
 void guiHelp()
          Zeigt den gültigen HelpTopic an.
 boolean hasDesignMode()
           
 boolean isModified()
          Liefert "true", wenn sich der Inhalt des Fensters durch Benutzereingaben verändert hat.
 de.guibuilder.framework.GuiInvokationResult obj_MessageBoxEvent(GuiWindow parent, java.lang.String msgName, java.lang.String cmd)
          Bei einer MessageBox wurde ein Button gedrückt.
 void reset()
          Leert alle Componenten des Fensters.
 void setDesignMode(boolean b)
           
 void setHelpTopic(java.lang.String topic)
          Setzt den HelpTopic zum Formular.
 void setHint(java.lang.String text)
          Zeigt den übergebenen Statustext an.
 void setModified(boolean b)
          Kennzeichnet das Fenster als durch Benutzereingaben geändert.
 void setOid(java.lang.String s)
          Setzt die Object-Id; für Datenbanken; wird bei reset auf null gesetzt.
 void setRef(java.lang.String ref)
           
 void setStatusBar(GuiLabel s)
          Setzt die Statuszeile auf das gewünschte Label.
 
Methods inherited from class javax.swing.JRootPane
addNotify, getAccessibleContext, getContentPane, getDefaultButton, getGlassPane, getJMenuBar, getLayeredPane, getMenuBar, getUI, getUIClassID, getWindowDecorationStyle, isOptimizedDrawingEnabled, isValidateRoot, removeNotify, setContentPane, setDefaultButton, setDoubleBuffered, setGlassPane, setJMenuBar, setLayeredPane, setMenuBar, setUI, setWindowDecorationStyle, updateUI
 
Methods inherited from class javax.swing.JComponent
addAncestorListener, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isPaintingForPrint, isPaintingTile, isRequestFocusEnabled, paint, paintImmediately, paintImmediately, print, printAll, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update
 
Methods inherited from class java.awt.Container
add, add, add, add, add, addContainerListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusBackward, transferFocusDownCycle, validate
 
Methods inherited from class java.awt.Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, contains, createImage, createImage, createVolatileImage, createVolatileImage, dispatchEvent, enable, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusUpCycle
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Method Detail

hasDesignMode

public final boolean hasDesignMode()

setDesignMode

public final void setDesignMode(boolean b)

getGuiMenuBar

public GuiMenuBar getGuiMenuBar()
Liefert die MenuBar.

Wenn bisher kein MenuBar verwendet wurde, wird jetzt einer angelegt.

Delegation an das protected Attribut "menuBar" in JRootPane.


isModified

public boolean isModified()
Liefert "true", wenn sich der Inhalt des Fensters durch Benutzereingaben verändert hat.

See Also:
obj_ItemChanged(de.guibuilder.framework.GuiComponent, java.lang.String, java.lang.Object)

setModified

public void setModified(boolean b)
Kennzeichnet das Fenster als durch Benutzereingaben geändert.
Modified wird von allen Komponenten hier auf true gesetzt, wenn sie sich geändert haben. Ein Zurücksetzen erfolgt in der Regel nur durch reset.

See Also:
GuiComponent.setModified(boolean), reset()

getParentWindow

public GuiWindow getParentWindow()
Liefert das Hauptfenster.


addToolBar

public void addToolBar(GuiToolbar tb)
Fügt dem Fenster eine Toolbar hinzu.


getMainPanel

public GuiPanel getMainPanel()
Liefert das HauptPanel als Wurzel für alle Komponenten außer Menü, Toolbar und StatusBar.

Wirft eine IllegalStateException, wenn mainPanel unzulässiger Weise null sein sollte; vermußlich wurde zuvor dispose() aufgerufen.


getStatusBar

public GuiLabel getStatusBar()
Liefert die StatusBar für die Anzeige von Statustexten.

Wenn bisher keine StatusBar verwendet wurde, wird jetzt eine angelegt.


setStatusBar

public void setStatusBar(GuiLabel s)
Setzt die Statuszeile auf das gewünschte Label.


setHint

public void setHint(java.lang.String text)
Zeigt den übergebenen Statustext an.

Wenn noch keine Statusbar vorhanden, wird hiermit eine angelegt.


getCurrentTable

public GuiTable getCurrentTable()
Liefert die zuletzt angeklickte Tabelle oder null, wenn keine vorhanden oder noch nicht angeklickt wurde.


getCurrentTree

public GuiTree getCurrentTree()
Liefert die aktuelle Tree-Komponete oder null, wenn keine vorhanden.
Für Navigator.


getCurrentTabset

public GuiTabset getCurrentTabset()

getTabByName

public GuiTab getTabByName(java.lang.String name)
Liefert die Karte mit dem angegebenen Namen.

Vorsicht!
Wenn die Namen bei mehreren Tabsets doppelt vergeben wurden, wird die erste geliefert!

Parameters:
name -
Returns:

getTabsets

public java.util.Vector<GuiTabset> getTabsets()
Liefert einen Vector alle Sätze von Registerkarten

See Also:
de.guibuilder.design.GuiDoc

getFrameByName

public javax.swing.JInternalFrame getFrameByName(java.lang.String name)
Liefert den Frame (als JInternalFrame) mit dem angegebenen Namen.

Vorsicht!
Wenn die Namen bei mehreren Frames doppelt vergeben wurden, wird der erste geliefert!

Parameters:
name - Name des Frames, wie mit dem Attribut mit name="frame1" angegeben.
Returns:
JInternalFrame mit dem Namen. JInternalFrame als Oberklasse von GuiInternalFrameImpl. Die Oberklasse muss anstelle der GuiBuilder-Frameworkklasse geliefert werden, weil JInternalFrame.JDesktopIcon (für den Fall eines minimierten internen Fensters) keine Repräsentation im GuiBuilder-Framework hat.

getFrames

public java.util.Vector<javax.swing.JInternalFrame> getFrames()
Liefert einen Vector aller Frames


getSplit

public GuiSplit getSplit()
Liefert ein ggf. vorhandenes SplitPanel.


getMemberDocument

public electric.xml.Document getMemberDocument()
Liefert ein XML-Document mit allen enthaltenen GuiMembers.

Returns:
See Also:
GuiMember.getMemberElement(), GuiContainer.getMemberElement()

guiHelp

public void guiHelp()
Zeigt den gültigen HelpTopic an. Aus StandardFunktion "help()".

See Also:
GuiUtil.showHelp(java.net.URL, java.lang.String)

obj_MessageBoxEvent

public de.guibuilder.framework.GuiInvokationResult obj_MessageBoxEvent(GuiWindow parent,
                                                                       java.lang.String msgName,
                                                                       java.lang.String cmd)
Bei einer MessageBox wurde ein Button gedrückt.

See Also:
GuiMessageBoxEvent

setHelpTopic

public void setHelpTopic(java.lang.String topic)
Setzt den HelpTopic zum Formular.


getHelpTopic

public java.lang.String getHelpTopic()
Liefert den jeweiligen HelpTopic.


activateTab

public void activateTab(java.lang.String name)
Aktiviert die Registerkarte mit dem angegebenen Namen.


enableTab

public void enableTab(java.lang.String name,
                      boolean b)
En- oder disabled die Registerkarte mit dem angegebenen Namen.


reset

public void reset()
Leert alle Componenten des Fensters. Dabei wird die Eigenschaft "modified" auf "false" gesetzt.

Das erste editierbare Widget erhält den Focus.

See Also:
GuiContainer.reset(), isModified()

getRef

public java.lang.String getRef()

setRef

public void setRef(java.lang.String ref)

getOid

public java.lang.String getOid()
Liefert die Object-Id oder null, wenn kein Dabaseobject gehalten wird.


setOid

public void setOid(java.lang.String s)
Setzt die Object-Id; für Datenbanken; wird bei reset auf null gesetzt.

See Also:
reset()