Overrides java.awt.Frame.addNotify.

Doc from java.awt.Frame.addNotify.

Makes this Frame displayable by connecting it to a native screen resource. Making a frame displayable will cause any of its children to be made displayable. This method is called internally by the toolkit and should not be called directly by programs.

Implements java.awt.KeyEventDispatcher.dispatchKeyEvent.

Need this method to detect when the focus may have chance to leave the focus cycle root which is EmbeddedFrame. Mostly, the code here is copied from DefaultKeyboardFocusManager.processKeyEvent with some minor modifications.

Overrides java.awt.Component.getCursor.

Doc from java.awt.Component.getCursor.

Gets the cursor set in the component. If the component does not have a cursor set, the cursor of its parent is returned. If no cursor is set in the entire hierarchy, Cursor.DEFAULT_CURSOR is returned.

Overrides java.awt.Component.getParent.

Block introspection of a parent window by this child.

Overrides java.awt.Window.hide.

Needed to avoid memory leak: we register this EmbeddedFrame as a listener with the KeyboardFocusManager. We don't want the KFM to keep reference to our EmbeddedFrame forever if the Frame is no longer in use, so we add listeners in show() and remove them in hide().

Annotations

@SuppressWarnings:deprecation

Overrides java.awt.Frame.isResizable.

Doc from java.awt.Frame.isResizable.

Indicates whether this frame is resizable by the user. By default, all frames are initially resizable.

This method should be overridden in subclasses. It is called when window this frame is within should be blocked by some modal dialog.

Implements java.beans.PropertyChangeListener.propertyChange.

Needed to track which KeyboardFocusManager is current. We want to avoid memory leaks, so when KFM stops being current, we remove ourselves as listeners.

Those who want to use the functionality of traversing out of the EmbeddedFrame must call this method. After that, all the changes can be handled automatically, including possible replacement of KeyboardFocusManager.

Overrides java.awt.Frame.remove.

Implements java.awt.MenuContainer.remove.

Doc from java.awt.Frame.remove.

Removes the specified menu bar from this frame.

Overrides java.awt.Frame.setIconImage.

Doc from java.awt.Frame.setIconImage.

Sets the image to be displayed as the icon for this window.

This method can be used instead of setIconImages() to specify a single image as a window's icon.

The following statement:

    setIconImage(image);

    ArrayList<Image> imageList = new ArrayList<Image>();
    imageList.add(image);
    setIconImages(imageList);

Note : Native windowing systems may use different images of differing dimensions to represent a window, depending on the context (e.g. window decoration, window list, taskbar, etc.). They could also use just a single image for all contexts or no image at all.

Overrides java.awt.Window.setIconImages.

Doc from java.awt.Window.setIconImages.

Sets the sequence of images to be displayed as the icon for this window. Subsequent calls to getIconImages will always return a copy of the icons list.

Depending on the platform capabilities one or several images of different dimensions will be used as the window's icon.

The icons list can contain MultiResolutionImage images also. Suitable image depending on screen resolution is extracted from base MultiResolutionImage image and added to the icons list while base resolution image is removed from list. The icons list is scanned for the images of most appropriate dimensions from the beginning. If the list contains several images of the same size, the first will be used.

Ownerless windows with no icon specified use platform-default icon. The icon of an owned window may be inherited from the owner unless explicitly overridden. Setting the icon to null or empty list restores the default behavior.

Note : Native windowing systems may use different images of differing dimensions to represent a window, depending on the context (e.g. window decoration, window list, taskbar, etc.). They could also use just a single image for all contexts or no image at all.

Overrides java.awt.Frame.setMenuBar.

Doc from java.awt.Frame.setMenuBar.

Sets the menu bar for this frame to the specified menu bar.

Overrides java.awt.Frame.setResizable.

Doc from java.awt.Frame.setResizable.

Sets whether this frame is resizable by the user.

Overrides java.awt.Frame.setTitle.

Block modifying any frame attributes, since they aren't applicable for EmbeddedFrames.

Overrides java.awt.Window.show.

Needed to avoid memory leak: we register this EmbeddedFrame as a listener with the KeyboardFocusManager. We don't want the KFM to keep reference to our EmbeddedFrame forever if the Frame is no longer in use, so we add listeners in show() and remove them in hide().

Annotations

@SuppressWarnings:deprecation

Synthesize native message to activate or deactivate EmbeddedFrame window depending on the value of parameter b. Peers should override this method if they are to implement this functionality.

Parameters

doActivate:boolean

if true, activates the window; otherwise, deactivates the window

Overrides java.awt.Window.toBack.

Doc from java.awt.Window.toBack.

If this Window is visible, sends this Window to the back and may cause it to lose focus or activation if it is the focused or active Window.

Places this Window at the bottom of the stacking order and shows it behind any other Windows in this VM. No action will take place is this Window is not visible. Some platforms do not allow Windows which are owned by other Windows to appear below their owners. Every attempt will be made to move this Window as low as possible in the stacking order; however, developers should not assume that this method will move this Window below all other windows in every situation.

Because of variations in native windowing systems, no guarantees about changes to the focused and active Windows can be made. Developers must never assume that this Window is no longer the focused or active Window until this Window receives a WINDOW_LOST_FOCUS or WINDOW_DEACTIVATED event. On platforms where the top-most window is the focused window, this method will probably cause this Window to lose focus. In that case, the next highest, focusable Window in this VM will receive focus. On platforms where the stacking order does not typically affect the focused window, this method will probably leave the focused and active Windows unchanged.

Overrides java.awt.Window.toFront.

Doc from java.awt.Window.toFront.

If this Window is visible, brings this Window to the front and may make it the focused Window.

Places this Window at the top of the stacking order and shows it in front of any other Windows in this VM. No action will take place if this Window is not visible. Some platforms do not allow Windows which own other Windows to appear on top of those owned Windows. Some platforms may not permit this VM to place its Windows above windows of native applications, or Windows of other VMs. This permission may depend on whether a Window in this VM is already focused. Every attempt will be made to move this Window as high as possible in the stacking order; however, developers should not assume that this method will move this Window above all other windows in every situation.

Developers must never assume that this Window is the focused or active Window until this Window receives a WINDOW_GAINED_FOCUS or WINDOW_ACTIVATED event. On platforms where the top-most window is the focused window, this method will probably focus this Window (if it is not already focused) under the following conditions:

• The window meets the requirements outlined in the isFocusableWindow method.
• The window's property autoRequestFocus is of the true value.
• Native windowing system allows the window to get focused.

If this method causes this Window to be focused, and this Window is a Frame or a Dialog, it will also become activated. If this Window is focused, but it is not a Frame or a Dialog, then the first Frame or Dialog that is an owner of this Window will be activated.

If this window is blocked by modal dialog, then the blocking dialog is brought to the front and remains above the blocked window.

This method is called by the embedder when we should receive focus as element of the traversal chain. The method requests focus on: 1. the first Component of this EmbeddedFrame if user moves focus forward in the focus traversal cycle. 2. the last Component of this EmbeddedFrame if user moves focus backward in the focus traversal cycle. The direction parameter specifies which of the two mentioned cases is happening. Use FORWARD and BACKWARD constants defined in the EmbeddedFrame class to avoid confusing boolean values. A concrete implementation of this method is defined in the platform-dependent subclasses.

Parameters

direction:boolean

FORWARD or BACKWARD

Returns:boolean

true, if the EmbeddedFrame wants to get focus, false otherwise.