java.awt

Class Toolkit

public abstract class Toolkit extends Object

The AWT system uses a set of native peer objects to implement its widgets. These peers are provided by a peer toolkit, that is accessed via a subclass of this superclass. The system toolkit is retrieved by the static methods getDefaultToolkit. This method determines the system toolkit by examining the system property awt.toolkit. That property is set to the name of the Toolkit subclass for the specified peer set. If the awt.toolkit property is not set, then the default toolkit gnu.java.awt.peer.gtk.GtkToolkit is used. This toolkit creates its peers using the GTK+ toolkit.

Field Summary
protected Map<String,Object>	desktopProperties
protected PropertyChangeSupport	desktopPropsSupport

Constructor Summary
	Toolkit() Default constructor for subclasses.

Method Summary
void	addAWTEventListener(AWTEventListener listener, long eventMask) Adds an AWTEventListener to this toolkit.
void	addPropertyChangeListener(String name, PropertyChangeListener pcl)
abstract void	beep() Causes a "beep" tone to be generated.
abstract int	checkImage(Image image, int width, int height, ImageObserver observer) Checks the status of specified image as it is being readied for rendering.
protected abstract ButtonPeer	createButton(Button target) Creates a peer object for the specified `Button`.
protected abstract CanvasPeer	createCanvas(Canvas target) Creates a peer object for the specified `Canvas`.
protected abstract CheckboxPeer	createCheckbox(Checkbox target) Creates a peer object for the specified `Checkbox`.
protected abstract CheckboxMenuItemPeer	createCheckboxMenuItem(CheckboxMenuItem target) Creates a peer object for the specified `CheckboxMenuItem`.
protected abstract ChoicePeer	createChoice(Choice target) Creates a peer object for the specified `Choice`.
protected LightweightPeer	createComponent(Component target) Creates a peer object for the specified `Component`.
Cursor	createCustomCursor(Image cursor, Point hotSpot, String name) Creates a new custom cursor object.
protected abstract DesktopPeer	createDesktopPeer(Desktop target)
protected abstract DialogPeer	createDialog(Dialog target) Creates a peer object for the specified `Dialog`.
<T extends DragGestureRecognizer> T	createDragGestureRecognizer(Class<T> recognizer, DragSource ds, Component comp, int actions, DragGestureListener l)
abstract DragSourceContextPeer	createDragSourceContextPeer(DragGestureEvent e)
protected abstract FileDialogPeer	createFileDialog(FileDialog target) Creates a peer object for the specified `FileDialog`.
protected abstract FramePeer	createFrame(Frame target) Creates a peer object for the specified `Frame`.
abstract Image	createImage(String filename)
abstract Image	createImage(URL url)
abstract Image	createImage(ImageProducer producer) Creates an image using the specified `ImageProducer`
Image	createImage(byte[] data) Creates an image from the specified byte array.
abstract Image	createImage(byte[] data, int offset, int len) Creates an image from the specified portion of the byte array passed.
protected abstract LabelPeer	createLabel(Label target) Creates a peer object for the specified `Label`.
protected abstract ListPeer	createList(List target) Creates a peer object for the specified `List`.
protected abstract MenuPeer	createMenu(Menu target) Creates a peer object for the specified `Menu`.
protected abstract MenuBarPeer	createMenuBar(MenuBar target) Creates a peer object for the specified `MenuBar`.
protected abstract MenuItemPeer	createMenuItem(MenuItem target) Creates a peer object for the specified `MenuItem`.
protected abstract PanelPeer	createPanel(Panel target) Creates a peer object for the specified `Panel`.
protected abstract PopupMenuPeer	createPopupMenu(PopupMenu target) Creates a peer object for the specified `PopupMenu`.
protected abstract ScrollbarPeer	createScrollbar(Scrollbar target) Creates a peer object for the specified `Scrollbar`.
protected abstract ScrollPanePeer	createScrollPane(ScrollPane target) Creates a peer object for the specified `ScrollPane`.
protected abstract TextAreaPeer	createTextArea(TextArea target) Creates a peer object for the specified `TextArea`.
protected abstract TextFieldPeer	createTextField(TextField target) Creates a peer object for the specified `TextField`.
protected abstract WindowPeer	createWindow(Window target) Creates a peer object for the specified `Window`.
AWTEventListener[]	getAWTEventListeners() Returns all registered AWT event listeners.
AWTEventListener[]	getAWTEventListeners(long mask) Returns all registered AWT event listeners that listen for events with the specified `eventMask`.
Dimension	getBestCursorSize(int preferredWidth, int preferredHeight) Returns the supported cursor dimension which is closest to the desired sizes.
abstract ColorModel	getColorModel() Returns the color model of the screen.
static Toolkit	getDefaultToolkit() Returns an instance of the default toolkit.
Object	getDesktopProperty(String propertyName)
abstract String[]	getFontList() Returns the names of the available fonts.
abstract FontMetrics	getFontMetrics(Font name) Return the font metrics for the specified font
protected abstract FontPeer	getFontPeer(String name, int style) Creates a peer object for the specified font name.
abstract Image	getImage(String name) Returns an image from the specified file, which must be in a recognized format.
abstract Image	getImage(URL url) Returns an image from the specified URL, which must be in a recognized format.
boolean	getLockingKeyState(int keyCode) Returns whether the given locking key on the keyboard is currently in its "on" state.
int	getMaximumCursorColors() Returns the maximum number of colors the Toolkit supports in a custom cursor palette.
int	getMenuShortcutKeyMask() Returns the accelerator key mask for menu shortcuts.
protected MouseInfoPeer	getMouseInfoPeer() Returns a MouseInfoPeer.
protected static Container	getNativeContainer(Component component) Returns the native container object of the specified component.
abstract PrintJob	getPrintJob(Frame frame, String title, Properties props) Returns a instance of `PrintJob` for the specified arguments.
PrintJob	getPrintJob(Frame frame, String title, JobAttributes jobAttr, PageAttributes pageAttr) Returns a instance of `PrintJob` for the specified arguments.
static String	getProperty(String key, String def) Returns the value of the property with the specified name, or the default value if the property does not exist.
PropertyChangeListener[]	getPropertyChangeListeners()
PropertyChangeListener[]	getPropertyChangeListeners(String name)
Insets	getScreenInsets(GraphicsConfiguration gc)
abstract int	getScreenResolution() Returns the screen resolution in dots per square inch.
abstract Dimension	getScreenSize() Returns the dimensions of the screen in pixels.
abstract Clipboard	getSystemClipboard() Returns the system clipboard.
EventQueue	getSystemEventQueue() Returns the event queue that is suitable for the calling context.
protected abstract EventQueue	getSystemEventQueueImpl() Returns the event queue that is suitable for the calling context.
Clipboard	getSystemSelection() Gets the singleton instance of the system selection as a Clipboard object.
protected void	initializeDesktopProperties()
boolean	isDynamicLayoutActive()
protected boolean	isDynamicLayoutSet()
boolean	isFrameStateSupported(int state) Returns whether Toolkit supports this state for Frames.
protected Object	lazilyLoadDesktopProperty(String name)
protected void	loadSystemColors(int[] systemColors) Copies the current system colors into the specified array.
abstract Map<TextAttribute,?>	mapInputMethodHighlight(InputMethodHighlight highlight)
abstract boolean	prepareImage(Image image, int width, int height, ImageObserver observer) Readies an image to be rendered on the screen.
void	removeAWTEventListener(AWTEventListener listener) Removes an AWT event listener from this toolkit.
void	removePropertyChangeListener(String name, PropertyChangeListener pcl)
protected void	setDesktopProperty(String name, Object newValue)
void	setDynamicLayout(boolean dynamic)
void	setLockingKeyState(int keyCode, boolean on) Sets the state of the given locking key on the keyboard.
abstract void	sync() Flushes any buffered data to the screen so that it is in sync with what the AWT system has drawn to it.

Field Detail

desktopProperties

protected final Map<String,Object> desktopProperties

desktopPropsSupport

protected final PropertyChangeSupport desktopPropsSupport

Constructor Detail

Toolkit

public Toolkit()

Default constructor for subclasses.

Method Detail

addAWTEventListener

public void addAWTEventListener(AWTEventListener listener, long eventMask)

Adds an AWTEventListener to this toolkit. This listener is informed about all events that pass the eventqueue that match the specified evenMask. The eventMask is an ORed combination of event masks as defined in {@link AWTEvent}. If a security manager is installed, it is asked first if an AWTPermission("listenToAllAWTEvents") is allowed. This may result in a SecurityException beeing thrown. It is not recommended to use this kind of notification for normal applications. It is intended solely for the purpose of debugging and to support special facilities.

Parameters: listener the listener to add eventMask the event mask of event types which the listener is interested in

Throws: SecurityException if there is a SecurityManager that doesn't grant AWTPermission("listenToAllAWTEvents")

Since: 1.2

addPropertyChangeListener

public void addPropertyChangeListener(String name, PropertyChangeListener pcl)

beep

public abstract void beep()

Causes a "beep" tone to be generated.

checkImage

public abstract int checkImage(Image image, int width, int height, ImageObserver observer)

Checks the status of specified image as it is being readied for rendering.

Parameters: image The image to prepare for rendering. width The width of the image. height The height of the image. observer The observer to receive events about the preparation process.

Returns: A union of the bitmasks from java.awt.image.ImageObserver that indicates the current state of the imaging readying process.

createButton

protected abstract ButtonPeer createButton(Button target)

Creates a peer object for the specified Button.

Parameters: target The Button to create the peer for.

Returns: The peer for the specified Button object.

Throws: HeadlessException If GraphicsEnvironment.isHeadless() is true.

createCanvas

protected abstract CanvasPeer createCanvas(Canvas target)

Creates a peer object for the specified Canvas.

Parameters: target The Canvas to create the peer for.

Returns: The peer for the specified Canvas object.

createCheckbox

protected abstract CheckboxPeer createCheckbox(Checkbox target)

Creates a peer object for the specified Checkbox.

Parameters: target The Checkbox to create the peer for.

Returns: The peer for the specified Checkbox object.

Throws: HeadlessException If GraphicsEnvironment.isHeadless() is true.

createCheckboxMenuItem

protected abstract CheckboxMenuItemPeer createCheckboxMenuItem(CheckboxMenuItem target)

Creates a peer object for the specified CheckboxMenuItem.

Parameters: target The CheckboxMenuItem to create the peer for.

Returns: The peer for the specified CheckboxMenuItem object.

Throws: HeadlessException If GraphicsEnvironment.isHeadless() is true.

createChoice

protected abstract ChoicePeer createChoice(Choice target)

Creates a peer object for the specified Choice.

Parameters: target The Choice to create the peer for.

Returns: The peer for the specified Choice object.

Throws: HeadlessException If GraphicsEnvironment.isHeadless() is true.

createComponent

protected LightweightPeer createComponent(Component target)

Creates a peer object for the specified Component. The peer returned by this method is not a native windowing system peer with its own native window. Instead, this method allows the component to draw on its parent window as a "lightweight" widget.

Parameters: target The Component to create the peer for.

Returns: The peer for the specified Component object.

createCustomCursor

public Cursor createCustomCursor(Image cursor, Point hotSpot, String name)

Creates a new custom cursor object.

Throws: IndexOutOfBoundsException If the hotSpot values are outside the bounds of the cursor. HeadlessException If GraphicsEnvironment.isHeadless() is true.

createDesktopPeer

protected abstract DesktopPeer createDesktopPeer(Desktop target)

Parameters: target

Returns:

Throws: HeadlessException

createDialog

protected abstract DialogPeer createDialog(Dialog target)

Creates a peer object for the specified Dialog.

Parameters: target The dialog to create the peer for

Returns: The peer for the specified font name.

Throws: HeadlessException If GraphicsEnvironment.isHeadless() is true.

createDragGestureRecognizer

public <T extends DragGestureRecognizer> T createDragGestureRecognizer(Class<T> recognizer, DragSource ds, Component comp, int actions, DragGestureListener l)

Since: 1.3

createDragSourceContextPeer

public abstract DragSourceContextPeer createDragSourceContextPeer(DragGestureEvent e)

Since: 1.3

createFileDialog

protected abstract FileDialogPeer createFileDialog(FileDialog target)

Creates a peer object for the specified FileDialog.

Parameters: target The FileDialog to create the peer for.

Returns: The peer for the specified FileDialog object.

Throws: HeadlessException If GraphicsEnvironment.isHeadless() is true.

createFrame

protected abstract FramePeer createFrame(Frame target)

Creates a peer object for the specified Frame.

Parameters: target The Frame to create the peer for.

Returns: The peer for the specified Frame object.

Throws: HeadlessException If GraphicsEnvironment.isHeadless() is true.

createImage

public abstract Image createImage(String filename)

createImage

public abstract Image createImage(URL url)

createImage

public abstract Image createImage(ImageProducer producer)

Creates an image using the specified ImageProducer

Parameters: producer The ImageProducer to create the image from.

Returns: The created image.

createImage

public Image createImage(byte[] data)

Creates an image from the specified byte array. The array must be in a recognized format. Supported formats vary from toolkit to toolkit.

Parameters: data The raw image data.

Returns: The created image.

createImage

public abstract Image createImage(byte[] data, int offset, int len)

Creates an image from the specified portion of the byte array passed. The array must be in a recognized format. Supported formats vary from toolkit to toolkit.

Parameters: data The raw image data. offset The offset into the data where the image data starts. len The length of the image data.

Returns: The created image.

createLabel

protected abstract LabelPeer createLabel(Label target)

Creates a peer object for the specified Label.

Parameters: target The Label to create the peer for.

Returns: The peer for the specified Label object.

Throws: HeadlessException If GraphicsEnvironment.isHeadless() is true.

createList

protected abstract ListPeer createList(List target)

Creates a peer object for the specified List.

Parameters: target The List to create the peer for.

Returns: The peer for the specified List object.

Throws: HeadlessException If GraphicsEnvironment.isHeadless() is true.

createMenu

protected abstract MenuPeer createMenu(Menu target)

Creates a peer object for the specified Menu.

Parameters: target The Menu to create the peer for.

Returns: The peer for the specified Menu object.

Throws: HeadlessException If GraphicsEnvironment.isHeadless() is true.

createMenuBar

protected abstract MenuBarPeer createMenuBar(MenuBar target)

Creates a peer object for the specified MenuBar.

Parameters: target The MenuBar to create the peer for.

Returns: The peer for the specified MenuBar object.

Throws: HeadlessException If GraphicsEnvironment.isHeadless() is true.

createMenuItem

protected abstract MenuItemPeer createMenuItem(MenuItem target)

Creates a peer object for the specified MenuItem.

Parameters: target The MenuItem to create the peer for.

Returns: The peer for the specified MenuItem object.

Throws: HeadlessException If GraphicsEnvironment.isHeadless() is true.

createPanel

protected abstract PanelPeer createPanel(Panel target)

Creates a peer object for the specified Panel.

Parameters: target The Panel to create the peer for.

Returns: The peer for the specified Panel object.

createPopupMenu

protected abstract PopupMenuPeer createPopupMenu(PopupMenu target)

Creates a peer object for the specified PopupMenu.

Parameters: target The PopupMenu to create the peer for.

Returns: The peer for the specified PopupMenu object.

Throws: HeadlessException If GraphicsEnvironment.isHeadless() is true.

createScrollbar

protected abstract ScrollbarPeer createScrollbar(Scrollbar target)

Creates a peer object for the specified Scrollbar.

Parameters: target The Scrollbar to create the peer for.

Returns: The peer for the specified Scrollbar object.

Throws: HeadlessException If GraphicsEnvironment.isHeadless() is true.

createScrollPane

protected abstract ScrollPanePeer createScrollPane(ScrollPane target)

Creates a peer object for the specified ScrollPane.

Parameters: target The ScrollPane to create the peer for.

Returns: The peer for the specified ScrollPane object.

Throws: HeadlessException If GraphicsEnvironment.isHeadless() is true.

createTextArea

protected abstract TextAreaPeer createTextArea(TextArea target)

Creates a peer object for the specified TextArea.

Parameters: target The TextArea to create the peer for.

Returns: The peer for the specified TextArea object.

Throws: HeadlessException If GraphicsEnvironment.isHeadless() is true.

createTextField

protected abstract TextFieldPeer createTextField(TextField target)

Creates a peer object for the specified TextField.

Parameters: target The TextField to create the peer for.

Returns: The peer for the specified TextField object.

Throws: HeadlessException If GraphicsEnvironment.isHeadless() is true.

createWindow

protected abstract WindowPeer createWindow(Window target)

Creates a peer object for the specified Window.

Parameters: target The Window to create the peer for.

Returns: The peer for the specified Window object.

Throws: HeadlessException If GraphicsEnvironment.isHeadless() is true.

getAWTEventListeners

public AWTEventListener[] getAWTEventListeners()

Returns all registered AWT event listeners. This method returns a copy of the listener array, so that application cannot trash the listener list. If a security manager is installed, it is asked first if an AWTPermission("listenToAllAWTEvents") is allowed. This may result in a SecurityException beeing thrown. It is not recommended to use this kind of notification for normal applications. It is intended solely for the purpose of debugging and to support special facilities.

Returns: all registered AWT event listeners

Throws: SecurityException if there is a SecurityManager that doesn't grant AWTPermission("listenToAllAWTEvents")

Since: 1.4

getAWTEventListeners

public AWTEventListener[] getAWTEventListeners(long mask)

Returns all registered AWT event listeners that listen for events with the specified eventMask. This method returns a copy of the listener array, so that application cannot trash the listener list. If a security manager is installed, it is asked first if an AWTPermission("listenToAllAWTEvents") is allowed. This may result in a SecurityException beeing thrown. It is not recommended to use this kind of notification for normal applications. It is intended solely for the purpose of debugging and to support special facilities.

Parameters: mask the event mask

Throws: SecurityException if there is a SecurityManager that doesn't grant AWTPermission("listenToAllAWTEvents")

Since: 1.4

getBestCursorSize

public Dimension getBestCursorSize(int preferredWidth, int preferredHeight)

Returns the supported cursor dimension which is closest to the desired sizes.

Throws: HeadlessException If GraphicsEnvironment.isHeadless() is true.

getColorModel

public abstract ColorModel getColorModel()

Returns the color model of the screen.

Returns: The color model of the screen.

Throws: HeadlessException If GraphicsEnvironment.isHeadless() is true.

getDefaultToolkit

public static Toolkit getDefaultToolkit()

Returns an instance of the default toolkit. The default toolkit is the subclass of Toolkit specified in the system property awt.toolkit, or gnu.java.awt.peer.gtk.GtkToolkit if the property is not set.

Returns: An instance of the system default toolkit.

Throws: AWTError If the toolkit cannot be loaded.

getDesktopProperty

public final Object getDesktopProperty(String propertyName)

getFontList

public abstract String[] getFontList()

Deprecated:

Returns the names of the available fonts.

Returns: The names of the available fonts.

getFontMetrics

public abstract FontMetrics getFontMetrics(Font name)

Deprecated:

Return the font metrics for the specified font

Parameters: name The name of the font to return metrics for.

Returns: The requested font metrics.

getFontPeer

protected abstract FontPeer getFontPeer(String name, int style)

Deprecated:

Creates a peer object for the specified font name.

Parameters: name The font to create the peer for. style The font style to create the peer for.

Returns: The peer for the specified font name.

getImage

public abstract Image getImage(String name)

Returns an image from the specified file, which must be in a recognized format. Supported formats vary from toolkit to toolkit.

Returns: name The name of the file to read the image from.

getImage

public abstract Image getImage(URL url)

Returns an image from the specified URL, which must be in a recognized format. Supported formats vary from toolkit to toolkit.

Returns: url The URl to read the image from.

getLockingKeyState

public boolean getLockingKeyState(int keyCode)

Returns whether the given locking key on the keyboard is currently in its "on" state.

Throws: HeadlessException If GraphicsEnvironment.isHeadless() is true. IllegalArgumentException If keyCode is not one of the valid keys. UnsupportedOperationException If the host system doesn't allow getting the state of this key programmatically, or if the keyboard doesn't have this key.

getMaximumCursorColors

public int getMaximumCursorColors()

Returns the maximum number of colors the Toolkit supports in a custom cursor palette.

Throws: HeadlessException If GraphicsEnvironment.isHeadless() is true.

getMenuShortcutKeyMask

public int getMenuShortcutKeyMask()

Returns the accelerator key mask for menu shortcuts. The default is Event.CTRL_MASK. A toolkit must override this method to change the default.

Returns: The key mask for the menu accelerator key.

Throws: HeadlessException If GraphicsEnvironment.isHeadless() is true.

getMouseInfoPeer

protected MouseInfoPeer getMouseInfoPeer()

Returns a MouseInfoPeer. The default implementation of this method throws UnsupportedOperationException. Toolkit implementations should overload this if possible, however.

getNativeContainer

protected static Container getNativeContainer(Component component)

Returns the native container object of the specified component. This method is necessary because the parent component might be a lightweight component.

Parameters: component The component to fetch the native container for.

Returns: The native container object for this component.

getPrintJob

public abstract PrintJob getPrintJob(Frame frame, String title, Properties props)

Returns a instance of PrintJob for the specified arguments.

Parameters: frame The window initiating the print job. title The print job title. props The print job properties.

Returns: The requested print job, or null if the job was cancelled.

Throws: NullPointerException If frame is null, or GraphicsEnvironment.isHeadless() returns true. SecurityException If this thread is not allowed to initiate a print job request.

getPrintJob

public PrintJob getPrintJob(Frame frame, String title, JobAttributes jobAttr, PageAttributes pageAttr)

Returns a instance of PrintJob for the specified arguments.

Parameters: frame The window initiating the print job. title The print job title. jobAttr A set of job attributes which will control the print job. pageAttr A set of page attributes which will control the print job.

Throws: NullPointerException If frame is null, and either jobAttr is null or jobAttr.getDialog() returns JobAttributes.DialogType.NATIVE. IllegalArgumentException If pageAttrspecifies differing cross feed and feed resolutions, or when GraphicsEnvironment.isHeadless() returns true. SecurityException If this thread is not allowed to initiate a print job request.

Since: 1.3

getProperty

public static String getProperty(String key, String def)

Returns the value of the property with the specified name, or the default value if the property does not exist.

Parameters: key The name of the property to retrieve. def The default value of the property.

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners()

Since: 1.4

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners(String name)

Since: 1.4

getScreenInsets

public Insets getScreenInsets(GraphicsConfiguration gc)

Throws: HeadlessException If GraphicsEnvironment.isHeadless() is true.

Since: 1.4

getScreenResolution

public abstract int getScreenResolution()

Returns the screen resolution in dots per square inch.

Returns: The screen resolution in dots per square inch.

Throws: HeadlessException If GraphicsEnvironment.isHeadless() is true.

getScreenSize

public abstract Dimension getScreenSize()

Returns the dimensions of the screen in pixels.

Returns: The dimensions of the screen in pixels.

Throws: HeadlessException If GraphicsEnvironment.isHeadless() is true.

getSystemClipboard

public abstract Clipboard getSystemClipboard()

Returns the system clipboard.

Returns: THe system clipboard.

Throws: HeadlessException If GraphicsEnvironment.isHeadless() is true.

getSystemEventQueue

public final EventQueue getSystemEventQueue()

Returns the event queue that is suitable for the calling context.

Despite the word “System” in the name of this method, a toolkit may provide different event queues for each applet. There is no guarantee that the same queue is shared system-wide.

The implementation first checks whether a SecurityManager has been installed. If so, its {@link java.lang.SecurityManager#checkAwtEventQueueAccess()} method gets called. The security manager will throw a SecurityException if it does not grant the permission to access the event queue.

Next, the call is delegated to {@link #getSystemEventQueueImpl()}.

Returns: The event queue for this applet (or application).

Throws: SecurityException if a security manager has been installed, and it does not grant the permission to access the event queue.

getSystemEventQueueImpl

protected abstract EventQueue getSystemEventQueueImpl()

Returns the event queue that is suitable for the calling context.

Despite the word “System” in the name of this method, a toolkit may provide different event queues for each applet. There is no guarantee that the same queue is shared system-wide.

No security checks are performed, which is why this method may only be called by Toolkits.

getSystemSelection

public Clipboard getSystemSelection()

Gets the singleton instance of the system selection as a Clipboard object. The system selection contains the selected text of the last component/widget that had focus and a text selection. The default implementation returns null.

Returns: The Clipboard holding the system (text) selection or null if the Toolkit or system doesn't support a selection clipboard.

Throws: HeadlessException If GraphicsEnvironment.isHeadless() is true. SecurityException If the current security manager checkSystemClipboardAccess() doesn't allow access.

Since: 1.4

initializeDesktopProperties

protected void initializeDesktopProperties()

isDynamicLayoutActive

public boolean isDynamicLayoutActive()

Throws: HeadlessException If GraphicsEnvironment.isHeadless() is true.

Since: 1.4

isDynamicLayoutSet

protected boolean isDynamicLayoutSet()

Throws: HeadlessException If GraphicsEnvironment.isHeadless() is true.

Since: 1.4

isFrameStateSupported

public boolean isFrameStateSupported(int state)

Returns whether Toolkit supports this state for Frames.

Throws: HeadlessException If GraphicsEnvironment.isHeadless() is true.

Since: 1.4

lazilyLoadDesktopProperty

protected Object lazilyLoadDesktopProperty(String name)

loadSystemColors

protected void loadSystemColors(int[] systemColors)

Copies the current system colors into the specified array. This is the interface used by the SystemColor class. Although this method fills in the array with some default colors a real Toolkit should override this method and provide real system colors for the native GUI platform.

Parameters: systemColors The array to copy the system colors into. It must be at least 26 elements.

Throws: HeadlessException If GraphicsEnvironment.isHeadless() is true.

mapInputMethodHighlight

public abstract Map<TextAttribute,?> mapInputMethodHighlight(InputMethodHighlight highlight)

Since: 1.3

prepareImage

public abstract boolean prepareImage(Image image, int width, int height, ImageObserver observer)

Readies an image to be rendered on the screen. The width and height values can be set to the default sizes for the image by passing -1 in those parameters.

Parameters: image The image to prepare for rendering. width The width of the image. height The height of the image. observer The observer to receive events about the preparation process.

Returns: true if the image is already prepared for rendering, false otherwise.

removeAWTEventListener

public void removeAWTEventListener(AWTEventListener listener)

Removes an AWT event listener from this toolkit. This listener is no longer informed of any event types it was registered in. If a security manager is installed, it is asked first if an AWTPermission("listenToAllAWTEvents") is allowed. This may result in a SecurityException beeing thrown. It is not recommended to use this kind of notification for normal applications. It is intended solely for the purpose of debugging and to support special facilities.

Parameters: listener the listener to remove

Throws: SecurityException if there is a SecurityManager that doesn't grant AWTPermission("listenToAllAWTEvents")

Since: 1.2

Since: 1.4

setLockingKeyState

public void setLockingKeyState(int keyCode, boolean on)

Sets the state of the given locking key on the keyboard.

sync

public abstract void sync()

Flushes any buffered data to the screen so that it is in sync with what the AWT system has drawn to it.