diff options
Diffstat (limited to 'libjava/java/awt/Toolkit.java')
| -rw-r--r-- | libjava/java/awt/Toolkit.java | 1495 |
1 files changed, 717 insertions, 778 deletions
diff --git a/libjava/java/awt/Toolkit.java b/libjava/java/awt/Toolkit.java index 4c59138..7caec22 100644 --- a/libjava/java/awt/Toolkit.java +++ b/libjava/java/awt/Toolkit.java @@ -38,788 +38,727 @@ exception statement from your version. */ package java.awt; -import java.awt.event.*; -import java.awt.peer.*; -import java.awt.image.*; import java.awt.datatransfer.Clipboard; -import java.util.Properties; +import java.awt.dnd.DragGestureEvent; +import java.awt.dnd.DragGestureListener; +import java.awt.dnd.DragGestureRecognizer; +import java.awt.dnd.DragSource; +import java.awt.dnd.peer.DragSourceContextPeer; +import java.awt.event.AWTEventListener; +import java.awt.event.KeyEvent; +import java.awt.im.InputMethodHighlight; +import java.awt.image.ColorModel; +import java.awt.image.ImageObserver; +import java.awt.image.ImageProducer; +import java.awt.peer.ButtonPeer; +import java.awt.peer.CanvasPeer; +import java.awt.peer.CheckboxPeer; +import java.awt.peer.CheckboxMenuItemPeer; +import java.awt.peer.ChoicePeer; +import java.awt.peer.DialogPeer; +import java.awt.peer.FileDialogPeer; +import java.awt.peer.FontPeer; +import java.awt.peer.FramePeer; +import java.awt.peer.LabelPeer; +import java.awt.peer.LightweightPeer; +import java.awt.peer.ListPeer; +import java.awt.peer.MenuPeer; +import java.awt.peer.MenuBarPeer; +import java.awt.peer.MenuItemPeer; +import java.awt.peer.PanelPeer; +import java.awt.peer.PopupMenuPeer; +import java.awt.peer.ScrollbarPeer; +import java.awt.peer.ScrollPanePeer; +import java.awt.peer.TextAreaPeer; +import java.awt.peer.TextFieldPeer; +import java.awt.peer.WindowPeer; +import java.beans.PropertyChangeListener; +import java.beans.PropertyChangeSupport; import java.net.URL; -import java.beans.*; - -/** - * 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 <code>getDefaultToolkit</code>. This method - * determines the system toolkit by examining the system property - * <code>awt.toolkit</code>. That property is set to the name of the - * <code>Toolkit</code> subclass for the specified peer set. If the - * <code>awt.toolkit</code> property is not set, then the default - * toolkit <code>gnu.java.awt.peer.gtk.GtkToolkit</code> is used. This - * toolkit creates its peers using the GTK+ toolkit. - * - * @author Aaron M. Renn (arenn@urbanophile.com) - */ -public abstract class Toolkit -{ - -/* - * Static Variables - */ - -// The default toolkit name. -private static String default_toolkit_name = - "gnu.java.awt.peer.gtk.GtkToolkit"; - -// The toolkit in use. Once we load it, we don't ever change it -// if the awt.toolkit propert is set. -private static Toolkit toolkit; - -// The toolkit properties -private static Properties props = new Properties(); - -private PropertyChangeSupport changeSupport = new PropertyChangeSupport(this); - -private Properties desktopProperties = new Properties(); - -/*************************************************************************/ - -/* - * Static Methods - */ - -/** - * Returns an instance of the default toolkit. The default toolkit is - * the subclass of <code>Toolkit</code> specified in the system property - * <code>awt.toolkit</code>, or <code>gnu.java.awt.peer.gtk.GtkToolkit</code> - * if the property is not set. - * - * @return An instance of the system default toolkit. - * - * @error AWTError If the toolkit cannot be loaded. - */ -public static Toolkit -getDefaultToolkit() -{ - if (toolkit != null) - return(toolkit); - - String toolkit_name = System.getProperty("awt.toolkit", - default_toolkit_name); - - try - { - Class cls = Class.forName(toolkit_name); - Object obj = cls.newInstance(); - - if (!(obj instanceof Toolkit)) - throw new AWTError(toolkit_name + " is not a subclass of " + - "java.awt.Toolkit"); - - toolkit = (Toolkit)obj; - return(toolkit); - } - catch(Exception e) - { - throw new AWTError("Cannot load AWT toolkit: " + e.getMessage()); - } -} - -/*************************************************************************/ - -/** - * Returns the value of the property with the specified name, or the - * default value if the property does not exist. - * - * @param key The name of the property to retrieve. - * @param defThe default value of the property. - */ -public static String -getProperty(String key, String def) -{ - return(props.getProperty(key, def)); -} - -/*************************************************************************/ - -/** - * Returns the native container object of the specified component. This - * method is necessary because the parent component might be a lightweight - * component. - * - * @param component The component to fetch the native container for. - * - * @return The native container object for this component. - */ -protected static Container -getNativeContainer(Component component) -{ - component = component.getParent(); - - for(;;) - { - if (component == null) - return(null); - - if (!(component instanceof Container)) - { - component = component.getParent(); - continue; - } - - if (component.getPeer() instanceof LightweightPeer) - { - component = component.getParent(); - continue; - } - - return((Container)component); - } -} - -/*************************************************************************/ - -/* - * Constructors - */ +import java.util.Map; +import java.util.Properties; /** - * Default constructor for subclasses. - */ -public -Toolkit() -{ -} - -/*************************************************************************/ - -/* - * Instance Methods + * 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 <code>getDefaultToolkit</code>. This method + * determines the system toolkit by examining the system property + * <code>awt.toolkit</code>. That property is set to the name of the + * <code>Toolkit</code> subclass for the specified peer set. If the + * <code>awt.toolkit</code> property is not set, then the default + * toolkit <code>gnu.java.awt.peer.gtk.GtkToolkit</code> is used. This + * toolkit creates its peers using the GTK+ toolkit. + * + * @author Aaron M. Renn <arenn@urbanophile.com> */ - -/** - * Creates a peer object for the specified <code>Button</code>. - * - * @param target The <code>Button</code> to create the peer for. - * - * @return The peer for the specified <code>Button</code> object. - */ -protected abstract ButtonPeer -createButton(Button target); - -/*************************************************************************/ - -/** - * Creates a peer object for the specified <code>TextField</code>. - * - * @param target The <code>TextField</code> to create the peer for. - * - * @return The peer for the specified <code>TextField</code> object. - */ -protected abstract TextFieldPeer -createTextField(TextField target); - -/*************************************************************************/ - -/** - * Creates a peer object for the specified <code>Label</code>. - * - * @param target The <code>Label</code> to create the peer for. - * - * @return The peer for the specified <code>Label</code> object. - */ -protected abstract LabelPeer -createLabel(Label target); - -/*************************************************************************/ - -/** - * Creates a peer object for the specified <code>List</code>. - * - * @param target The <code>List</code> to create the peer for. - * - * @return The peer for the specified <code>List</code> object. - */ -protected abstract ListPeer -createList(List target); - -/*************************************************************************/ - -/** - * Creates a peer object for the specified <code>Checkbox</code>. - * - * @param target The <code>Checkbox</code> to create the peer for. - * - * @return The peer for the specified <code>Checkbox</code> object. - */ -protected abstract CheckboxPeer -createCheckbox(Checkbox target); - -/*************************************************************************/ - -/** - * Creates a peer object for the specified <code>Scrollbar</code>. - * - * @param target The <code>Scrollbar</code> to create the peer for. - * - * @return The peer for the specified <code>Scrollbar</code> object. - */ -protected abstract ScrollbarPeer -createScrollbar(Scrollbar target); - -/*************************************************************************/ - -/** - * Creates a peer object for the specified <code>ScrollPane</code>. - * - * @param target The <code>ScrollPane</code> to create the peer for. - * - * @return The peer for the specified <code>ScrollPane</code> object. - */ -protected abstract ScrollPanePeer -createScrollPane(ScrollPane target); - -/*************************************************************************/ - -/** - * Creates a peer object for the specified <code>TextArea</code>. - * - * @param target The <code>TextArea</code> to create the peer for. - * - * @return The peer for the specified <code>TextArea</code> object. - */ -protected abstract TextAreaPeer -createTextArea(TextArea target); - -/*************************************************************************/ - -/** - * Creates a peer object for the specified <code>Choice</code>. - * - * @param target The <code>Choice</code> to create the peer for. - * - * @return The peer for the specified <code>Choice</code> object. - */ -protected abstract ChoicePeer -createChoice(Choice target); - -/*************************************************************************/ - -/** - * Creates a peer object for the specified <code>Frame</code>. - * - * @param target The <code>Frame</code> to create the peer for. - * - * @return The peer for the specified <code>Frame</code> object. - */ -protected abstract FramePeer -createFrame(Frame target); - -/*************************************************************************/ - -/** - * Creates a peer object for the specified <code>Canvas</code>. - * - * @param target The <code>Canvas</code> to create the peer for. - * - * @return The peer for the specified <code>Canvas</code> object. - */ -protected abstract CanvasPeer -createCanvas(Canvas target); - -/*************************************************************************/ - -/** - * Creates a peer object for the specified <code>Panel</code>. - * - * @param target The <code>Panel</code> to create the peer for. - * - * @return The peer for the specified <code>Panel</code> object. - */ -protected abstract PanelPeer -createPanel(Panel target); - -/*************************************************************************/ - -/** - * Creates a peer object for the specified <code>Window</code>. - * - * @param target The <code>Window</code> to create the peer for. - * - * @return The peer for the specified <code>Window</code> object. - */ -protected abstract WindowPeer -createWindow(Window target); - -/*************************************************************************/ - -/** - * Creates a peer object for the specified <code>Dialog</code>. - * - * @param target The dialog to create the peer for - * - * @return The peer for the specified font name. - */ -protected abstract DialogPeer -createDialog(Dialog target); - -/*************************************************************************/ - -/** - * Creates a peer object for the specified <code>MenuBar</code>. - * - * @param target The <code>MenuBar</code> to create the peer for. - * - * @return The peer for the specified <code>MenuBar</code> object. - */ -protected abstract MenuBarPeer -createMenuBar(MenuBar target); - -/*************************************************************************/ - -/** - * Creates a peer object for the specified <code>Menu</code>. - * - * @param target The <code>Menu</code> to create the peer for. - * - * @return The peer for the specified <code>Menu</code> object. - */ -protected abstract MenuPeer -createMenu(Menu target); - -/*************************************************************************/ - -/** - * Creates a peer object for the specified <code>PopupMenu</code>. - * - * @param target The <code>PopupMenu</code> to create the peer for. - * - * @return The peer for the specified <code>PopupMenu</code> object. - */ -protected abstract PopupMenuPeer -createPopupMenu(PopupMenu target); - -/*************************************************************************/ - -/** - * Creates a peer object for the specified <code>MenuItem</code>. - * - * @param target The <code>MenuItem</code> to create the peer for. - * - * @return The peer for the specified <code>MenuItem</code> object. - */ -protected abstract MenuItemPeer -createMenuItem(MenuItem target); - -/*************************************************************************/ - -/** - * Creates a peer object for the specified <code>FileDialog</code>. - * - * @param target The <code>FileDialog</code> to create the peer for. - * - * @return The peer for the specified <code>FileDialog</code> object. - */ -protected abstract FileDialogPeer -createFileDialog(FileDialog target); - -/*************************************************************************/ - -/** - * Creates a peer object for the specified <code>CheckboxMenuItem</code>. - * - * @param target The <code>CheckboxMenuItem</code> to create the peer for. - * - * @return The peer for the specified <code>CheckboxMenuItem</code> object. - */ -protected abstract CheckboxMenuItemPeer -createCheckboxMenuItem(CheckboxMenuItem target); - -/*************************************************************************/ - -/** - * Creates a peer object for the specified <code>Component</code>. 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. - * - * XXX: FIXME - * - * @param target The <code>Component</code> to create the peer for. - * - * @return The peer for the specified <code>Component</code> object. - */ -protected LightweightPeer -createComponent(Component target) -{ - return null; -} - -/*************************************************************************/ - -/** - * Creates a peer object for the specified font name. - * - * @param name The font to create the peer for. - * @param style The font style to create the peer for. - * - * @return The peer for the specified font name. - */ -protected abstract FontPeer -getFontPeer(String name, int style); - -/*************************************************************************/ - -/** - * Copies the current system colors into the specified array. This is - * the interface used by the <code>SystemColors</code> class. - * - * @param colors The array to copy the system colors into. - */ -protected void -loadSystemColors(int systemColors[]) -{ -} - -/*************************************************************************/ - -/** - * Returns the dimensions of the screen in pixels. - * - * @return The dimensions of the screen in pixels. - */ -public abstract Dimension -getScreenSize(); - -/*************************************************************************/ - -/** - * Returns the screen resolution in dots per square inch. - * - * @return The screen resolution in dots per square inch. - */ -public abstract int -getScreenResolution(); - -/*************************************************************************/ - -/** - * Returns the color model of the screen. - * - * @return The color model of the screen. - */ -public abstract ColorModel -getColorModel(); - -/*************************************************************************/ - -/** - * Returns the names of the available fonts. - * - * @return The names of the available fonts. - */ -public abstract String[] -getFontList(); - -/*************************************************************************/ - -/** - * Return the font metrics for the specified font - * - * @param name The name of the font to return metrics for. - * - * @return The requested font metrics. - */ -public abstract FontMetrics -getFontMetrics(Font name); - -/*************************************************************************/ - -/** - * Flushes any buffered data to the screen so that it is in sync with - * what the AWT system has drawn to it. - */ -public abstract void -sync(); - -/*************************************************************************/ - -/** - * Returns an image from the specified file, which must be in a - * recognized format. Supported formats vary from toolkit to toolkit. - * - * @return name The name of the file to read the image from. - */ -public abstract Image -getImage(String name); - -/*************************************************************************/ - -/** - * Returns an image from the specified URL, which must be in a - * recognized format. Supported formats vary from toolkit to toolkit. - * - * @return url The URl to read the image from. - */ -public abstract Image -getImage(URL url); - -/*************************************************************************/ - -/** - * 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. - * - * @param image The image to prepare for rendering. - * @param width The width of the image. - * @param height The height of the image. - * @param observer The observer to receive events about the preparation - * process. - * - * @return <code>true</code> if the image is already prepared for rendering, - * <code>false</code> otherwise. - */ -public abstract boolean -prepareImage(Image image, int width, int height, ImageObserver observer); - -/*************************************************************************/ - -/** - * Checks the status of specified image as it is being readied for - * rendering. - * - * @param image The image to prepare for rendering. - * @param width The width of the image. - * @param height The height of the image. - * @param observer The observer to receive events about the preparation - * process. - * - * @return A union of the bitmasks from - * <code>java.awt.image.ImageObserver</code> that indicates the current - * state of the imaging readying process. - */ -public abstract int -checkImage(Image image, int width, int height, ImageObserver observer); - -/*************************************************************************/ - -/** - * Creates an image using the specified <code>ImageProducer</code> - * - * @param producer The <code>ImageProducer</code> to create the image from. - * - * @return The created image. - */ -public abstract Image -createImage(ImageProducer producer); - -/*************************************************************************/ - -/** - * 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. - * - * @param data The raw image data. - * @param offset The offset into the data where the image data starts. - * @param len The length of the image data. - * - * @return The created image. - */ -public abstract Image -createImage(byte[] data, int offset, int len); - -/*************************************************************************/ - -/** - * Creates an image from the specified byte array. The array must be in - * a recognized format. Supported formats vary from toolkit to toolkit. - * - * @param data The raw image data. - * - * @return The created image. - */ -public Image -createImage(byte[] data) -{ - return(createImage(data, 0, data.length)); -} - -public abstract Image -createImage(String filename); - -public abstract Image -createImage(URL url); - - -/*************************************************************************/ - -/** - * Returns a instance of <code>PrintJob</code> for the specified - * arguments. - * - * @param frame The window initiating the print job. - * @param title The print job title. - * @param props The print job properties. - * - * @return The requested print job, or <code>null</code> if the job - * was cancelled. - */ -public abstract PrintJob -getPrintJob(Frame frame, String title, Properties props); - -/*************************************************************************/ - -/** - * Returns the system clipboard. - * - * @return THe system clipboard. - */ -public abstract Clipboard -getSystemClipboard(); - -/*************************************************************************/ - -/** - * Returns the accelerator key mask for menu shortcuts. The default is - * <code>Event.CTRL_MASK</code>. A toolkit must override this method - * to change the default. - * - * @return The key mask for the menu accelerator key. - */ -public int -getMenuShortcutKeyMask() -{ - return Event.CTRL_MASK; -} - -public boolean -getLockingKeyState(int keyCode) -{ - if (keyCode != KeyEvent.VK_CAPS_LOCK - && keyCode != KeyEvent.VK_NUM_LOCK - && keyCode != KeyEvent.VK_SCROLL_LOCK) - throw new IllegalArgumentException(); - - throw new UnsupportedOperationException(); -} - -public void -setLockingKeyState(int keyCode, boolean on) -{ - if (keyCode != KeyEvent.VK_CAPS_LOCK - && keyCode != KeyEvent.VK_NUM_LOCK - && keyCode != KeyEvent.VK_SCROLL_LOCK) - throw new IllegalArgumentException(); - - throw new UnsupportedOperationException(); -} - -/*************************************************************************/ - -/** - * Returns the event queue for the applet. Despite the word "System" - * in the name of this method, there is no guarantee that the same queue - * is shared system wide. - * - * @return The event queue for this applet (or application) - */ -public final EventQueue -getSystemEventQueue() -{ - return(getSystemEventQueueImpl()); -} - -/*************************************************************************/ - -/** - * // FIXME: What does this do? - */ -protected abstract EventQueue -getSystemEventQueueImpl(); - -/*************************************************************************/ - -/** - * Causes a "beep" tone to be generated. - */ -public abstract void -beep(); - -public Cursor -createCustomCursor(Image cursor, Point hotSpot, String name) - throws IndexOutOfBoundsException -{ - // Presumably the only reason this isn't abstract is for backwards - // compatibility? FIXME? - return null; -} - -public Dimension -getBestCursorSize(int preferredWidth, int preferredHeight) -{ - return new Dimension (0,0); -} - -public int -getMaximumCursorColors() -{ - return 0; -} - -public final Object -getDesktopProperty(String propertyName) -{ - return desktopProperties.get(propertyName); -} - -protected final void -setDesktopProperty(String name, Object newValue) -{ - Object oldValue = getDesktopProperty(name); - desktopProperties.put(name, newValue); - changeSupport.firePropertyChange(name, oldValue, newValue); -} -protected Object -lazilyLoadDesktopProperty(String name) -{ - // FIXME - what is this?? - return null; -} - -protected void -initializeDesktopProperties() -{ - // Overridden by toolkit implementation? -} - -public void -addPropertyChangeListener(String name, PropertyChangeListener pcl) -{ - changeSupport.addPropertyChangeListener(name, pcl); -} - -public void -removePropertyChangeListener(String name, PropertyChangeListener pcl) -{ - changeSupport.removePropertyChangeListener(name, pcl); -} - -public void -addAWTEventListener(AWTEventListener listener, long eventMask) -{ - // SecurityManager s = System.getSecurityManager(); - // if (s != null) - // s.checkPermission(AWTPermission("listenToAllAWTEvents")); - - // FIXME -} - -public void -removeAWTEventListener(AWTEventListener listener) +public abstract class Toolkit { - // FIXME -} - + /** The default toolkit name. */ + private static String default_toolkit_name + = "gnu.java.awt.peer.gtk.GtkToolkit"; + + /** + * The toolkit in use. Once we load it, we don't ever change it + * if the awt.toolkit propert is set. + */ + private static Toolkit toolkit; + + /** The toolkit properties. */ + private static Properties props = new Properties(); + + protected final Map desktopProperties = new Properties(); + + protected final PropertyChangeSupport desktopPropsSupport + = new PropertyChangeSupport(this); + + /** + * Default constructor for subclasses. + */ + public Toolkit() + { + } + + /** + * Creates a peer object for the specified <code>Button</code>. + * + * @param target The <code>Button</code> to create the peer for. + * @return The peer for the specified <code>Button</code> object. + */ + protected abstract ButtonPeer createButton(Button target); + + /** + * Creates a peer object for the specified <code>TextField</code>. + * + * @param target The <code>TextField</code> to create the peer for. + * @return The peer for the specified <code>TextField</code> object. + */ + protected abstract TextFieldPeer createTextField(TextField target); + + /** + * Creates a peer object for the specified <code>Label</code>. + * + * @param target The <code>Label</code> to create the peer for. + * @return The peer for the specified <code>Label</code> object. + */ + protected abstract LabelPeer createLabel(Label target); + + /** + * Creates a peer object for the specified <code>List</code>. + * + * @param target The <code>List</code> to create the peer for. + * @return The peer for the specified <code>List</code> object. + */ + protected abstract ListPeer createList(List target); + + /** + * Creates a peer object for the specified <code>Checkbox</code>. + * + * @param target The <code>Checkbox</code> to create the peer for. + * @return The peer for the specified <code>Checkbox</code> object. + */ + protected abstract CheckboxPeer createCheckbox(Checkbox target); + + /** + * Creates a peer object for the specified <code>Scrollbar</code>. + * + * @param target The <code>Scrollbar</code> to create the peer for. + * @return The peer for the specified <code>Scrollbar</code> object. + */ + protected abstract ScrollbarPeer createScrollbar(Scrollbar target); + + /** + * Creates a peer object for the specified <code>ScrollPane</code>. + * + * @param target The <code>ScrollPane</code> to create the peer for. + * @return The peer for the specified <code>ScrollPane</code> object. + */ + protected abstract ScrollPanePeer createScrollPane(ScrollPane target); + + /** + * Creates a peer object for the specified <code>TextArea</code>. + * + * @param target The <code>TextArea</code> to create the peer for. + * @return The peer for the specified <code>TextArea</code> object. + */ + protected abstract TextAreaPeer createTextArea(TextArea target); + + /** + * Creates a peer object for the specified <code>Choice</code>. + * + * @param target The <code>Choice</code> to create the peer for. + * @return The peer for the specified <code>Choice</code> object. + */ + protected abstract ChoicePeer createChoice(Choice target); + + /** + * Creates a peer object for the specified <code>Frame</code>. + * + * @param target The <code>Frame</code> to create the peer for. + * @return The peer for the specified <code>Frame</code> object. + */ + protected abstract FramePeer createFrame(Frame target); + + /** + * Creates a peer object for the specified <code>Canvas</code>. + * + * @param target The <code>Canvas</code> to create the peer for. + * @return The peer for the specified <code>Canvas</code> object. + */ + protected abstract CanvasPeer createCanvas(Canvas target); + + /** + * Creates a peer object for the specified <code>Panel</code>. + * + * @param target The <code>Panel</code> to create the peer for. + * @return The peer for the specified <code>Panel</code> object. + */ + protected abstract PanelPeer createPanel(Panel target); + + /** + * Creates a peer object for the specified <code>Window</code>. + * + * @param target The <code>Window</code> to create the peer for. + * @return The peer for the specified <code>Window</code> object. + */ + protected abstract WindowPeer createWindow(Window target); + + /** + * Creates a peer object for the specified <code>Dialog</code>. + * + * @param target The dialog to create the peer for + * @return The peer for the specified font name. + */ + protected abstract DialogPeer createDialog(Dialog target); + + /** + * Creates a peer object for the specified <code>MenuBar</code>. + * + * @param target The <code>MenuBar</code> to create the peer for. + * @return The peer for the specified <code>MenuBar</code> object. + */ + protected abstract MenuBarPeer createMenuBar(MenuBar target); + + /** + * Creates a peer object for the specified <code>Menu</code>. + * + * @param target The <code>Menu</code> to create the peer for. + * @return The peer for the specified <code>Menu</code> object. + */ + protected abstract MenuPeer createMenu(Menu target); + + /** + * Creates a peer object for the specified <code>PopupMenu</code>. + * + * @param target The <code>PopupMenu</code> to create the peer for. + * @return The peer for the specified <code>PopupMenu</code> object. + */ + protected abstract PopupMenuPeer createPopupMenu(PopupMenu target); + + /** + * Creates a peer object for the specified <code>MenuItem</code>. + * + * @param target The <code>MenuItem</code> to create the peer for. + * @return The peer for the specified <code>MenuItem</code> object. + */ + protected abstract MenuItemPeer createMenuItem(MenuItem target); + + /** + * Creates a peer object for the specified <code>FileDialog</code>. + * + * @param target The <code>FileDialog</code> to create the peer for. + * @return The peer for the specified <code>FileDialog</code> object. + */ + protected abstract FileDialogPeer createFileDialog(FileDialog target); + + /** + * Creates a peer object for the specified <code>CheckboxMenuItem</code>. + * + * @param target The <code>CheckboxMenuItem</code> to create the peer for. + * @return The peer for the specified <code>CheckboxMenuItem</code> object. + */ + protected abstract CheckboxMenuItemPeer + createCheckboxMenuItem(CheckboxMenuItem target); + + /** + * Creates a peer object for the specified <code>Component</code>. 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. + * + * XXX: FIXME + * + * @param target The <code>Component</code> to create the peer for. + * @return The peer for the specified <code>Component</code> object. + */ + protected LightweightPeer createComponent(Component target) + { + return null; + } + + /** + * Creates a peer object for the specified font name. + * + * @param name The font to create the peer for. + * @param style The font style to create the peer for. + * @return The peer for the specified font name. + */ + protected abstract FontPeer getFontPeer(String name, int style); + + /** + * Copies the current system colors into the specified array. This is + * the interface used by the <code>SystemColors</code> class. + * + * @param colors The array to copy the system colors into. + */ + protected void loadSystemColors(int systemColors[]) + { + // XXX Implement. + } + + /** + * @since 1.4 + */ + public void setDynamicLayout(boolean dynamic) + { + } + + /** + * @since 1.4 + */ + protected boolean isDynamicLayoutSet() + { + return false; + } + + /** + * @since 1.4 + */ + public boolean isDynamicLayoutActive() + { + return false; + } + + /** + * Returns the dimensions of the screen in pixels. + * + * @return The dimensions of the screen in pixels. + */ + public abstract Dimension getScreenSize(); + + /** + * Returns the screen resolution in dots per square inch. + * + * @return The screen resolution in dots per square inch. + */ + public abstract int getScreenResolution(); + + /** + * @since 1.4 + */ + public Insets getScreenInsets(GraphicsConfiguration gc) + { + return null; + } + + /** + * Returns the color model of the screen. + * + * @return The color model of the screen. + */ + public abstract ColorModel getColorModel(); + + /** + * Returns the names of the available fonts. + * + * @return The names of the available fonts. + */ + public abstract String[] getFontList(); + + /** + * Return the font metrics for the specified font + * + * @param name The name of the font to return metrics for. + * @return The requested font metrics. + */ + public abstract FontMetrics getFontMetrics(Font name); + + /** + * Flushes any buffered data to the screen so that it is in sync with + * what the AWT system has drawn to it. + */ + public abstract void sync(); + + /** + * Returns an instance of the default toolkit. The default toolkit is + * the subclass of <code>Toolkit</code> specified in the system property + * <code>awt.toolkit</code>, or <code>gnu.java.awt.peer.gtk.GtkToolkit</code> + * if the property is not set. + * + * @return An instance of the system default toolkit. + * @throws AWTError If the toolkit cannot be loaded. + */ + public static Toolkit getDefaultToolkit() + { + if (toolkit != null) + return toolkit; + String toolkit_name = System.getProperty("awt.toolkit", + default_toolkit_name); + try + { + Class cls = Class.forName(toolkit_name); + Object obj = cls.newInstance(); + if (!(obj instanceof Toolkit)) + throw new AWTError(toolkit_name + " is not a subclass of " + + "java.awt.Toolkit"); + toolkit = (Toolkit) obj; + return toolkit; + } + catch (Exception e) + { + throw new AWTError("Cannot load AWT toolkit: " + e.getMessage()); + } + } + + /** + * Returns an image from the specified file, which must be in a + * recognized format. Supported formats vary from toolkit to toolkit. + * + * @return name The name of the file to read the image from. + */ + public abstract Image getImage(String name); + + /** + * Returns an image from the specified URL, which must be in a + * recognized format. Supported formats vary from toolkit to toolkit. + * + * @return url The URl to read the image from. + */ + public abstract Image getImage(URL url); + + public abstract Image createImage(String filename); + + public abstract Image createImage(URL url); + + /** + * 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. + * + * @param image The image to prepare for rendering. + * @param width The width of the image. + * @param height The height of the image. + * @param observer The observer to receive events about the preparation + * process. + * @return <code>true</code> if the image is already prepared for rendering, + * <code>false</code> otherwise. + */ + public abstract boolean prepareImage(Image image, int width, int height, + ImageObserver observer); + + /** + * Checks the status of specified image as it is being readied for + * rendering. + * + * @param image The image to prepare for rendering. + * @param width The width of the image. + * @param height The height of the image. + * @param observer The observer to receive events about the preparation + * process. + * @return A union of the bitmasks from + * <code>java.awt.image.ImageObserver</code> that indicates the current + * state of the imaging readying process. + */ + public abstract int checkImage(Image image, int width, int height, + ImageObserver observer); + + /** + * Creates an image using the specified <code>ImageProducer</code> + * + * @param producer The <code>ImageProducer</code> to create the image from. + * @return The created image. + */ + public abstract Image createImage(ImageProducer producer); + + /** + * Creates an image from the specified byte array. The array must be in + * a recognized format. Supported formats vary from toolkit to toolkit. + * + * @param data The raw image data. + * @return The created image. + */ + public Image createImage(byte[] data) + { + return createImage(data, 0, data.length); + } + + /** + * 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. + * + * @param data The raw image data. + * @param offset The offset into the data where the image data starts. + * @param len The length of the image data. + * @return The created image. + */ + public abstract Image createImage(byte[] data, int offset, int len); + + /** + * Returns a instance of <code>PrintJob</code> for the specified + * arguments. + * + * @param frame The window initiating the print job. + * @param title The print job title. + * @param props The print job properties. + * @return The requested print job, or <code>null</code> if the job + * was cancelled. + */ + public abstract PrintJob getPrintJob(Frame frame, String title, + Properties props); + + + /** + * @since 1.3 + */ + public PrintJob getPrintJob(Frame frame, String title, + JobAttributes jobAttr, PageAttributes pageAttr) + { + return null; + } + + /** + * Causes a "beep" tone to be generated. + */ + public abstract void beep(); + + /** + * Returns the system clipboard. + * + * @return THe system clipboard. + */ + public abstract Clipboard getSystemClipboard(); + + /** + * @since 1.4 + */ + public Clipboard getSystemSelection() + { + return null; + } + + /** + * Returns the accelerator key mask for menu shortcuts. The default is + * <code>Event.CTRL_MASK</code>. A toolkit must override this method + * to change the default. + * + * @return The key mask for the menu accelerator key. + */ + public int getMenuShortcutKeyMask() + { + return Event.CTRL_MASK; + } + + public boolean getLockingKeyState(int keyCode) + { + if (keyCode != KeyEvent.VK_CAPS_LOCK + && keyCode != KeyEvent.VK_NUM_LOCK + && keyCode != KeyEvent.VK_SCROLL_LOCK) + throw new IllegalArgumentException(); + throw new UnsupportedOperationException(); + } + + public void setLockingKeyState(int keyCode, boolean on) + { + if (keyCode != KeyEvent.VK_CAPS_LOCK + && keyCode != KeyEvent.VK_NUM_LOCK + && keyCode != KeyEvent.VK_SCROLL_LOCK) + throw new IllegalArgumentException(); + throw new UnsupportedOperationException(); + } + + /** + * Returns the native container object of the specified component. This + * method is necessary because the parent component might be a lightweight + * component. + * + * @param component The component to fetch the native container for. + * @return The native container object for this component. + */ + protected static Container getNativeContainer(Component component) + { + component = component.getParent(); + while (true) + { + if (component == null) + return null; + if (! (component instanceof Container)) + { + component = component.getParent(); + continue; + } + if (component.getPeer() instanceof LightweightPeer) + { + component = component.getParent(); + continue; + } + return (Container) component; + } + } + + public Cursor createCustomCursor(Image cursor, Point hotSpot, String name) + { + // Presumably the only reason this isn't abstract is for backwards + // compatibility? FIXME? + return null; + } + + public Dimension getBestCursorSize(int preferredWidth, int preferredHeight) + { + return new Dimension (0,0); + } + + public int getMaximumCursorColors() + { + return 0; + } + + /** + * @since 1.4 + */ + public boolean isFrameStateSupported(int state) + { + return false; + } + + /** + * Returns the value of the property with the specified name, or the + * default value if the property does not exist. + * + * @param key The name of the property to retrieve. + * @param defThe default value of the property. + */ + public static String getProperty(String key, String def) + { + return props.getProperty(key, def); + } + + /** + * Returns the event queue for the applet. Despite the word "System" + * in the name of this method, there is no guarantee that the same queue + * is shared system wide. + * + * @return The event queue for this applet (or application) + */ + public final EventQueue getSystemEventQueue() + { + return getSystemEventQueueImpl(); + } + + /** + * // FIXME: What does this do? + */ + protected abstract EventQueue getSystemEventQueueImpl(); + + /** + * @since 1.3 + */ + public abstract DragSourceContextPeer + createDragSourceContextPeer(DragGestureEvent e); + + /** + * @since 1.3 + */ + public DragGestureRecognizer + createDragGestureRecognizer(Class recognizer, DragSource ds, + Component comp, int actions, + DragGestureListener l) + { + return null; + } + + public final Object getDesktopProperty(String propertyName) + { + return desktopProperties.get(propertyName); + } + + protected final void setDesktopProperty(String name, Object newValue) + { + Object oldValue = getDesktopProperty(name); + desktopProperties.put(name, newValue); + desktopPropsSupport.firePropertyChange(name, oldValue, newValue); + } + + protected Object lazilyLoadDesktopProperty(String name) + { + // FIXME - what is this?? + return null; + } + + protected void initializeDesktopProperties() + { + // Overridden by toolkit implementation? + } + + public void addPropertyChangeListener(String name, + PropertyChangeListener pcl) + { + desktopPropsSupport.addPropertyChangeListener(name, pcl); + } + + public void removePropertyChangeListener(String name, + PropertyChangeListener pcl) + { + desktopPropsSupport.removePropertyChangeListener(name, pcl); + } + + /** + * @since 1.4 + */ + public PropertyChangeListener[] getPropertyChangeListeners() + { + return desktopPropsSupport.getPropertyChangeListeners(); + } + + /** + * @since 1.4 + */ + public PropertyChangeListener[] getPropertyChangeListeners(String name) + { + return desktopPropsSupport.getPropertyChangeListeners(name); + } + + public void addAWTEventListener(AWTEventListener listener, long eventMask) + { + // SecurityManager s = System.getSecurityManager(); + // if (s != null) + // s.checkPermission(AWTPermission("listenToAllAWTEvents")); + // FIXME + } + + public void removeAWTEventListener(AWTEventListener listener) + { + // FIXME + } + + /** + * @since 1.4 + */ + public AWTEventListener[] getAWTEventListeners() + { + return null; + } + + /** + * @since 1.4 + */ + public AWTEventListener[] getAWTEventListeners(long mask) + { + return null; + } + + /** + * @since 1.3 + */ + public abstract Map mapInputMethodHighlight(InputMethodHighlight highlight); } // class Toolkit |