JNA 3.0.9 · com.sun.jna.examples.WindowUtils

Provides additional features on a Java Window.

Non-rectangular shape (bitmap mask, no antialiasing)
Transparency (constant alpha applied to window contents or transparent background)
Fully transparent window (the transparency of all painted pixels is applied to the window).

NOTE: since there is no explicit way to force PopupFactory to use a heavyweight popup, and anything but a heavyweight popup will be clipped by a window mask, an additional subwindow is added to all masked windows to implicitly force PopupFactory to use a heavyweight window and avoid clipping.

Note

setWindowTransparent on X11 doesn't composite entirely correctly; depending on what's drawn in the window it mey be more or less noticable.

Note

Neither shaped windows nor transparency currently works with Java 1.4 under X11. This is at least partly due to 1.4 using multiple X11 windows for a single given Java window. It *might* be possible to remedy by applying the window region/transparency to all descendants, but I haven't tried it. In addition, windows must be both displayable and visible before the corresponding native Drawable may be obtained; in later Java versions, the window need only be displayable.

Note

If you use setWindowMask(Window, Shape) and override Window#paint(Graphics) on OS X, you'll need to explicitly set the clip mask on the Graphics object with the window mask; only the content pane of the window and below have the window mask automatically applied.

Nested and Inner Type Summary

Modifier and Type	Class and Description
private static class	WindowUtils.HeavyweightForcer This class forces a heavyweight popup on the parent `Window`.
private static class	WindowUtils.Holder Canonical lazy loading of a singleton.
private static class	WindowUtils.MacWindowUtils
public abstract static class	WindowUtils.NativeWindowUtils Window utilities with differing native implementations.
private abstract static class	WindowUtils.RepaintTrigger This can be installed over a `JLayeredPane` in order to listen for repaint requests.
private static class	WindowUtils.W32WindowUtils
private static class	WindowUtils.X11WindowUtils

Field Summary

Modifier and Type	Field and Description
public static boolean	doPaint
public static final Shape	MASK_NONE Use this to clear a window mask.
private static final String	TRANSPARENT_ALPHA
private static final String	TRANSPARENT_OLD_BG
private static final String	TRANSPARENT_OLD_OPAQUE

Access	Constructor and Description
public	WindowUtils()

Method Summary

Modifier and Type	Method and Description
public static GraphicsConfiguration	getAlphaCompatibleGraphicsConfiguration() Returns a `GraphicsConfiguration` comptible with alpha compositing.
private static WindowUtils.NativeWindowUtils	getInstance()
public static boolean	isWindowAlphaSupported() Indicate a window can have a global alpha setting.
public static void	setWindowAlpha(Window w, float alpha) Set the overall window transparency.
public static void	setWindowMask(Window w, Shape mask) Applies the given mask to the given window.
public static void	setWindowMask(Window w, Icon mask) Applies the given mask to the given window.
public static void	setWindowTransparent(Window w, boolean transparent) Set the window to be transparent.
public static void	whenDisplayable(Window w, final Runnable action) Execute the given action when the given window becomes displayable.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

public Class WindowUtils

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary