| /******************************************************************************* |
| * Copyright (c) 2000, 2004 IBM Corporation and others. |
| * All rights reserved. This program and the accompanying materials |
| * are made available under the terms of the Eclipse Public License v1.0 |
| * which accompanies this distribution, and is available at |
| * http://www.eclipse.org/legal/epl-v10.html |
| * |
| * Contributors: |
| * IBM Corporation - initial API and implementation |
| *******************************************************************************/ |
| package org.eclipse.swt.awt; |
| |
| import java.awt.Canvas; |
| import java.awt.Frame; |
| |
| import org.eclipse.swt.SWT; |
| import org.eclipse.swt.widgets.Composite; |
| import org.eclipse.swt.widgets.Display; |
| import org.eclipse.swt.widgets.Shell; |
| |
| /** |
| * This class provides a bridge between SWT and AWT, so that it |
| * is possible to embedded AWT components in SWT and vice versa. |
| * |
| * @since 3.0 |
| */ |
| public class SWT_AWT { |
| |
| /** |
| * The name of the embedded Frame class. The default class name |
| * for the platform will be used if <code>null</code>. |
| */ |
| public static String embeddedFrameClass; |
| |
| /** |
| * Creates a new <code>java.awt.Frame</code>. 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. |
| * <p> |
| * 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 <code>java.awt.Panel</code> |
| * be added to the frame as the root of all components. |
| * </p> |
| * |
| * @param parent the parent <code>Composite</code> of the new <code>java.awt.Frame</code> |
| * @return a <code>java.awt.Frame</code> to be the parent of the embedded AWT components |
| * |
| * @exception IllegalArgumentException <ul> |
| * <li>ERROR_NULL_ARGUMENT - if the parent is null</li> |
| * <li>ERROR_INVALID_ARGUMENT - if the parent Composite does not have the SWT.EMBEDDED style</li> |
| * </ul> |
| * |
| * @since 3.0 |
| */ |
| public static Frame new_Frame (final Composite parent) { |
| if (parent == null) SWT.error (SWT.ERROR_NULL_ARGUMENT); |
| if ((parent.getStyle () & SWT.EMBEDDED) == 0) { |
| SWT.error (SWT.ERROR_INVALID_ARGUMENT); |
| } |
| SWT.error (SWT.ERROR_NOT_IMPLEMENTED); |
| return null; |
| } |
| |
| /** |
| * Creates a new <code>Shell</code>. This Shell is the root for |
| * the SWT widgets that will be embedded within the AWT canvas. |
| * |
| * @param display the display for the new Shell |
| * @param parent the parent <code>java.awt.Canvas</code> of the new Shell |
| * @return a <code>Shell</code> to be the parent of the embedded SWT widgets |
| * |
| * @exception IllegalArgumentException <ul> |
| * <li>ERROR_NULL_ARGUMENT - if the display is null</li> |
| * <li>ERROR_NULL_ARGUMENT - if the parent is null</li> |
| * <li>ERROR_INVALID_ARGUMENT - if the parent's peer is not created</li> |
| * </ul> |
| * |
| * @since 3.0 |
| */ |
| public static Shell new_Shell (final Display display, final Canvas parent) { |
| if (display == null) SWT.error (SWT.ERROR_NULL_ARGUMENT); |
| if (parent == null) SWT.error (SWT.ERROR_NULL_ARGUMENT); |
| SWT.error (SWT.ERROR_NOT_IMPLEMENTED); |
| return null; |
| } |
| } |