Package org.eclipse.swt.awt
Class SWT_AWT
- java.lang.Object
-
- org.eclipse.swt.awt.SWT_AWT
-
public class SWT_AWT extends Object
This class provides a bridge between SWT and AWT, so that it is possible to embed AWT components in SWT and vice versa.- Since:
- 3.0
- See Also:
- Swing/AWT snippets, Sample code and further information
-
-
Field Summary
Fields Modifier and Type Field Description static String
embeddedFrameClass
The name of the embedded Frame class.
-
Constructor Summary
Constructors Constructor Description SWT_AWT()
-
Method Summary
All Methods Static Methods Concrete Methods Modifier and Type Method Description static Frame
getFrame(Composite parent)
Returns ajava.awt.Frame
which is the embedded frame associated with the specified composite.static Frame
new_Frame(Composite parent)
Creates a newjava.awt.Frame
.static Shell
new_Shell(Display display, Canvas parent)
Creates a newShell
.
-
-
-
Field Detail
-
embeddedFrameClass
public static String embeddedFrameClass
The name of the embedded Frame class. The default class name for the platform will be used ifnull
.
-
-
Method Detail
-
getFrame
public static Frame getFrame(Composite parent)
Returns ajava.awt.Frame
which is the embedded frame associated with the specified composite.- Parameters:
parent
- the parentComposite
of thejava.awt.Frame
- Returns:
- a
java.awt.Frame
the embedded frame ornull
. - Throws:
IllegalArgumentException
-- ERROR_NULL_ARGUMENT - if the parent is null
- Since:
- 3.2
-
new_Frame
public static Frame new_Frame(Composite parent)
Creates a newjava.awt.Frame
. This frame is the root for the AWT components that will be embedded within the composite. In order for the embedding to succeed, the composite must have been created with the SWT.EMBEDDED style.IMPORTANT: As of JDK1.5, the embedded frame does not receive mouse events. When a lightweight component is added as a child of the embedded frame, the cursor does not change. In order to work around both these problems, it is strongly recommended that a heavyweight component such as
java.awt.Panel
be added to the frame as the root of all components.- Parameters:
parent
- the parentComposite
of the newjava.awt.Frame
- Returns:
- a
java.awt.Frame
to be the parent of the embedded AWT components - Throws:
IllegalArgumentException
-- ERROR_NULL_ARGUMENT - if the parent is null
- ERROR_INVALID_ARGUMENT - if the parent Composite does not have the SWT.EMBEDDED style
- Since:
- 3.0
-
new_Shell
public static Shell new_Shell(Display display, Canvas parent)
Creates a newShell
. This Shell is the root for the SWT widgets that will be embedded within the AWT canvas.- Parameters:
display
- the display for the new Shellparent
- the parentjava.awt.Canvas
of the new Shell- Returns:
- a
Shell
to be the parent of the embedded SWT widgets - Throws:
IllegalArgumentException
-- ERROR_NULL_ARGUMENT - if the display is null
- ERROR_NULL_ARGUMENT - if the parent is null
- ERROR_INVALID_ARGUMENT - if the parent's peer is not created
- Since:
- 3.0
-
-