xdev.ui

Interface XdevApplicationContainer

All Superinterfaces:

RootPaneContainer, XdevRootPaneContainer

All Known Implementing Classes:

Application, XdevFullScreen, XdevMainFrame

public interface XdevApplicationContainer
extends XdevRootPaneContainer

A XdevRootPaneContainer which is used as the Application's top level container, which is either a Frame or a Applet.

Author:

XDEV Software

See Also:

XdevMainFrame, XdevFullScreen, Application

Nested Class Summary

Nested classes/interfaces inherited from interface xdev.ui.XdevRootPaneContainer

XdevRootPaneContainer.Util

Field Summary

Fields inherited from interface xdev.ui.XdevRootPaneContainer

ICONIFIED, MAXIMIZED_BOTH, MAXIMIZED_HORIZ, MAXIMIZED_VERT, NORMAL

Method Summary

Modifier and Type	Method and Description
URL	getCodeBase() Gets the base URL.
FontMetrics	getFontMetrics(Font f) Gets the font metrics for the specified font.
Graphics	getGraphics() Creates a graphics context for this XdevApplicationContainer .
GraphicsConfiguration	getGraphicsConfiguration() Gets the GraphicsConfiguration associated with this XdevApplicationContainer.
Image	getImage(URL url) Returns an Image object that can then be painted on the screen.
Toolkit	getToolkit() Gets the toolkit of this XdevApplicationContainer.
void	setIconImage(Image img) Sets the icon image of this XdevApplicationContainer.
void	showDocument(URL url) Requests that the application container shows the Web page indicated by the url argument.
void	showDocument(URL url, String target) Requests that the application container shows the Web page indicated by the url argument.

Methods inherited from interface xdev.ui.XdevRootPaneContainer

addWindowListener, close, getBounds, getExtendedState, getLocation, getSize, getWindow, getXdevWindow, pack, removeWindowListener, setBounds, setExtendedState, setLocation, setLocationRelativeTo, setResizable, setTitle, setVisible, setXdevWindow, toBack, toFront

Methods inherited from interface javax.swing.RootPaneContainer

getContentPane, getGlassPane, getLayeredPane, getRootPane, setContentPane, setGlassPane, setLayeredPane

Method Detail

setIconImage

void setIconImage(Image img)

Sets the icon image of this XdevApplicationContainer.

Parameters:

img - the image to be displayed

getCodeBase

URL getCodeBase()

Gets the base URL. This is the URL of the directory which contains this XdevApplicationContainer.

Returns:

the base URL of the directory which contains this XdevApplicationContainer.

getImage

Image getImage(URL url)

Returns an Image object that can then be painted on the screen. The url that is passed as an argument must specify an absolute URL.

This method always returns immediately, whether or not the image exists. When this XdevApplicationContainer attempts to draw the image on the screen, the data will be loaded. The graphics primitives that draw the image will incrementally paint on the screen.

Parameters:

url - an absolute URL giving the location of the image.

Returns:

the image at the specified URL.

See Also:

Image

getToolkit

Toolkit getToolkit()

Gets the toolkit of this XdevApplicationContainer. Note that the frame that contains a component controls which toolkit is used by that component. Therefore if the component is moved from one frame to another, the toolkit it uses may change.

Returns:

the toolkit of this XdevApplicationContainer

getFontMetrics

FontMetrics getFontMetrics(Font f)

Gets the font metrics for the specified font. Warning: Since Font metrics are affected by the FontRenderContext and this method does not provide one, it can return only metrics for the default render context which may not match that used when rendering on the Component if Graphics2D functionality is being used. Instead metrics can be obtained at rendering time by calling Graphics.getFontMetrics() or text measurement APIs on the Font class.

Parameters:

f - the font for which font metrics is to be obtained

Returns:

the font metrics for font

getGraphics

Graphics getGraphics()

Creates a graphics context for this XdevApplicationContainer . This method will return null if this XdevApplicationContainer is currently not displayable.

Returns:

a graphics context for this XdevApplicationContainer, or null if it has none

See Also:

getGraphicsConfiguration()

getGraphicsConfiguration

GraphicsConfiguration getGraphicsConfiguration()

Gets the GraphicsConfiguration associated with this XdevApplicationContainer. If the XdevApplicationContainer has not been assigned a specific GraphicsConfiguration, the GraphicsConfiguration of the XdevApplicationContainer object's top-level container is returned. If the XdevApplicationContainer has been created, but not yet added to a Container, this method returns null.

Returns:

the GraphicsConfiguration used by this XdevApplicationContainer or null

See Also:

getGraphics()

showDocument

void showDocument(URL url)

Requests that the application container shows the Web page indicated by the url argument. The browser or applet viewer determines which window or frame to display the Web page.

Parameters:

url - an absolute URL giving the location of the document.

showDocument

void showDocument(URL url,
                  String target)

Requests that the application container shows the Web page indicated by the url argument. The target argument indicates in which HTML frame the document is to be displayed. The target argument is interpreted as follows:

Target Argument	Description
"_self"	Show in the window and frame that contain the applet.
"_parent"	Show in the applet's parent frame. If the applet's frame has no parent frame, acts the same as "_self".
"_top"	Show in the top-level frame of the applet's window. If the applet's frame is the top-level frame, acts the same as "_self".
"_blank"	Show in a new, unnamed top-level window.
name	Show in the frame or window named name. If a target named name does not already exist, a new top-level window with the specified name is created, and the document is shown there.

An applet viewer or browser is free to ignore this method.

Parameters:

url - an absolute URL giving the location of the document.

target - a String indicating where to display the page.