public abstract Class LightweightFrame

Adds a drop target to the lightweight frame.

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.

Annotations

@Override

Create a drag gesture recognizer for the lightweight frame.

Create a drag source context peer for the lightweight frame.

Requests the peer to emulate activation or deactivation of the frame. Peers should override this method if they are to implement this functionality.

Parameters

activate:boolean

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

Overrides java.awt.Component.getGraphics.

Doc from java.awt.Component.getGraphics.

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

Annotations

@Override

Returns the absolute bounds of the host (embedding) window.

Returns:Rectangle

the host window bounds

Overrides java.awt.Component.getParent.

Blocks introspection of a parent window by this child.

Returns:Container

null

Annotations

@Override

Returns the scale factor of this frame. The default value is 1.

Returns:int

the scale factor

Annotations

@Deprecated

since:9

See Also

notifyDisplayChanged(int)

Returns the scale factor of this frame along x coordinate. The default value is 1.

Returns:double

the x coordinate scale factor

Since

9

See Also

notifyDisplayChanged(double, double)

Returns the scale factor of this frame along y coordinate. The default value is 1.

Returns:double

the y coordinate scale factor

Since

9

See Also

notifyDisplayChanged(double, double)

Delegates the focus grab action to the client (embedding) application. The method is called by the AWT grab machinery.

See Also

SunToolkit#grab(java.awt.Window)

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.

Annotations

@Override

Called when display of the hosted frame is changed.

Parameters

scaleFactor:int

the scale factor

Annotations

@Deprecated

since:9

Called when display of the hosted frame is changed.

Parameters

scaleFactorX:double

the scale factor

scaleFactorY:double

the scale factor

Since

9

Overrides java.awt.Frame.remove.

Implements java.awt.MenuContainer.remove.

Doc from java.awt.Frame.remove.

Removes the specified menu bar from this frame.

Annotations

@Override

Removes a drop target from the lightweight frame.

Sets the absolute bounds of the host (embedding) window.

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.

Annotations

@Override

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.

Annotations

@Override

Overrides java.awt.Frame.setMenuBar.

Doc from java.awt.Frame.setMenuBar.

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

Annotations

@Override

Overrides java.awt.Frame.setResizable.

Doc from java.awt.Frame.setResizable.

Sets whether this frame is resizable by the user.

Annotations

@Override

Overrides java.awt.Frame.setTitle.

Doc from java.awt.Frame.setTitle.

Sets the title for this frame to the specified string.

Annotations

@Override

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.

Annotations

@Override

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.

Annotations

@Override

Delegates the focus ungrab action to the client (embedding) application. The method is called by the AWT grab machinery.

See Also

SunToolkit#ungrab(java.awt.Window)