Application (tag)

From JAXXWiki

The <Application> tag is a special class tag which creates an instance of jaxx.runtime.swing.Application, a subclass of javax.swing.JFrame. The package name is assumed only because jaxx.runtime.swing is imported by default. The fully qualified form of this tag is <jaxx.runtime.swing.Application>.

This information is based on the Java Development Kit version 5.0. Other versions of Java may have more or fewer features.

Contents

Usage

The Application tag is an invisible component. The tag can be included inside of a container, but the Application will not actually become a child of the container.

<Application> extends <JFrame>, and is typically the top-level window in JAXX applications.

Special Behaviors

Special behaviors specific to Application

JAXX files with <Application> as their root component (in other words, JAXX classes that subclass Application) automatically receive a main() method which creates and displays the Application window.

Special behaviors inherited from JFrame

  • Frames which do not have a width or height attribute defined will automatically be pack()ed upon display.
  • The default value of defaultCloseOperation is dispose_on_close instead of hide_on_close

Child tags

To assign a JMenuBar to a Application, include a <JMenuBar> tag as a child tag.

Attributes

These attributes may appear on the <Application> tag. As XML is a text file format, all attribute values must be represented as strings — either strings which can be converted into the destination type (e.g. height="1234" for the int-typed attribute height) or strings of Java code in curly braces (e.g. border="{BorderFactory.createEtchedBorder()}" for the Border-typed attribute border). See Data types for more information.

Attributes specific to Application

These attributes are defined by Application (or its TagHandler).

AttributeTypeDescription
lookAndFeeljava.lang.StringSets the system-wide look and feel.
Must be "cross_platform", "system", or the fully-qualified name of a Java look and feel class

Attributes inherited from JFrame

These attributes are common to all classes that descend from javax.swing.JFrame.

AttributeTypeDescription
contentPanejava.awt.ContainerEquivalent to setContentPane()
defaultCloseOperationintEquivalent to setDefaultCloseOperation()

Must be one of: do_nothing_on_close, hide_on_close, or dispose_on_close

glassPanejava.awt.ContainerEquivalent to setGlassPane()
JMenuBarjavax.swing.JMenuBarEquivalent to setJMenuBar()
layeredPanejavax.swing.JLayeredPaneEquivalent to setLayeredPane()

Attributes inherited from Frame

These attributes are common to all classes that descend from java.awt.Frame.

AttributeTypeDescription
extendedStateintEquivalent to setExtendedState()
iconImagejavax.swing.IconEquivalent to setIconImage()
maximizedBoundsjava.awt.RectangleEquivalent to setMaximizedBounds()
resizablebooleanEquivalent to setResizable()
titlejava.lang.StringEquivalent to setTitle()
undecoratedbooleanEquivalent to setUndecorated()

Attributes inherited from Window

These attributes are common to all classes that descend from java.awt.Window.

AttributeTypeDescription
alwaysOnTopbooleanEquivalent to setAlwaysOnTop()
cursorjava.awt.CursorEquivalent to setCursor()
focusableWindowStatebooleanEquivalent to setFocusableWindowState()
locationByPlatformbooleanEquivalent to setLocationByPlatform()
locationRelativeTojava.awt.ComponentEquivalent to setLocationRelativeTo()

Attributes inherited from Container

These attributes are common to all classes that descend from java.awt.Container.

AttributeTypeDescription
focusCycleRootbooleanEquivalent to setFocusCycleRoot()
focusTraversalPolicyjava.awt.FocusTraversalPolicyEquivalent to setFocusTraversalPolicy()
focusTraversalPolicyProviderbooleanEquivalent to setFocusTraversalPolicyProvider()
layoutjava.awt.LayoutManagerEquivalent to setLayout()

Attributes inherited from Component

These attributes are common to all classes that descend from java.awt.Component.

AttributeTypeDescription
boundsjava.awt.RectangleEquivalent to setBounds()
componentOrientationjava.awt.ComponentOrientationEquivalent to setComponentOrientation()
cursorjava.awt.CursorEquivalent to setCursor()
dropTargetjava.awt.dnd.DropTargetEquivalent to setDropTarget()
enabledbooleanEquivalent to setEnabled()
focusablebooleanEquivalent to setFocusable()
focusTraversalKeysEnabledbooleanEquivalent to setFocusTraversalKeysEnabled()
fontjava.awt.FontEquivalent to setFont()
foregroundjava.awt.ColorEquivalent to setForeground()
heightintSets the component's height (more information)
ignoreRepaintbooleanEquivalent to setIgnoreRepaint()
localejava.util.LocaleEquivalent to setLocale()
locationjava.awt.PointEquivalent to setLocation()
maximumSizejava.awt.DimensionEquivalent to setMaximumSize()
minimumSizejava.awt.DimensionEquivalent to setMinimumSize()
namejava.lang.StringEquivalent to setName()
preferredSizejava.awt.DimensionEquivalent to setPreferredSize()
sizejava.awt.DimensionEquivalent to setSize()
visiblebooleanEquivalent to setVisible()
widthintSets the component's width (more information)

JAXX attributes

These attributes are common to all JAXX class tags.

AttributeTypeDescription
constraintsjava.lang.ObjectLayout constraints to be used when adding to parent (full documentation)
constructorParamscomma-separated Java expressionsParameters to be passed to object's constructor (full documentation)
idjava.lang.StringName used to refer to object elsewhere in file (full documentation)
styleClassjava.lang.StringCSS style class (full documentation)

Events

You can listen to events by assigning Java code to an event handler, such as onActionPerformed='dispose()'. The Java code will be invoked when the event is fired. See event handlers for more details.

Events inherited from Window

These events are common to all classes that descend from java.awt.Window.

EventListener classDescription
onPropertyChangePropertyChangeListenerCalled when a bound property is changed.
onWindowActivatedWindowListenerInvoked when the Window is set to be the active Window.
onWindowClosedWindowListenerInvoked when a window has been closed as the result of calling dispose on the window.
onWindowClosingWindowListenerInvoked when the user attempts to close the window from the window's system menu.
onWindowDeactivatedWindowListenerInvoked when a Window is no longer the active Window.
onWindowDeiconifiedWindowListenerInvoked when a window is changed from a minimized to a normal state.
onWindowGainedFocusWindowFocusListenerInvoked when the Window is set to be the focused Window.
onWindowIconifiedWindowListenerInvoked when a window is changed from a normal to a minimized state.
onWindowLostFocusWindowFocusListenerInvoked when the Window is no longer the focused Window.
onWindowOpenedWindowListenerInvoked the first time a window is made visible.
onWindowStateChangedWindowStateListenerInvoked when window state is changed.

Events inherited from Container

These events are common to all classes that descend from java.awt.Container.

EventListener classDescription
onComponentAddedContainerListenerInvoked when a component has been added to the container.
onComponentRemovedContainerListenerInvoked when a component has been removed from the container.
onPropertyChangePropertyChangeListenerCalled when a bound property is changed.

Events inherited from Component

These events are common to all classes that descend from java.awt.Component.

EventListener classDescription
onAncestorResizedHeirarchyBoundsListenerCalled when an ancestor of the source is resized.
onCaretPositionChangedInputMethodListenerInvoked when the caret within composed text has changed.
onComponentHiddenComponentListenerInvoked when the component has been made invisible.
onComponentMovedComponentListenerInvoked when the component's position changes.
onComponentResizedComponentListenerInvoked when the component's size changes.
onComponentShownComponentListenerInvoked when the component has been made visible.
onFocusGainedFocusListenerInvoked when a component gains the keyboard focus.
onFocusLostFocusListenerInvoked when a component loses the keyboard focus.
onHeirarchyChangedHeirarchyListenerCalled when the hierarchy has been changed.
onInputMethodTextChangedInputMethodListenerInvoked when the text entered through an input method has changed.
onKeyPressedKeyListenerInvoked when a key has been pressed.
onKeyReleasedKeyListenerInvoked when a key has been released.
onKeyTypedKeyListenerInvoked when a key has been typed.
onMouseClickedMouseListenerInvoked when the mouse button has been clicked (pressed and released) on a component.
onMouseDraggedMouseMotionListenerInvoked when a mouse button is pressed on a component and then dragged.
onMouseEnteredMouseListenerInvoked when the mouse enters a component.
onMouseExitedMouseListenerInvoked when the mouse exits a component.
onMouseMovedMouseMotionListenerInvoked when the mouse cursor has been moved onto a component but no buttons have been pushed.
onMousePressedMouseListenerInvoked when a mouse button has been pressed on a component.
onMouseReleasedMouseListenerInvoked when a mouse button has been released on a component.
onMouseWheelMovedMouseWheelListenerInvoked when the mouse wheel is rotated.

Bound methods

A bound method is a method whose value can be tracked by listening to events. For instance, changes to the return value of Component.getWidth() are always accompanied by componentResized events.

Bound methods are significant because they allow the data binding system to detect when they have changed. If you call a bound method within a data binding expression, JAXX will add an event listener in order to detect changes to the method's value. Methods which are not listed below cannot be tracked by JAXX's data binding.

delbocnae coracdronpas dronelch cbocboac oroloo

Bound methods inherited from Frame

These methods are bound in all components that descend from java.awt.Frame.

  • getTitle()
  • isModal()
  • isResizable()
  • isUndecorated()

delbocnae coracdronpas dronelch cbocboac oroloo

Bound methods inherited from Window

These methods are bound in all components that descend from java.awt.Window.

  • getFocusableWindowState()
  • getFocusCycleRootAncestor()
  • getFocusOwner()
  • getFocusTraversalKeys()
  • getGraphicsConfiguration()
  • getInputContext()
  • getLocale()
  • getModalExclusionType()
  • getMostRecentFocusOwner()
  • getOwner()
  • getToolkit()
  • isFocusableWindow()
  • isFocusCycleRoot()
  • isActive()
  • isAlwaysOnTop()
  • isFocused()
  • isLocationByPlatform()
  • isShowing()

delbocnae coracdronpas dronelch cbocboac oroloo

Bound methods inherited from Container

These methods are bound in all components that descend from java.awt.Container.

  • getChildCount()

delbocnae coracdronpas dronelch cbocboac oroloo

Bound methods inherited from Component

These methods are bound in all components that descend from java.awt.Component.

  • hasFocus()
  • getBackground()
  • getBounds()
  • getHeight()
  • getFont()
  • getForeground()
  • getLocation()
  • getLocationOnScreen()
  • getSize()
  • getWidth()
  • getX()
  • getY()
  • isFocusable()
  • isVisible()

See also