sun.awt.peer.cacio

Interface PlatformWindow

All Known Subinterfaces:

PlatformToplevelWindow

public interface PlatformWindow

Method Summary

Methods

Modifier and Type	Method and Description
void	applyShape(sun.java2d.pipe.Region shape) Applies the specified shape to the native component window.
boolean	canDetermineObscurity() Returns true if the platform window implementation can determine if the window has been obscured, false otherwise.
void	createBuffers(int numBuffers, BufferCapabilities caps) Creates back buffers for flipping.
void	destroyBuffers() Destroys the flipping buffers.
void	dispose() Disposes the underlying platform window and releases all associated resources.
void	flip(int x1, int y1, int x2, int y2, BufferCapabilities.FlipContents flipAction) Flips the (current) backbuffer to the front buffer.
Image	getBackBuffer() Provides access to the (current) backbuffer as an image.
Rectangle	getBounds() Returns the bounds of the native window.
ColorModel	getColorModel() Returns the color model used by the native window.
Graphics2D	getGraphics(Color foreground, Color background, Font font) Returns a Graphics2D object for drawing on this window.
GraphicsConfiguration	getGraphicsConfiguration() Returns the graphics configuration used by the native window.
Insets	getInsets() Returns the insets of this native window.
Point	getLocationOnScreen() Returns the location of the native window on the screen.
boolean	isObscured() Returns true if the platform window implementation determines that it has been obscured, false otherwise.
boolean	isReparentSuppored() Returns true if reparenting of native windows is supported, false otherwise.
boolean	isRestackSupported() Returns true if the native window implementation supports restacking of the window hierarchy, false otherwise.
void	reparent(java.awt.peer.ContainerPeer newContainer) Reparents this native window to become a child of the specified container.
void	requestFocus() Request focus on the window.
boolean	requestFocus(Component lightweightChild, boolean temporary, boolean focusedWindowChangeAllowed, long time, sun.awt.CausedFocusEvent.Cause cause) Requests a focus change to this window.
void	restack() Updates the stacking order of the window hierarchy.
void	setBounds(int x, int y, int width, int height, int op) Sets the bounds of this native window.
void	setVisible(boolean b) Shows or hides this native window.

Method Detail

getColorModel

ColorModel getColorModel()

Returns the color model used by the native window.

Returns:

the color model used by the native window

getGraphicsConfiguration

GraphicsConfiguration getGraphicsConfiguration()

Returns the graphics configuration used by the native window.

Returns:

the graphics configuration used by the native window

getBounds

Rectangle getBounds()

Returns the bounds of the native window. The resulting rectangle has the X and Y coordinates of the window relative to its parent and the width and height of the window. For decorated windows the bounds must include the window decorations.

Returns:

the bounds of the native window

dispose

void dispose()

Disposes the underlying platform window and releases all associated resources.

getGraphics

Graphics2D getGraphics(Color foreground,
                     Color background,
                     Font font)

Returns a Graphics2D object for drawing on this window.

Parameters:

foreground - the foreground to be set

background - the background to be set

font - the font to be set

Returns:

a Graphics2D object for drawing on this window

setBounds

void setBounds(int x,
             int y,
             int width,
             int height,
             int op)

Sets the bounds of this native window. The X and Y coordinates are relative to the parent window (or the screen for toplevel windows). The op parameter specifies the actual operation of this methods, according to the various constants in ComponentPeer.

Parameters:

x -

y -

width -

height -

op -

See Also:

ComponentPeer.setBounds(int, int, int, int, int)

getInsets

Insets getInsets()

Returns the insets of this native window. Undecorated windows usually don't have insets. For decorated windows, the insets are the border widths of the window decoration. The PlatformWindow implementation is encouraged to cache the insets.

Returns:

the insets of this native window

getLocationOnScreen

Point getLocationOnScreen()

Returns the location of the native window on the screen. For decorated windows this must include the window decorations.

Returns:

the location of the native window on the screen

canDetermineObscurity

boolean canDetermineObscurity()

Returns true if the platform window implementation can determine if the window has been obscured, false otherwise.

Returns:

true if the platform window implementation can determine if the window has been obscured, false otherwise

See Also:

isObscured()

isObscured

boolean isObscured()

Returns true if the platform window implementation determines that it has been obscured, false otherwise. This is only called when canDetermineObscurity() returns true.

Returns:

true if the platform window implementation determines that it has been obscured, false otherwise

See Also:

canDetermineObscurity()

applyShape

void applyShape(sun.java2d.pipe.Region shape)

Applies the specified shape to the native component window.

Parameters:

shape - the shape to apply to the window

isReparentSuppored

boolean isReparentSuppored()

Returns true if reparenting of native windows is supported, false otherwise.

Returns:

true if reparenting of native windows is supported, false otherwise

See Also:

reparent(ContainerPeer)

reparent

void reparent(java.awt.peer.ContainerPeer newContainer)

Reparents this native window to become a child of the specified container. This is only called when isReparentSuppored() returns true.

Parameters:

newContainer - the new container window of this native window

See Also:

isReparentSuppored()

isRestackSupported

boolean isRestackSupported()

Returns true if the native window implementation supports restacking of the window hierarchy, false otherwise.

Returns:

true if the native window implementation supports restacking of the window hierarchy, false otherwise

restack

void restack()

Updates the stacking order of the window hierarchy. This is only called when isRestackSupported() returns true.

setVisible

void setVisible(boolean b)

Shows or hides this native window.

Parameters:

v - true shows this native window false hides it.

requestFocus

boolean requestFocus(Component lightweightChild,
                   boolean temporary,
                   boolean focusedWindowChangeAllowed,
                   long time,
                   sun.awt.CausedFocusEvent.Cause cause)

Requests a focus change to this window. If the focus change was successful it is necessary to send back the appropriate FocusEvent.

Parameters:

lightweightChild - the actual lightweight child that wants focus

temporary - true if the focus change should be temporary, false otherwise

focusedWindowChangeAllowed - true when changing the focus of the corresponding toplevel window is allowed, false otherwise

time - the time of the focus change request

cause - the cause of the focus change request

Returns:

true when the focus transfer is guaranteed to be successful, false otherwise

createBuffers

void createBuffers(int numBuffers,
                 BufferCapabilities caps)
                   throws AWTException

Creates back buffers for flipping. This method may throw an AWTException to indicate that flipping is not supported, in which case a blitting buffer strategy is used by AWT.

Parameters:

numBuffers - the number of buffers to create for flipping

caps - the required buffer capabilities

Throws:

AWTException - if flipping is not supported

destroyBuffers

void destroyBuffers()

Destroys the flipping buffers. If flipping is not supported (i.e. createBuffers() throws an AWTException), this method should do nothing.

See Also:

createBuffers(int, BufferCapabilities)

flip

void flip(int x1,
        int y1,
        int x2,
        int y2,
        BufferCapabilities.FlipContents flipAction)

Flips the (current) backbuffer to the front buffer. If flipping is not supported (i.e. createBuffers() throws an AWTException), this method should do nothing.

Parameters:

x1 - the area to flip, left X coordinate

y1 - the area to flip, top Y coordinate

x2 - the area to flip, right X coordinate

y2 - the area to flip, bottom Y coordinate

flipAction - the requested flip action

getBackBuffer

Image getBackBuffer()

Provides access to the (current) backbuffer as an image. If flipping is not supported (i.e. createBuffers() throws an AWTException), this method should do nothing.

Returns:

the current backbuffer, as an image

requestFocus

void requestFocus()

Request focus on the window. When the focus has been granted by the platform windowing implementation, the platform window needs to send an appropriate FOCUS_GAINED event. It is not necessary to send FOCUS_LOST events though.