javax.rad.application.genui
Class Application

java.lang.Object
  javax.rad.genui.UIResource<C>
      javax.rad.genui.UIComponent<C>
          javax.rad.genui.UIContainer<IPanel>
              javax.rad.genui.container.UIPanel
                  javax.rad.application.genui.Content
                      javax.rad.application.genui.ControllerContent
                          javax.rad.application.genui.Application

All Implemented Interfaces:

IApplication, IContent, IMessageConstants, IControl, IControllable, IController, ITranslatable, IPanel, IComponent, IContainer, IResource, INamedObject

Direct Known Subclasses:

RemoteApplication

public abstract class Application
extends ControllerContent
implements IApplication

The Application is an abstract implementation of IApplication. It only implements the methods for loading and creating classes.

Field Summary

static String

PARAM_SETUP_CLASS the parameter name for the setup class.

Fields inherited from class javax.rad.genui.container.UIPanel

imgBack

Fields inherited from class javax.rad.genui.UIContainer

components

Fields inherited from class javax.rad.genui.UIComponent

bTranslate, lLastTranslationModified, parent, popupMenu

Fields inherited from class javax.rad.genui.UIResource

uiResource

Fields inherited from interface javax.rad.application.IMessageConstants

MESSAGE_BUTTON_OK, MESSAGE_BUTTON_OK_CANCEL, MESSAGE_BUTTON_YES_NO, MESSAGE_ICON_ERROR, MESSAGE_ICON_INFO, MESSAGE_ICON_QUESTION, MESSAGE_ICON_WARNING

Fields inherited from interface javax.rad.model.ui.IController

PROPERTY_SEARCH_VISIBLE

Fields inherited from interface javax.rad.model.ui.IControllable

COMMAND_DELETE, COMMAND_DUPLICATE, COMMAND_EDIT, COMMAND_EXPORT, COMMAND_FIRST, COMMAND_INSERT, COMMAND_INSERT_SUB, COMMAND_LAST, COMMAND_NEXT, COMMAND_PREVIOUS, COMMAND_RESTORE, COMMAND_SEARCH

Constructor Summary

Application(UILauncher pLauncher)
Creates a new instance of Application with a desired launcher.

Method Summary

IContainer	getApplicationPane() Gets the standard application pane where the content will be added.
Object	getControllerProperty(String pName) Gets the current value of the given controller property.
ICursor	getCursor() Gets the cursor from the launcher.
UILauncher	getLauncher() Returns the platform independent launcher which is associated with this factory.
protected IApplicationSetup	getSetup() Gets the application setup, if used.
void	notifyDestroy() Cancels all pending launcher threads.
void	setCursor(ICursor pCursor) Sets the cursor of the launcher.
protected void	setLauncher(UILauncher pLauncher) Sets the launcher.
<OP> IContent	showError(OP pOpener, String pMessage) Shows a message with the IMessageConstants.MESSAGE_ICON_ERROR icon and the IMessageConstants.MESSAGE_BUTTON_OK button.
<OP> IContent	showError(OP pOpener, String pMessage, String pOkAction) Shows a message with the IMessageConstants.MESSAGE_ICON_ERROR icon and the IMessageConstants.MESSAGE_BUTTON_OK button.
<OP> IContent	showInformation(OP pOpener, String pMessage) Shows a message with the IMessageConstants.MESSAGE_ICON_INFO icon and the IMessageConstants.MESSAGE_BUTTON_OK button.
<OP> IContent	showInformation(OP pOpener, String pMessage, String pOkAction) Shows a message with the IMessageConstants.MESSAGE_ICON_INFO icon and the IMessageConstants.MESSAGE_BUTTON_OK button.
<OP> IContent	showQuestion(OP pOpener, String pMessage, String pOkAction) Shows a message with the IMessageConstants.MESSAGE_ICON_QUESTION icon and the IMessageConstants.MESSAGE_BUTTON_YES_NO buttons.
<OP> IContent	showQuestion(OP pOpener, String pMessage, String pOkAction, String pCancelAction) Shows a message with the IMessageConstants.MESSAGE_ICON_QUESTION icon and the IMessageConstants.MESSAGE_BUTTON_YES_NO buttons.

Methods inherited from class javax.rad.application.genui.ControllerContent

addNotify, cancelEditing, doActiveControlChanged, doActiveControllableChanged, doActiveDataBookChanged, doCommand, doConfigureCommandButtons, doDelete, doDuplicate, doEdit, doExport, doFirst, doInsert, doInsertSub, doLast, doNext, doNotifyController, doPrevious, doRestore, doSearch, getActiveControl, getActiveControllable, getActiveDataBook, getCommandButtons, getController, getRegisteredCommands, isCommandEnabled, isDeleteEnabled, isDuplicateEnabled, isEditEnabled, isExportEnabled, isFirstEnabled, isInsertEnabled, isInsertSubEnabled, isLastEnabled, isNextEnabled, isPreviousEnabled, isRestoreEnabled, isSearchEnabled, notifyRepaint, registerCommandButton, removeNotify, saveEditing, setActiveControllable, setController, setControllerProperty, unregisterAllCommandButtons, unregisterCommandButton, unregisterCommandButton

Methods inherited from class javax.rad.application.genui.Content

createComponentName, getOpener, notifyVisible, setOpener

Methods inherited from class javax.rad.genui.container.UIPanel

getBackgroundImage, setBackgroundImage

Methods inherited from class javax.rad.genui.UIContainer

add, add, add, add, beforeAddNotify, checkAdd, getComponent, getComponentCount, getLayout, indexOf, remove, remove, removeAll, setLayout, setZOrder, updateTranslation

Methods inherited from class javax.rad.genui.UIComponent

capture, createCellFormatter, createComponentNamePrefix, createNodeFormatter, debug, doEventKey, doTriggerPopMenu, error, eventComponentMoved, eventComponentResized, eventFocusGained, eventFocusLost, eventKey, eventKeyPressed, eventKeyReleased, eventKeyTyped, eventMouseClicked, eventMouseEntered, eventMouseExited, eventMousePressed, eventMouseReleased, getBackground, getBounds, getComponentUIResource, getComponentUIResourceInsets, getCurrentTranslation, getDefaultName, getEventSource, getExistingNames, getFactory, getFont, getForeground, getLocation, getLocationRelativeTo, getMaximumSize, getMinimumSize, getName, getParent, getPopupMenu, getPreferredSize, getResource, getRootName, getSize, getStyle, getTabIndex, getToolTipText, getTranslation, incrementNameIfExists, info, invokeAndWait, invokeAndWait, invokeInThread, invokeInThread, invokeLater, invokeLater, isBackgroundSet, isBeforeNotified, isCursorSet, isEnabled, isFocusable, isFontSet, isForegroundSet, isMaximumSizeSet, isMinimumSizeSet, isNotified, isPreferredSizeSet, isTranslationChanged, isTranslationEnabled, isVisible, requestFocus, setBackground, setBounds, setBounds, setDefaultName, setEnabled, setEventSource, setFocusable, setFont, setForeground, setLocation, setLocation, setLocationRelativeTo, setMaximumSize, setMaximumSize, setMinimumSize, setMinimumSize, setName, setParent, setPopupMenu, setPreferredSize, setPreferredSize, setRootName, setSize, setSize, setStyle, setTabIndex, setToolTipText, setTranslation, setTranslationEnabled, setVisible, translate

Methods inherited from class javax.rad.genui.UIResource

equals, getObject, getObjectNames, getUIResource, hashCode, putObject, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface javax.rad.application.IApplication

getContentPane, showMessage

Methods inherited from interface javax.rad.application.IContent

getOpener, notifyVisible, setOpener

Methods inherited from interface javax.rad.ui.IComponent

capture, eventComponentMoved, eventComponentResized, eventFocusGained, eventFocusLost, eventKeyPressed, eventKeyReleased, eventKeyTyped, eventMouseClicked, eventMouseEntered, eventMouseExited, eventMousePressed, eventMouseReleased, getBackground, getBounds, getEventSource, getFactory, getFont, getForeground, getLocation, getLocationRelativeTo, getMaximumSize, getMinimumSize, getName, getParent, getPreferredSize, getSize, getStyle, getTabIndex, getToolTipText, isBackgroundSet, isCursorSet, isEnabled, isFocusable, isFontSet, isForegroundSet, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isVisible, requestFocus, setBackground, setBounds, setEnabled, setEventSource, setFocusable, setFont, setForeground, setLocation, setLocationRelativeTo, setMaximumSize, setMinimumSize, setName, setParent, setPreferredSize, setSize, setStyle, setTabIndex, setToolTipText, setVisible

Methods inherited from interface javax.rad.ui.IResource

getResource

Methods inherited from interface javax.rad.model.ui.ITranslatable

getTranslation, isTranslationEnabled, setTranslation, setTranslationEnabled

Methods inherited from interface javax.rad.ui.IContainer

add, add, add, add, getComponent, getComponentCount, getLayout, indexOf, remove, remove, removeAll, setLayout

Field Detail

PARAM_SETUP_CLASS

public static final String PARAM_SETUP_CLASS

the parameter name for the setup class.

See Also:

Constant Field Values

Constructor Detail

Application

public Application(UILauncher pLauncher)

Creates a new instance of Application with a desired launcher.

Parameters:

pLauncher - the launcher of this application

Method Detail

getLauncher

public UILauncher getLauncher()

Returns the platform independent launcher which is associated with this factory.

Specified by:

getLauncher in interface IApplication

Returns:

the associated launcher

getApplicationPane

public IContainer getApplicationPane()

Gets the standard application pane where the content will be added.

Specified by:

getApplicationPane in interface IApplication

Returns:

the application pane

setCursor

public void setCursor(ICursor pCursor)

Sets the cursor of the launcher.

Specified by:

setCursor in interface IComponent

Overrides:

setCursor in class UIComponent<IPanel>

Parameters:

pCursor - the cursor

See Also:

IComponent.isEnabled(), IComponent.getCursor(), Toolkit.createCustomCursor(java.awt.Image, java.awt.Point, java.lang.String), ICursor

getCursor

public ICursor getCursor()

Gets the cursor from the launcher.

Specified by:

getCursor in interface IComponent

Overrides:

getCursor in class UIComponent<IPanel>

Returns:

the cursor of the launcher

See Also:

IComponent.setCursor(javax.rad.ui.ICursor)

notifyDestroy

public void notifyDestroy()

Cancels all pending launcher threads.

Specified by:

notifyDestroy in interface IContent

Overrides:

notifyDestroy in class Content

getControllerProperty

public Object getControllerProperty(String pName)

Gets the current value of the given controller property. If the property was not set, the launcher parameter will be checked for a name with the prefix Controller., e.g. Controller.name.

Specified by:

getControllerProperty in interface IController

Overrides:

getControllerProperty in class ControllerContent

Parameters:

pName - the name of the property

Returns:

the value or null if the property was not found

showInformation

public <OP> IContent showInformation(OP pOpener,
                                     String pMessage)
                         throws Throwable

Shows a message with the IMessageConstants.MESSAGE_ICON_INFO icon and the IMessageConstants.MESSAGE_BUTTON_OK button.

Type Parameters:

OP - the opener type

Parameters:

pOpener - the opener of the information

pMessage - the message/information to show

Returns:

the message content or null if the message has no content

Throws:

Throwable - if the message could not be initialized

showInformation

public <OP> IContent showInformation(OP pOpener,
                                     String pMessage,
                                     String pOkAction)
                         throws Throwable

Shows a message with the IMessageConstants.MESSAGE_ICON_INFO icon and the IMessageConstants.MESSAGE_BUTTON_OK button.

Type Parameters:

OP - the opener type

Parameters:

pOpener - the opener of the information

pMessage - the message/information to show

pOkAction - the action to call when OK was pressed

Returns:

the message content or null if the message has no content

Throws:

Throwable - if the message could not be initialized

showError

public <OP> IContent showError(OP pOpener,
                               String pMessage)
                   throws Throwable

Shows a message with the IMessageConstants.MESSAGE_ICON_ERROR icon and the IMessageConstants.MESSAGE_BUTTON_OK button.

Type Parameters:

OP - the opener type

Parameters:

pOpener - the opener of the information

pMessage - the message/error to show

Returns:

the message content or null if the message has no content

Throws:

Throwable - if the message could not be initialized

showError

public <OP> IContent showError(OP pOpener,
                               String pMessage,
                               String pOkAction)
                   throws Throwable

Shows a message with the IMessageConstants.MESSAGE_ICON_ERROR icon and the IMessageConstants.MESSAGE_BUTTON_OK button.

Type Parameters:

OP - the opener type

Parameters:

pOpener - the opener of the information

pMessage - the message/error to show

pOkAction - the action to call when OK was pressed

Returns:

the message content or null if the message has no content

Throws:

Throwable - if the message could not be initialized

showQuestion

public <OP> IContent showQuestion(OP pOpener,
                                  String pMessage,
                                  String pOkAction)
                      throws Throwable

Shows a message with the IMessageConstants.MESSAGE_ICON_QUESTION icon and the IMessageConstants.MESSAGE_BUTTON_YES_NO buttons.

Type Parameters:

OP - the opener type

Parameters:

pOpener - the opener of the information

pMessage - the message/question to show

pOkAction - the action to call when yex was pressed

Returns:

the message content or null if the message has no content

Throws:

Throwable - if the message could not be initialized

showQuestion

public <OP> IContent showQuestion(OP pOpener,
                                  String pMessage,
                                  String pOkAction,
                                  String pCancelAction)
                      throws Throwable

Shows a message with the IMessageConstants.MESSAGE_ICON_QUESTION icon and the IMessageConstants.MESSAGE_BUTTON_YES_NO buttons.

Type Parameters:

OP - the opener type

Parameters:

pOpener - the opener of the information

pMessage - the message/question to show

pOkAction - the action to call when yex was pressed

pCancelAction - the action to call when no/x was pressed

Returns:

the message content or null if the message has no content

Throws:

Throwable - if the message could not be initialized

setLauncher

protected final void setLauncher(UILauncher pLauncher)

Sets the launcher. Be careful with this method because it changes the behaviour of the application if you use the wrong launcher.

Parameters:

pLauncher - the launcher

getSetup

protected IApplicationSetup getSetup()

Gets the application setup, if used.

Returns:

the application setup or null if no specific setup was used