After javadoc bash for 3.7RC1AFTER_JAVADOC_BASH_FOR_37RC1

1 files changed, 217 insertions, 217 deletions

diff --git a/bundles/org.eclipse.swt/Eclipse SWT AWT/cocoa/org/eclipse/swt/awt/SWT_AWT.java b/bundles/org.eclipse.swt/Eclipse SWT AWT/cocoa/org/eclipse/swt/awt/SWT_AWT.java
index 08b8e4aefa..a80ca86abb 100755
--- a/bundles/org.eclipse.swt/Eclipse SWT AWT/cocoa/org/eclipse/swt/awt/SWT_AWT.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT AWT/cocoa/org/eclipse/swt/awt/SWT_AWT.java
@@ -83,231 +83,231 @@ public class SWT_AWT {
 		} catch (Throwable e) {}
 	}
 	
-	/**
-	 * Returns a <code>java.awt.Frame</code> which is the embedded frame
-	 * associated with the specified composite.
-	 * 
-	 * @param parent the parent <code>Composite</code> of the <code>java.awt.Frame</code>
-	 * @return a <code>java.awt.Frame</code> the embedded frame or <code>null</code>.
-	 * 
-	 * @exception IllegalArgumentException <ul>
-	 *    <li>ERROR_NULL_ARGUMENT - if the parent is null</li>
-	 * </ul>
-	 * 
-	 * @since 3.2
-	 */
-	public static Frame getFrame(Composite parent) {
-		if (parent == null) SWT.error(SWT.ERROR_NULL_ARGUMENT);
-		if ((parent.getStyle() & SWT.EMBEDDED) == 0) return null;
-		return (Frame) parent.getData(EMBEDDED_FRAME_KEY);
+/**
+ * Returns a <code>java.awt.Frame</code> which is the embedded frame
+ * associated with the specified composite.
+ * 
+ * @param parent the parent <code>Composite</code> of the <code>java.awt.Frame</code>
+ * @return a <code>java.awt.Frame</code> the embedded frame or <code>null</code>.
+ * 
+ * @exception IllegalArgumentException <ul>
+ *    <li>ERROR_NULL_ARGUMENT - if the parent is null</li>
+ * </ul>
+ * 
+ * @since 3.2
+ */
+public static Frame getFrame(Composite parent) {
+	if (parent == null) SWT.error(SWT.ERROR_NULL_ARGUMENT);
+	if ((parent.getStyle() & SWT.EMBEDDED) == 0) return null;
+	return (Frame) parent.getData(EMBEDDED_FRAME_KEY);
+}
+	
+/**
+ * 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);
 	}
 	
-	/**
-	 * 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);
+	final int /*long*/ handle = parent.view.id;
+	
+	Class clazz = null;
+	try {
+		String className = embeddedFrameClass != null ? embeddedFrameClass : "apple.awt.CEmbeddedFrame";
+		if (embeddedFrameClass == null) {
+			clazz = Class.forName(className, true, ClassLoader.getSystemClassLoader());
+		} else {
+			clazz = Class.forName(className);
 		}
-		
-		final int /*long*/ handle = parent.view.id;
-		
-		Class clazz = null;
-		try {
-			String className = embeddedFrameClass != null ? embeddedFrameClass : "apple.awt.CEmbeddedFrame";
-			if (embeddedFrameClass == null) {
-				clazz = Class.forName(className, true, ClassLoader.getSystemClassLoader());
-			} else {
-				clazz = Class.forName(className);
+	} catch (ClassNotFoundException cne) {
+		SWT.error (SWT.ERROR_NOT_IMPLEMENTED, cne);		
+	} catch (Throwable e) {
+		SWT.error (SWT.ERROR_UNSPECIFIED , e, " [Error while starting AWT]");		
+	}
+	
+	initializeSwing();
+	Object value = null;
+	Constructor constructor = null;
+	try {
+		constructor = clazz.getConstructor (new Class [] {long.class});
+		value = constructor.newInstance (new Object [] {new Long(handle)});
+	} catch (Throwable e) {
+		SWT.error(SWT.ERROR_NOT_IMPLEMENTED, e);
+	}
+	final Frame frame = (Frame) value;
+	frame.addNotify();
+	
+	parent.setData(EMBEDDED_FRAME_KEY, frame);
+	
+	/* Forward the iconify and deiconify events */
+	final Listener shellListener = new Listener () {
+		public void handleEvent (Event e) {
+			switch (e.type) {
+				case SWT.Deiconify:
+					EventQueue.invokeLater(new Runnable () {
+						public void run () {
+							frame.dispatchEvent (new WindowEvent (frame, WindowEvent.WINDOW_DEICONIFIED));
+						}
+					});
+					break;
+				case SWT.Iconify:
+					EventQueue.invokeLater(new Runnable () {
+						public void run () {
+							frame.dispatchEvent (new WindowEvent (frame, WindowEvent.WINDOW_ICONIFIED));
+						}
+					});
+					break;
 			}
-		} catch (ClassNotFoundException cne) {
-			SWT.error (SWT.ERROR_NOT_IMPLEMENTED, cne);		
-		} catch (Throwable e) {
-			SWT.error (SWT.ERROR_UNSPECIFIED , e, " [Error while starting AWT]");		
-		}
-		
-		initializeSwing();
-		Object value = null;
-		Constructor constructor = null;
-		try {
-			constructor = clazz.getConstructor (new Class [] {long.class});
-			value = constructor.newInstance (new Object [] {new Long(handle)});
-		} catch (Throwable e) {
-			SWT.error(SWT.ERROR_NOT_IMPLEMENTED, e);
 		}
-		final Frame frame = (Frame) value;
-		frame.addNotify();
-		
-		parent.setData(EMBEDDED_FRAME_KEY, frame);
-		
-		/* Forward the iconify and deiconify events */
-		final Listener shellListener = new Listener () {
-			public void handleEvent (Event e) {
-				switch (e.type) {
-					case SWT.Deiconify:
-						EventQueue.invokeLater(new Runnable () {
-							public void run () {
-								frame.dispatchEvent (new WindowEvent (frame, WindowEvent.WINDOW_DEICONIFIED));
-							}
-						});
-						break;
-					case SWT.Iconify:
-						EventQueue.invokeLater(new Runnable () {
-							public void run () {
-								frame.dispatchEvent (new WindowEvent (frame, WindowEvent.WINDOW_ICONIFIED));
-							}
-						});
-						break;
-				}
+	};
+	Shell shell = parent.getShell ();
+	shell.addListener (SWT.Deiconify, shellListener);
+	shell.addListener (SWT.Iconify, shellListener);
+	
+	/*
+	 * Generate the appropriate events to activate and deactivate
+	 * the embedded frame. This is needed in order to make keyboard
+	 * focus work properly for lightweights.
+	 */
+	Listener listener = new Listener () {
+		public void handleEvent (Event e) {
+			switch (e.type) {
+				case SWT.Dispose:
+					Shell shell = parent.getShell ();
+					shell.removeListener (SWT.Deiconify, shellListener);
+					shell.removeListener (SWT.Iconify, shellListener);
+					parent.setVisible(false);
+					EventQueue.invokeLater(new Runnable () {
+						public void run () {
+							try {
+								frame.dispose ();
+							} catch (Throwable e) {}
+						}
+					});
+					break;
+				case SWT.FocusIn:
+					EventQueue.invokeLater(new Runnable () {
+						public void run () {
+							if (frame.isActive()) return;
+							try {
+								Class clazz = frame.getClass();
+								Method method = clazz.getMethod("synthesizeWindowActivation", new Class[]{boolean.class});
+								if (method != null) method.invoke(frame, new Object[]{new Boolean(true)});
+							} catch (Throwable e) {e.printStackTrace();}
+						}
+					});
+					break;
+				case SWT.Deactivate:
+					EventQueue.invokeLater(new Runnable () {
+						public void run () {
+							if (!frame.isActive()) return;
+							try {
+								Class clazz = frame.getClass();
+								Method method = clazz.getMethod("synthesizeWindowActivation", new Class[]{boolean.class});
+								if (method != null) method.invoke(frame, new Object[]{new Boolean(false)});
+							} catch (Throwable e) {e.printStackTrace();}
+						}
+					});
+					break;
 			}
-		};
-		Shell shell = parent.getShell ();
-		shell.addListener (SWT.Deiconify, shellListener);
-		shell.addListener (SWT.Iconify, shellListener);
-		
-		/*
-		 * Generate the appropriate events to activate and deactivate
-		 * the embedded frame. This is needed in order to make keyboard
-		 * focus work properly for lightweights.
-		 */
-		Listener listener = new Listener () {
-			public void handleEvent (Event e) {
-				switch (e.type) {
-					case SWT.Dispose:
-						Shell shell = parent.getShell ();
-						shell.removeListener (SWT.Deiconify, shellListener);
-						shell.removeListener (SWT.Iconify, shellListener);
-						parent.setVisible(false);
-						EventQueue.invokeLater(new Runnable () {
-							public void run () {
-								try {
-									frame.dispose ();
-								} catch (Throwable e) {}
-							}
-						});
-						break;
-					case SWT.FocusIn:
-						EventQueue.invokeLater(new Runnable () {
-							public void run () {
-								if (frame.isActive()) return;
-								try {
-									Class clazz = frame.getClass();
-									Method method = clazz.getMethod("synthesizeWindowActivation", new Class[]{boolean.class});
-									if (method != null) method.invoke(frame, new Object[]{new Boolean(true)});
-								} catch (Throwable e) {e.printStackTrace();}
-							}
-						});
-						break;
-					case SWT.Deactivate:
-						EventQueue.invokeLater(new Runnable () {
-							public void run () {
-								if (!frame.isActive()) return;
-								try {
-									Class clazz = frame.getClass();
-									Method method = clazz.getMethod("synthesizeWindowActivation", new Class[]{boolean.class});
-									if (method != null) method.invoke(frame, new Object[]{new Boolean(false)});
-								} catch (Throwable e) {e.printStackTrace();}
-							}
-						});
-						break;
+		}
+	};
+	
+	parent.addListener (SWT.FocusIn, listener);
+	parent.addListener (SWT.Deactivate, listener);
+	parent.addListener (SWT.Dispose, listener);
+	
+	parent.getDisplay().asyncExec(new Runnable() {
+		public void run () {
+			if (parent.isDisposed()) return;
+			final Rectangle clientArea = parent.getClientArea();
+			EventQueue.invokeLater(new Runnable () {
+				public void run () {
+					frame.setSize (clientArea.width, clientArea.height);
+					frame.validate();
+					
+					// Bug in Cocoa AWT? For some reason the frame isn't showing up on first draw.
+					// Toggling visibility seems to be the only thing that works.
+					frame.setVisible(false);
+					frame.setVisible(true);
 				}
-			}
-		};
-		
-		parent.addListener (SWT.FocusIn, listener);
-		parent.addListener (SWT.Deactivate, listener);
-		parent.addListener (SWT.Dispose, listener);
-		
-		parent.getDisplay().asyncExec(new Runnable() {
-			public void run () {
-				if (parent.isDisposed()) return;
-				final Rectangle clientArea = parent.getClientArea();
-				EventQueue.invokeLater(new Runnable () {
-					public void run () {
-						frame.setSize (clientArea.width, clientArea.height);
-						frame.validate();
-						
-						// Bug in Cocoa AWT? For some reason the frame isn't showing up on first draw.
-						// Toggling visibility seems to be the only thing that works.
-						frame.setVisible(false);
-						frame.setVisible(true);
-					}
-				});
-			}
-		});
-		
-		return frame;
+			});
+		}
+	});
+	
+	return frame;
+}
+	
+/**
+ * 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);
+	int /*long*/ handle = 0;
+	
+	try {
+		loadLibrary ();
+		handle = getAWTHandle (parent);
+	} catch (Throwable e) {
+		SWT.error (SWT.ERROR_NOT_IMPLEMENTED, e);
 	}
+	if (handle == 0) SWT.error (SWT.ERROR_INVALID_ARGUMENT, null, " [peer not created]");
 	
-	/**
-	 * 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);
-		int /*long*/ handle = 0;
-		
-		try {
-			loadLibrary ();
-			handle = getAWTHandle (parent);
-		} catch (Throwable e) {
-			SWT.error (SWT.ERROR_NOT_IMPLEMENTED, e);
+	final Shell shell = Shell.cocoa_new (display, handle);
+	final ComponentListener listener = new ComponentAdapter () {
+		public void componentResized (ComponentEvent e) {
+			display.asyncExec (new Runnable () {
+				public void run () {
+					if (shell.isDisposed()) return;
+					Dimension dim = parent.getSize ();
+					shell.setSize (dim.width, dim.height);
+				}
+			});
 		}
-		if (handle == 0) SWT.error (SWT.ERROR_INVALID_ARGUMENT, null, " [peer not created]");
-		
-		final Shell shell = Shell.cocoa_new (display, handle);
-		final ComponentListener listener = new ComponentAdapter () {
-			public void componentResized (ComponentEvent e) {
-				display.asyncExec (new Runnable () {
-					public void run () {
-						if (shell.isDisposed()) return;
-						Dimension dim = parent.getSize ();
-						shell.setSize (dim.width, dim.height);
-					}
-				});
-			}
-		};
-		parent.addComponentListener(listener);
-		shell.addListener(SWT.Dispose, new Listener() {
-			public void handleEvent(Event event) {
-				parent.removeComponentListener(listener);
-			}
-		});
-		shell.setVisible (true);
-		return shell;
-	}
+	};
+	parent.addComponentListener(listener);
+	shell.addListener(SWT.Dispose, new Listener() {
+		public void handleEvent(Event event) {
+			parent.removeComponentListener(listener);
+		}
+	});
+	shell.setVisible (true);
+	return shell;
+}
 }
\ No newline at end of file