After javadoc bash for 3.7RC1
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 08b8e4a..a80ca86 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 @@
} 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;
- }
- }
- };
- 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);
- }
- });
- }
- });
-
- return frame;
+ } catch (ClassNotFoundException cne) {
+ SWT.error (SWT.ERROR_NOT_IMPLEMENTED, cne);
+ } catch (Throwable e) {
+ SWT.error (SWT.ERROR_UNSPECIFIED , e, " [Error while starting AWT]");
}
- /**
- * 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]");
-
- 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;
+ 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;
+ }
+ }
+ };
+
+ 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;
+}
+
+/**
+ * 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]");
+
+ 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;
+}
}
\ No newline at end of file
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Accessibility/carbon/org/eclipse/swt/accessibility/Accessible.java b/bundles/org.eclipse.swt/Eclipse SWT Accessibility/carbon/org/eclipse/swt/accessibility/Accessible.java
index 0f439c7..c89cf20 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Accessibility/carbon/org/eclipse/swt/accessibility/Accessible.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Accessibility/carbon/org/eclipse/swt/accessibility/Accessible.java
@@ -94,6 +94,7 @@
* <li>ERROR_NULL_ARGUMENT - if the parent is null</li>
* </ul>
*
+ * @see #dispose
* @see Control#getAccessible
*
* @since 3.6
@@ -234,10 +235,10 @@
/**
* Adds the listener to the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleAction</code> interface.
+ * defined in the <code>AccessibleActionListener</code> interface.
*
* @param listener the listener that should be notified when the receiver
- * is asked for <code>AccessibleAction</code> interface properties
+ * is asked for <code>AccessibleActionListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -261,10 +262,10 @@
/**
* Adds the listener to the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleEditableText</code> interface.
+ * defined in the <code>AccessibleEditableTextListener</code> interface.
*
* @param listener the listener that should be notified when the receiver
- * is asked for <code>AccessibleEditableText</code> interface properties
+ * is asked for <code>AccessibleEditableTextListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -288,10 +289,10 @@
/**
* Adds the listener to the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleHyperlink</code> interface.
+ * defined in the <code>AccessibleHyperlinkListener</code> interface.
*
* @param listener the listener that should be notified when the receiver
- * is asked for <code>AccessibleHyperlink</code> interface properties
+ * is asked for <code>AccessibleHyperlinkListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -315,10 +316,10 @@
/**
* Adds the listener to the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleTable</code> interface.
+ * defined in the <code>AccessibleTableListener</code> interface.
*
* @param listener the listener that should be notified when the receiver
- * is asked for <code>AccessibleTable</code> interface properties
+ * is asked for <code>AccessibleTableListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -342,10 +343,10 @@
/**
* Adds the listener to the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleTableCell</code> interface.
+ * defined in the <code>AccessibleTableCellListener</code> interface.
*
* @param listener the listener that should be notified when the receiver
- * is asked for <code>AccessibleTableCell</code> interface properties
+ * is asked for <code>AccessibleTableCellListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -369,10 +370,10 @@
/**
* Adds the listener to the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleValue</code> interface.
+ * defined in the <code>AccessibleValueListener</code> interface.
*
* @param listener the listener that should be notified when the receiver
- * is asked for <code>AccessibleValue</code> interface properties
+ * is asked for <code>AccessibleValueListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -396,10 +397,10 @@
/**
* Adds the listener to the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleAttribute</code> interface.
+ * defined in the <code>AccessibleAttributeListener</code> interface.
*
* @param listener the listener that should be notified when the receiver
- * is asked for <code>AccessibleAttribute</code> interface properties
+ * is asked for <code>AccessibleAttributeListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -1407,10 +1408,10 @@
/**
* Removes the listener from the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleAction</code> interface.
+ * defined in the <code>AccessibleActionListener</code> interface.
*
* @param listener the listener that should no longer be notified when the receiver
- * is asked for <code>AccessibleAction</code> interface properties
+ * is asked for <code>AccessibleActionListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -1434,10 +1435,10 @@
/**
* Removes the listener from the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleEditableText</code> interface.
+ * defined in the <code>AccessibleEditableTextListener</code> interface.
*
* @param listener the listener that should no longer be notified when the receiver
- * is asked for <code>AccessibleEditableText</code> interface properties
+ * is asked for <code>AccessibleEditableTextListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -1461,10 +1462,10 @@
/**
* Removes the listener from the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleHyperlink</code> interface.
+ * defined in the <code>AccessibleHyperlinkListener</code> interface.
*
* @param listener the listener that should no longer be notified when the receiver
- * is asked for <code>AccessibleHyperlink</code> interface properties
+ * is asked for <code>AccessibleHyperlinkListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -1488,10 +1489,10 @@
/**
* Removes the listener from the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleTable</code> interface.
+ * defined in the <code>AccessibleTableListener</code> interface.
*
* @param listener the listener that should no longer be notified when the receiver
- * is asked for <code>AccessibleTable</code> interface properties
+ * is asked for <code>AccessibleTableListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -1515,10 +1516,10 @@
/**
* Removes the listener from the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleTableCell</code> interface.
+ * defined in the <code>AccessibleTableCellListener</code> interface.
*
* @param listener the listener that should no longer be notified when the receiver
- * is asked for <code>AccessibleTableCell</code> interface properties
+ * is asked for <code>AccessibleTableCellListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -1542,10 +1543,10 @@
/**
* Removes the listener from the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleValue</code> interface.
+ * defined in the <code>AccessibleValueListener</code> interface.
*
* @param listener the listener that should no longer be notified when the receiver
- * is asked for <code>AccessibleValue</code> interface properties
+ * is asked for <code>AccessibleValueListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -1569,10 +1570,10 @@
/**
* Removes the listener from the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleAttribute</code> interface.
+ * defined in the <code>AccessibleAttributeListener</code> interface.
*
* @param listener the listener that should no longer be notified when the receiver
- * is asked for <code>AccessibleAttribute</code> interface properties
+ * is asked for <code>AccessibleAttributeListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -1613,6 +1614,7 @@
*
* @param event an <code>ACC</code> constant beginning with EVENT_* indicating the message to send
* @param eventData an object containing event-specific data, or null if there is no event-specific data
+ * (eventData is specified in the documentation for individual ACC.EVENT_* constants)
*
* @exception SWTException <ul>
* <li>ERROR_WIDGET_DISPOSED - if the receiver's control has been disposed</li>
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Accessibility/cocoa/org/eclipse/swt/accessibility/Accessible.java b/bundles/org.eclipse.swt/Eclipse SWT Accessibility/cocoa/org/eclipse/swt/accessibility/Accessible.java
index bf6f4e7..1861d8f 100755
--- a/bundles/org.eclipse.swt/Eclipse SWT Accessibility/cocoa/org/eclipse/swt/accessibility/Accessible.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Accessibility/cocoa/org/eclipse/swt/accessibility/Accessible.java
@@ -97,6 +97,7 @@
* <li>ERROR_NULL_ARGUMENT - if the parent is null</li>
* </ul>
*
+ * @see #dispose
* @see Control#getAccessible
*
* @since 3.6
@@ -239,10 +240,10 @@
/**
* Adds the listener to the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleAction</code> interface.
+ * defined in the <code>AccessibleActionListener</code> interface.
*
* @param listener the listener that should be notified when the receiver
- * is asked for <code>AccessibleAction</code> interface properties
+ * is asked for <code>AccessibleActionListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -266,10 +267,10 @@
/**
* Adds the listener to the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleEditableText</code> interface.
+ * defined in the <code>AccessibleEditableTextListener</code> interface.
*
* @param listener the listener that should be notified when the receiver
- * is asked for <code>AccessibleEditableText</code> interface properties
+ * is asked for <code>AccessibleEditableTextListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -293,10 +294,10 @@
/**
* Adds the listener to the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleHyperlink</code> interface.
+ * defined in the <code>AccessibleHyperlinkListener</code> interface.
*
* @param listener the listener that should be notified when the receiver
- * is asked for <code>AccessibleHyperlink</code> interface properties
+ * is asked for <code>AccessibleHyperlinkListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -320,10 +321,10 @@
/**
* Adds the listener to the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleTable</code> interface.
+ * defined in the <code>AccessibleTableListener</code> interface.
*
* @param listener the listener that should be notified when the receiver
- * is asked for <code>AccessibleTable</code> interface properties
+ * is asked for <code>AccessibleTableListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -347,10 +348,10 @@
/**
* Adds the listener to the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleTableCell</code> interface.
+ * defined in the <code>AccessibleTableCellListener</code> interface.
*
* @param listener the listener that should be notified when the receiver
- * is asked for <code>AccessibleTableCell</code> interface properties
+ * is asked for <code>AccessibleTableCellListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -374,10 +375,10 @@
/**
* Adds the listener to the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleValue</code> interface.
+ * defined in the <code>AccessibleValueListener</code> interface.
*
* @param listener the listener that should be notified when the receiver
- * is asked for <code>AccessibleValue</code> interface properties
+ * is asked for <code>AccessibleValueListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -401,10 +402,10 @@
/**
* Adds the listener to the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleAttribute</code> interface.
+ * defined in the <code>AccessibleAttributeListener</code> interface.
*
* @param listener the listener that should be notified when the receiver
- * is asked for <code>AccessibleAttribute</code> interface properties
+ * is asked for <code>AccessibleAttributeListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -2798,10 +2799,10 @@
/**
* Removes the listener from the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleAction</code> interface.
+ * defined in the <code>AccessibleActionListener</code> interface.
*
* @param listener the listener that should no longer be notified when the receiver
- * is asked for <code>AccessibleAction</code> interface properties
+ * is asked for <code>AccessibleActionListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -2825,10 +2826,10 @@
/**
* Removes the listener from the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleEditableText</code> interface.
+ * defined in the <code>AccessibleEditableTextListener</code> interface.
*
* @param listener the listener that should no longer be notified when the receiver
- * is asked for <code>AccessibleEditableText</code> interface properties
+ * is asked for <code>AccessibleEditableTextListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -2852,10 +2853,10 @@
/**
* Removes the listener from the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleHyperlink</code> interface.
+ * defined in the <code>AccessibleHyperlinkListener</code> interface.
*
* @param listener the listener that should no longer be notified when the receiver
- * is asked for <code>AccessibleHyperlink</code> interface properties
+ * is asked for <code>AccessibleHyperlinkListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -2879,10 +2880,10 @@
/**
* Removes the listener from the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleTable</code> interface.
+ * defined in the <code>AccessibleTableListener</code> interface.
*
* @param listener the listener that should no longer be notified when the receiver
- * is asked for <code>AccessibleTable</code> interface properties
+ * is asked for <code>AccessibleTableListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -2906,10 +2907,10 @@
/**
* Removes the listener from the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleTableCell</code> interface.
+ * defined in the <code>AccessibleTableCellListener</code> interface.
*
* @param listener the listener that should no longer be notified when the receiver
- * is asked for <code>AccessibleTableCell</code> interface properties
+ * is asked for <code>AccessibleTableCellListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -2933,10 +2934,10 @@
/**
* Removes the listener from the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleValue</code> interface.
+ * defined in the <code>AccessibleValueListener</code> interface.
*
* @param listener the listener that should no longer be notified when the receiver
- * is asked for <code>AccessibleValue</code> interface properties
+ * is asked for <code>AccessibleValueListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -2960,10 +2961,10 @@
/**
* Removes the listener from the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleAttribute</code> interface.
+ * defined in the <code>AccessibleAttributeListener</code> interface.
*
* @param listener the listener that should no longer be notified when the receiver
- * is asked for <code>AccessibleAttribute</code> interface properties
+ * is asked for <code>AccessibleAttributeListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -3041,6 +3042,7 @@
*
* @param event an <code>ACC</code> constant beginning with EVENT_* indicating the message to send
* @param eventData an object containing event-specific data, or null if there is no event-specific data
+ * (eventData is specified in the documentation for individual ACC.EVENT_* constants)
*
* @exception SWTException <ul>
* <li>ERROR_WIDGET_DISPOSED - if the receiver's control has been disposed</li>
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Accessibility/emulated/org/eclipse/swt/accessibility/Accessible.java b/bundles/org.eclipse.swt/Eclipse SWT Accessibility/emulated/org/eclipse/swt/accessibility/Accessible.java
index df3ede1..1c53ae2 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Accessibility/emulated/org/eclipse/swt/accessibility/Accessible.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Accessibility/emulated/org/eclipse/swt/accessibility/Accessible.java
@@ -49,6 +49,7 @@
* <li>ERROR_NULL_ARGUMENT - if the parent is null</li>
* </ul>
*
+ * @see #dispose
* @see Control#getAccessible
*
* @since 3.6
@@ -233,10 +234,10 @@
/**
* Adds the listener to the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleAction</code> interface.
+ * defined in the <code>AccessibleActionListener</code> interface.
*
* @param listener the listener that should be notified when the receiver
- * is asked for <code>AccessibleAction</code> interface properties
+ * is asked for <code>AccessibleActionListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -257,10 +258,10 @@
/**
* Adds the listener to the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleEditableText</code> interface.
+ * defined in the <code>AccessibleEditableTextListener</code> interface.
*
* @param listener the listener that should be notified when the receiver
- * is asked for <code>AccessibleEditableText</code> interface properties
+ * is asked for <code>AccessibleEditableTextListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -281,10 +282,10 @@
/**
* Adds the listener to the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleHyperlink</code> interface.
+ * defined in the <code>AccessibleHyperlinkListener</code> interface.
*
* @param listener the listener that should be notified when the receiver
- * is asked for <code>AccessibleHyperlink</code> interface properties
+ * is asked for <code>AccessibleHyperlinkListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -305,10 +306,10 @@
/**
* Adds the listener to the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleTable</code> interface.
+ * defined in the <code>AccessibleTableListener</code> interface.
*
* @param listener the listener that should be notified when the receiver
- * is asked for <code>AccessibleTable</code> interface properties
+ * is asked for <code>AccessibleTableListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -329,10 +330,10 @@
/**
* Adds the listener to the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleTableCell</code> interface.
+ * defined in the <code>AccessibleTableCellListener</code> interface.
*
* @param listener the listener that should be notified when the receiver
- * is asked for <code>AccessibleTableCell</code> interface properties
+ * is asked for <code>AccessibleTableCellListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -353,10 +354,10 @@
/**
* Adds the listener to the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleValue</code> interface.
+ * defined in the <code>AccessibleValueListener</code> interface.
*
* @param listener the listener that should be notified when the receiver
- * is asked for <code>AccessibleValue</code> interface properties
+ * is asked for <code>AccessibleValueListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -377,10 +378,10 @@
/**
* Adds the listener to the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleAttribute</code> interface.
+ * defined in the <code>AccessibleAttributeListener</code> interface.
*
* @param listener the listener that should be notified when the receiver
- * is asked for <code>AccessibleAttribute</code> interface properties
+ * is asked for <code>AccessibleAttributeListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -442,10 +443,10 @@
/**
* Removes the listener from the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleAction</code> interface.
+ * defined in the <code>AccessibleActionListener</code> interface.
*
* @param listener the listener that should no longer be notified when the receiver
- * is asked for <code>AccessibleAction</code> interface properties
+ * is asked for <code>AccessibleActionListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -466,10 +467,10 @@
/**
* Removes the listener from the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleEditableText</code> interface.
+ * defined in the <code>AccessibleEditableTextListener</code> interface.
*
* @param listener the listener that should no longer be notified when the receiver
- * is asked for <code>AccessibleEditableText</code> interface properties
+ * is asked for <code>AccessibleEditableTextListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -490,10 +491,10 @@
/**
* Removes the listener from the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleHyperlink</code> interface.
+ * defined in the <code>AccessibleHyperlinkListener</code> interface.
*
* @param listener the listener that should no longer be notified when the receiver
- * is asked for <code>AccessibleHyperlink</code> interface properties
+ * is asked for <code>AccessibleHyperlinkListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -514,10 +515,10 @@
/**
* Removes the listener from the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleTable</code> interface.
+ * defined in the <code>AccessibleTableListener</code> interface.
*
* @param listener the listener that should no longer be notified when the receiver
- * is asked for <code>AccessibleTable</code> interface properties
+ * is asked for <code>AccessibleTableListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -538,10 +539,10 @@
/**
* Removes the listener from the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleTableCell</code> interface.
+ * defined in the <code>AccessibleTableCellListener</code> interface.
*
* @param listener the listener that should no longer be notified when the receiver
- * is asked for <code>AccessibleTableCell</code> interface properties
+ * is asked for <code>AccessibleTableCellListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -562,10 +563,10 @@
/**
* Removes the listener from the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleValue</code> interface.
+ * defined in the <code>AccessibleValueListener</code> interface.
*
* @param listener the listener that should no longer be notified when the receiver
- * is asked for <code>AccessibleValue</code> interface properties
+ * is asked for <code>AccessibleValueListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -586,10 +587,10 @@
/**
* Removes the listener from the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleAttribute</code> interface.
+ * defined in the <code>AccessibleAttributeListener</code> interface.
*
* @param listener the listener that should no longer be notified when the receiver
- * is asked for <code>AccessibleAttribute</code> interface properties
+ * is asked for <code>AccessibleAttributeListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -625,6 +626,7 @@
*
* @param event an <code>ACC</code> constant beginning with EVENT_* indicating the message to send
* @param eventData an object containing event-specific data, or null if there is no event-specific data
+ * (eventData is specified in the documentation for individual ACC.EVENT_* constants)
*
* @exception SWTException <ul>
* <li>ERROR_WIDGET_DISPOSED - if the receiver's control has been disposed</li>
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Accessibility/gtk/org/eclipse/swt/accessibility/Accessible.java b/bundles/org.eclipse.swt/Eclipse SWT Accessibility/gtk/org/eclipse/swt/accessibility/Accessible.java
index 8c2723e..0e90d22 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Accessibility/gtk/org/eclipse/swt/accessibility/Accessible.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Accessibility/gtk/org/eclipse/swt/accessibility/Accessible.java
@@ -84,6 +84,7 @@
* <li>ERROR_NULL_ARGUMENT - if the parent is null</li>
* </ul>
*
+ * @see #dispose
* @see Control#getAccessible
*
* @since 3.6
@@ -210,10 +211,10 @@
/**
* Adds the listener to the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleAction</code> interface.
+ * defined in the <code>AccessibleActionListener</code> interface.
*
* @param listener the listener that should be notified when the receiver
- * is asked for <code>AccessibleAction</code> interface properties
+ * is asked for <code>AccessibleActionListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -237,10 +238,10 @@
/**
* Adds the listener to the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleEditableText</code> interface.
+ * defined in the <code>AccessibleEditableTextListener</code> interface.
*
* @param listener the listener that should be notified when the receiver
- * is asked for <code>AccessibleEditableText</code> interface properties
+ * is asked for <code>AccessibleEditableTextListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -264,10 +265,10 @@
/**
* Adds the listener to the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleHyperlink</code> interface.
+ * defined in the <code>AccessibleHyperlinkListener</code> interface.
*
* @param listener the listener that should be notified when the receiver
- * is asked for <code>AccessibleHyperlink</code> interface properties
+ * is asked for <code>AccessibleHyperlinkListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -291,10 +292,10 @@
/**
* Adds the listener to the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleTable</code> interface.
+ * defined in the <code>AccessibleTableListener</code> interface.
*
* @param listener the listener that should be notified when the receiver
- * is asked for <code>AccessibleTable</code> interface properties
+ * is asked for <code>AccessibleTableListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -318,10 +319,10 @@
/**
* Adds the listener to the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleTableCell</code> interface.
+ * defined in the <code>AccessibleTableCellListener</code> interface.
*
* @param listener the listener that should be notified when the receiver
- * is asked for <code>AccessibleTableCell</code> interface properties
+ * is asked for <code>AccessibleTableCellListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -345,10 +346,10 @@
/**
* Adds the listener to the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleValue</code> interface.
+ * defined in the <code>AccessibleValueListener</code> interface.
*
* @param listener the listener that should be notified when the receiver
- * is asked for <code>AccessibleValue</code> interface properties
+ * is asked for <code>AccessibleValueListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -372,10 +373,10 @@
/**
* Adds the listener to the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleAttribute</code> interface.
+ * defined in the <code>AccessibleAttributeListener</code> interface.
*
* @param listener the listener that should be notified when the receiver
- * is asked for <code>AccessibleAttribute</code> interface properties
+ * is asked for <code>AccessibleAttributeListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -615,10 +616,10 @@
/**
* Removes the listener from the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleAction</code> interface.
+ * defined in the <code>AccessibleActionListener</code> interface.
*
* @param listener the listener that should no longer be notified when the receiver
- * is asked for <code>AccessibleAction</code> interface properties
+ * is asked for <code>AccessibleActionListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -642,10 +643,10 @@
/**
* Removes the listener from the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleEditableText</code> interface.
+ * defined in the <code>AccessibleEditableTextListener</code> interface.
*
* @param listener the listener that should no longer be notified when the receiver
- * is asked for <code>AccessibleEditableText</code> interface properties
+ * is asked for <code>AccessibleEditableTextListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -669,10 +670,10 @@
/**
* Removes the listener from the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleHyperlink</code> interface.
+ * defined in the <code>AccessibleHyperlinkListener</code> interface.
*
* @param listener the listener that should no longer be notified when the receiver
- * is asked for <code>AccessibleHyperlink</code> interface properties
+ * is asked for <code>AccessibleHyperlinkListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -696,10 +697,10 @@
/**
* Removes the listener from the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleTable</code> interface.
+ * defined in the <code>AccessibleTableListener</code> interface.
*
* @param listener the listener that should no longer be notified when the receiver
- * is asked for <code>AccessibleTable</code> interface properties
+ * is asked for <code>AccessibleTableListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -723,10 +724,10 @@
/**
* Removes the listener from the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleTableCell</code> interface.
+ * defined in the <code>AccessibleTableCellListener</code> interface.
*
* @param listener the listener that should no longer be notified when the receiver
- * is asked for <code>AccessibleTableCell</code> interface properties
+ * is asked for <code>AccessibleTableCellListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -750,10 +751,10 @@
/**
* Removes the listener from the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleValue</code> interface.
+ * defined in the <code>AccessibleValueListener</code> interface.
*
* @param listener the listener that should no longer be notified when the receiver
- * is asked for <code>AccessibleValue</code> interface properties
+ * is asked for <code>AccessibleValueListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -777,10 +778,10 @@
/**
* Removes the listener from the collection of listeners that will be
* notified when an accessible client asks for any of the properties
- * defined in the <code>AccessibleAttribute</code> interface.
+ * defined in the <code>AccessibleAttributeListener</code> interface.
*
* @param listener the listener that should no longer be notified when the receiver
- * is asked for <code>AccessibleAttribute</code> interface properties
+ * is asked for <code>AccessibleAttributeListener</code> interface properties
*
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
@@ -826,6 +827,7 @@
*
* @param event an <code>ACC</code> constant beginning with EVENT_* indicating the message to send
* @param eventData an object containing event-specific data, or null if there is no event-specific data
+ * (eventData is specified in the documentation for individual ACC.EVENT_* constants)
*
* @exception SWTException <ul>
* <li>ERROR_WIDGET_DISPOSED - if the receiver's control has been disposed</li>
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/emulated/org/eclipse/swt/dnd/Clipboard.java b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/emulated/org/eclipse/swt/dnd/Clipboard.java
index 981acde..a60d32f 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/emulated/org/eclipse/swt/dnd/Clipboard.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Drag and Drop/emulated/org/eclipse/swt/dnd/Clipboard.java
@@ -123,6 +123,54 @@
}
/**
+ * If this clipboard is currently the owner of the data on the system clipboard,
+ * clear the contents. If this clipboard is not the owner, then nothing is done.
+ * Note that there are clipboard assistant applications that take ownership of
+ * data or make copies of data when it is placed on the clipboard. In these
+ * cases, it may not be possible to clear the clipboard.
+ *
+ * @exception SWTException <ul>
+ * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
+ * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
+ * </ul>
+ *
+ * @since 3.1
+ */
+public void clearContents() {
+ clearContents(DND.CLIPBOARD);
+}
+
+/**
+ * If this clipboard is currently the owner of the data on the specified
+ * clipboard, clear the contents. If this clipboard is not the owner, then
+ * nothing is done.
+ *
+ * <p>Note that there are clipboard assistant applications that take ownership
+ * of data or make copies of data when it is placed on the clipboard. In these
+ * cases, it may not be possible to clear the clipboard.</p>
+ *
+ * <p>The clipboards value is either one of the clipboard constants defined in
+ * class <code>DND</code>, or must be built by <em>bitwise OR</em>'ing together
+ * (that is, using the <code>int</code> "|" operator) two or more
+ * of those <code>DND</code> clipboard constants.</p>
+ *
+ * @param clipboards to be cleared
+ *
+ * @exception SWTException <ul>
+ * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
+ * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
+ * </ul>
+ *
+ * @see DND#CLIPBOARD
+ * @see DND#SELECTION_CLIPBOARD
+ *
+ * @since 3.1
+ */
+public void clearContents(int clipboards) {
+ checkWidget();
+}
+
+/**
* Disposes of the operating system resources associated with the clipboard.
* The data will still be available on the system clipboard after the dispose
* method is called.
@@ -388,6 +436,34 @@
}
/**
+ * Returns an array of the data types currently available on the specified
+ * clipboard. Use with Transfer.isSupportedType.
+ *
+ * <p>The clipboards value is either one of the clipboard constants defined in
+ * class <code>DND</code>, or must be built by <em>bitwise OR</em>'ing together
+ * (that is, using the <code>int</code> "|" operator) two or more
+ * of those <code>DND</code> clipboard constants.</p>
+ *
+ * @param clipboards from which to get the data types
+ * @return array of data types currently available on the specified clipboard
+ *
+ * @exception SWTException <ul>
+ * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
+ * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
+ * </ul>
+ *
+ * @see Transfer#isSupportedType
+ * @see DND#CLIPBOARD
+ * @see DND#SELECTION_CLIPBOARD
+ *
+ * @since 3.1
+ */
+public TransferData[] getAvailableTypes(int clipboards) {
+ checkWidget();
+ return new TransferData[0];
+}
+
+/**
* Returns a platform specific list of the data types currently available on the
* system clipboard.
*
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Printing/carbon/org/eclipse/swt/printing/Printer.java b/bundles/org.eclipse.swt/Eclipse SWT Printing/carbon/org/eclipse/swt/printing/Printer.java
index 7b12bbd..9b0308b 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Printing/carbon/org/eclipse/swt/printing/Printer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Printing/carbon/org/eclipse/swt/printing/Printer.java
@@ -162,7 +162,7 @@
* </p>
*
* @exception SWTError <ul>
- * <li>ERROR_NO_HANDLES - if there are no valid printers
+ * <li>ERROR_NO_HANDLES - if there is no valid default printer
* </ul>
*
* @see Device#dispose
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Printing/cocoa/org/eclipse/swt/printing/Printer.java b/bundles/org.eclipse.swt/Eclipse SWT Printing/cocoa/org/eclipse/swt/printing/Printer.java
index c5a4310..8d345df 100755
--- a/bundles/org.eclipse.swt/Eclipse SWT Printing/cocoa/org/eclipse/swt/printing/Printer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Printing/cocoa/org/eclipse/swt/printing/Printer.java
@@ -101,7 +101,7 @@
* </p>
*
* @exception SWTError <ul>
- * <li>ERROR_NO_HANDLES - if there are no valid printers
+ * <li>ERROR_NO_HANDLES - if there is no valid default printer
* </ul>
*
* @see Device#dispose
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Printing/emulated/org/eclipse/swt/printing/Printer.java b/bundles/org.eclipse.swt/Eclipse SWT Printing/emulated/org/eclipse/swt/printing/Printer.java
index 00c30a8..a81e7eb 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Printing/emulated/org/eclipse/swt/printing/Printer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Printing/emulated/org/eclipse/swt/printing/Printer.java
@@ -82,7 +82,7 @@
* </p>
*
* @exception SWTError <ul>
- * <li>ERROR_NO_HANDLES - if there are no valid printers
+ * <li>ERROR_NO_HANDLES - if there is no valid default printer
* </ul>
*
* @see Device#dispose
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Printing/gtk/org/eclipse/swt/printing/Printer.java b/bundles/org.eclipse.swt/Eclipse SWT Printing/gtk/org/eclipse/swt/printing/Printer.java
index 2e31cb3..c163bb2 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Printing/gtk/org/eclipse/swt/printing/Printer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Printing/gtk/org/eclipse/swt/printing/Printer.java
@@ -278,7 +278,7 @@
* </p>
*
* @exception SWTError <ul>
- * <li>ERROR_NO_HANDLES - if there are no valid printers
+ * <li>ERROR_NO_HANDLES - if there is no valid default printer
* </ul>
*
* @see Device#dispose
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Printing/motif/org/eclipse/swt/printing/Printer.java b/bundles/org.eclipse.swt/Eclipse SWT Printing/motif/org/eclipse/swt/printing/Printer.java
index 83ac822..5fcba9a 100755
--- a/bundles/org.eclipse.swt/Eclipse SWT Printing/motif/org/eclipse/swt/printing/Printer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Printing/motif/org/eclipse/swt/printing/Printer.java
@@ -243,7 +243,7 @@
* </p>
*
* @exception SWTError <ul>
- * <li>ERROR_NO_HANDLES - if there are no valid printers
+ * <li>ERROR_NO_HANDLES - if there is no valid default printer
* </ul>
*
* @see Device#dispose
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Printing/photon/org/eclipse/swt/printing/Printer.java b/bundles/org.eclipse.swt/Eclipse SWT Printing/photon/org/eclipse/swt/printing/Printer.java
index c3cf7f5..7691964 100755
--- a/bundles/org.eclipse.swt/Eclipse SWT Printing/photon/org/eclipse/swt/printing/Printer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Printing/photon/org/eclipse/swt/printing/Printer.java
@@ -71,7 +71,7 @@
* </p>
*
* @exception SWTError <ul>
- * <li>ERROR_NO_HANDLES - if there are no valid printers
+ * <li>ERROR_NO_HANDLES - if there is no valid default printer
* </ul>
*
* @see Device#dispose
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Printing/wpf/org/eclipse/swt/printing/Printer.java b/bundles/org.eclipse.swt/Eclipse SWT Printing/wpf/org/eclipse/swt/printing/Printer.java
index c3cf7f5..7691964 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Printing/wpf/org/eclipse/swt/printing/Printer.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Printing/wpf/org/eclipse/swt/printing/Printer.java
@@ -71,7 +71,7 @@
* </p>
*
* @exception SWTError <ul>
- * <li>ERROR_NO_HANDLES - if there are no valid printers
+ * <li>ERROR_NO_HANDLES - if there is no valid default printer
* </ul>
*
* @see Device#dispose
diff --git a/bundles/org.eclipse.swt/Eclipse SWT/carbon/org/eclipse/swt/widgets/Control.java b/bundles/org.eclipse.swt/Eclipse SWT/carbon/org/eclipse/swt/widgets/Control.java
index 07a49df..64190fb 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT/carbon/org/eclipse/swt/widgets/Control.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT/carbon/org/eclipse/swt/widgets/Control.java
@@ -215,7 +215,7 @@
/**
* Adds the listener to the collection of listeners who will
* be notified when gesture events are generated for the control,
- * by sending it one of the messages defined in the
+ * by sending it one of the messages defined in the
* <code>GestureListener</code> interface.
*
* @param listener the listener which should be notified
@@ -481,6 +481,8 @@
* windowing toolkit that you want touch events to be generated.
* </p>
*
+ * @param listener the listener which should be notified
+ *
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
* </ul>
@@ -491,6 +493,7 @@
*
* @see TouchListener
* @see #removeTouchListener
+ *
* @since 3.7
*/
public void addTouchListener (TouchListener listener) {
@@ -1080,8 +1083,11 @@
/**
* Returns the accessible object for the receiver.
+ * <p>
* If this is the first time this object is requested,
- * then the object is created and returned.
+ * then the object is created and returned. The object
+ * returned by getAccessible() does not need to be disposed.
+ * </p>
*
* @return the accessible object
*
@@ -1384,6 +1390,19 @@
return monitors [index];
}
+/**
+ * Returns the orientation of the receiver, which will be one of the
+ * constants <code>SWT.LEFT_TO_RIGHT</code> or <code>SWT.RIGHT_TO_LEFT</code>.
+ *
+ * @return the orientation style
+ *
+ * @exception SWTException <ul>
+ * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
+ * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
+ * </ul>
+ *
+ * @since 3.7
+ */
public int getOrientation () {
checkWidget ();
return style & (SWT.LEFT_TO_RIGHT | SWT.RIGHT_TO_LEFT);
@@ -2763,7 +2782,7 @@
/**
* Removes the listener from the collection of listeners who will
- * be notified when a gesture is performed on the control
+ * be notified when gesture events are generated for the control.
*
* @param listener the listener which should no longer be notified
*
@@ -2777,6 +2796,7 @@
*
* @see GestureListener
* @see #addGestureListener
+ *
* @since 3.7
*/
public void removeGestureListener (GestureListener listener) {
@@ -3017,6 +3037,7 @@
*
* @see TouchListener
* @see #addTouchListener
+ *
* @since 3.7
*/
public void removeTouchListener(TouchListener listener) {
@@ -3788,6 +3809,20 @@
this.menu = menu;
}
+/**
+ * Sets the orientation of the receiver, which must be one
+ * of the constants <code>SWT.LEFT_TO_RIGHT</code> or <code>SWT.RIGHT_TO_LEFT</code>.
+ * <p>
+ *
+ * @param orientation new orientation style
+ *
+ * @exception SWTException <ul>
+ * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
+ * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
+ * </ul>
+ *
+ * @since 3.7
+ */
public void setOrientation (int orientation) {
checkWidget ();
}
@@ -4003,18 +4038,15 @@
}
/**
- * Sets the receiver to receive touch events from the OS. By default, touch
- * events are not delivered to a control unless specifically requested for that control.
- * This is independent of whether or not there are any <code>TouchListener</code> instances
- * registered for the control.
- *
- * @param enabled the new touch-enabled state.
- *
+ * Sets whether the receiver should accept touch events. By default, a Control does not accept touch
+ * events. No error or exception is thrown if the underlying hardware does not support touch input.
+ *
+ * @param enabled the new touch-enabled state
+ *
* @exception SWTException <ul>
* <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
* <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
- * </ul>
- *
+ *
* @since 3.7
*/
public void setTouchEnabled(boolean enabled) {
diff --git a/bundles/org.eclipse.swt/Eclipse SWT/carbon/org/eclipse/swt/widgets/Display.java b/bundles/org.eclipse.swt/Eclipse SWT/carbon/org/eclipse/swt/widgets/Display.java
index f50d98d..1a599c1 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT/carbon/org/eclipse/swt/widgets/Display.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT/carbon/org/eclipse/swt/widgets/Display.java
@@ -1469,7 +1469,7 @@
* over top of, or null if it is not currently over one of the
* controls built by the currently running application.
*
- * @return the control under the cursor
+ * @return the control under the cursor or <code>null</code>
*
* @exception SWTException <ul>
* <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
@@ -1679,7 +1679,7 @@
* any of the controls built by the currently running
* application.
*
- * @return the control under the cursor
+ * @return the focus control or <code>null</code>
*
* @exception SWTException <ul>
* <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
@@ -2197,6 +2197,11 @@
/**
* Returns true if a touch-aware input device is attached to the system,
* enabled, and ready for use.
+ *
+ * @exception SWTException <ul>
+ * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
+ * <li>ERROR_DEVICE_DISPOSED - if the receiver has been disposed</li>
+ * </ul>
*
* @since 3.7
*/
diff --git a/bundles/org.eclipse.swt/Eclipse SWT/carbon/org/eclipse/swt/widgets/Menu.java b/bundles/org.eclipse.swt/Eclipse SWT/carbon/org/eclipse/swt/widgets/Menu.java
index 2e69fb8..9e54430 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT/carbon/org/eclipse/swt/widgets/Menu.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT/carbon/org/eclipse/swt/widgets/Menu.java
@@ -509,6 +509,19 @@
return result;
}
+/**
+ * Returns the orientation of the receiver, which will be one of the
+ * constants <code>SWT.LEFT_TO_RIGHT</code> or <code>SWT.RIGHT_TO_LEFT</code>.
+ *
+ * @return the orientation style
+ *
+ * @exception SWTException <ul>
+ * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
+ * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
+ * </ul>
+ *
+ * @since 3.7
+ */
public int getOrientation () {
checkWidget ();
return style & (SWT.LEFT_TO_RIGHT | SWT.RIGHT_TO_LEFT);
@@ -1167,6 +1180,20 @@
setLocation (location.x, location.y);
}
+/**
+ * Sets the orientation of the receiver, which must be one
+ * of the constants <code>SWT.LEFT_TO_RIGHT</code> or <code>SWT.RIGHT_TO_LEFT</code>.
+ * <p>
+ *
+ * @param orientation new orientation style
+ *
+ * @exception SWTException <ul>
+ * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
+ * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
+ * </ul>
+ *
+ * @since 3.7
+ */
public void setOrientation (int orientation) {
checkWidget ();
}
diff --git a/bundles/org.eclipse.swt/Eclipse SWT/carbon/org/eclipse/swt/widgets/Text.java b/bundles/org.eclipse.swt/Eclipse SWT/carbon/org/eclipse/swt/widgets/Text.java
index 76370d0..f1b203f 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT/carbon/org/eclipse/swt/widgets/Text.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT/carbon/org/eclipse/swt/widgets/Text.java
@@ -1220,6 +1220,7 @@
* <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
* <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
* </ul>
+ * @see #setTextChars(char[])
* @since 3.7
*/
public char [] getTextChars () {
@@ -2359,6 +2360,7 @@
* <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
* <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
* </ul>
+ * @see #getTextChars()
* @since 3.7
*/
public void setTextChars (char [] text) {
diff --git a/bundles/org.eclipse.swt/Eclipse SWT/carbon/org/eclipse/swt/widgets/ToolItem.java b/bundles/org.eclipse.swt/Eclipse SWT/carbon/org/eclipse/swt/widgets/ToolItem.java
index c2bd67b..ffaa881 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT/carbon/org/eclipse/swt/widgets/ToolItem.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT/carbon/org/eclipse/swt/widgets/ToolItem.java
@@ -1324,7 +1324,14 @@
/**
* Sets the width of the receiver, for <code>SEPARATOR</code> ToolItems.
*
- * @param width the new width
+ * @param width the new width. If the new value is <code>SWT.DEFAULT</code>,
+ * the width is a fixed-width area whose amount is determined by the platform.
+ * If the new value is 0 a vertical or horizontal line will be drawn, depending
+ * on the setting of the corresponding style bit (<code>SWT.VERTICAL</code> or
+ * <code>SWT.HORIZONTAL</code>). If the new value is <code>SWT.SEPARATOR_FILL</code>
+ * a variable-width space is inserted that acts as a spring between the two adjoining
+ * items which will push them out to the extent of the containing ToolBar.
+ *
*
* @exception SWTException <ul>
* <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
diff --git a/bundles/org.eclipse.swt/Eclipse SWT/cocoa/org/eclipse/swt/widgets/Control.java b/bundles/org.eclipse.swt/Eclipse SWT/cocoa/org/eclipse/swt/widgets/Control.java
index 0497016..f061760 100755
--- a/bundles/org.eclipse.swt/Eclipse SWT/cocoa/org/eclipse/swt/widgets/Control.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT/cocoa/org/eclipse/swt/widgets/Control.java
@@ -388,7 +388,7 @@
/**
* Adds the listener to the collection of listeners who will
* be notified when gesture events are generated for the control,
- * by sending it one of the messages defined in the
+ * by sending it one of the messages defined in the
* <code>GestureListener</code> interface.
*
* @param listener the listener which should be notified
@@ -666,6 +666,8 @@
* windowing toolkit that you want touch events to be generated.
* </p>
*
+ * @param listener the listener which should be notified
+ *
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
* </ul>
@@ -676,6 +678,7 @@
*
* @see TouchListener
* @see #removeTouchListener
+ *
* @since 3.7
*/
public void addTouchListener (TouchListener listener) {
@@ -1485,8 +1488,11 @@
/**
* Returns the accessible object for the receiver.
+ * <p>
* If this is the first time this object is requested,
- * then the object is created and returned.
+ * then the object is created and returned. The object
+ * returned by getAccessible() does not need to be disposed.
+ * </p>
*
* @return the accessible object
*
@@ -1784,6 +1790,16 @@
}
/**
+ * Returns the orientation of the receiver, which will be one of the
+ * constants <code>SWT.LEFT_TO_RIGHT</code> or <code>SWT.RIGHT_TO_LEFT</code>.
+ *
+ * @return the orientation style
+ *
+ * @exception SWTException <ul>
+ * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
+ * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
+ * </ul>
+ *
* @since 3.7
*/
public int getOrientation () {
@@ -2905,7 +2921,7 @@
/**
* Removes the listener from the collection of listeners who will
- * be notified when a gesture is performed on the control
+ * be notified when gesture events are generated for the control.
*
* @param listener the listener which should no longer be notified
*
@@ -2919,6 +2935,7 @@
*
* @see GestureListener
* @see #addGestureListener
+ *
* @since 3.7
*/
public void removeGestureListener (GestureListener listener) {
@@ -3162,6 +3179,7 @@
*
* @see TouchListener
* @see #addTouchListener
+ *
* @since 3.7
*/
public void removeTouchListener(TouchListener listener) {
@@ -3849,7 +3867,17 @@
}
/**
- * @param orientation
+ * Sets the orientation of the receiver, which must be one
+ * of the constants <code>SWT.LEFT_TO_RIGHT</code> or <code>SWT.RIGHT_TO_LEFT</code>.
+ * <p>
+ *
+ * @param orientation new orientation style
+ *
+ * @exception SWTException <ul>
+ * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
+ * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
+ * </ul>
+ *
* @since 3.7
*/
public void setOrientation (int orientation) {
@@ -4064,18 +4092,15 @@
}
/**
- * Sets the receiver to receive touch events from the OS. By default, touch
- * events are not delivered to a control unless specifically requested for that control.
- * This is independent of whether or not there are any <code>TouchListener</code> instances
- * registered for the control.
- *
- * @param enabled the new touch-enabled state.
- *
+ * Sets whether the receiver should accept touch events. By default, a Control does not accept touch
+ * events. No error or exception is thrown if the underlying hardware does not support touch input.
+ *
+ * @param enabled the new touch-enabled state
+ *
* @exception SWTException <ul>
* <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
* <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
- * </ul>
- *
+ *
* @since 3.7
*/
public void setTouchEnabled(boolean enabled) {
diff --git a/bundles/org.eclipse.swt/Eclipse SWT/cocoa/org/eclipse/swt/widgets/Display.java b/bundles/org.eclipse.swt/Eclipse SWT/cocoa/org/eclipse/swt/widgets/Display.java
index 346760c..398a34f 100755
--- a/bundles/org.eclipse.swt/Eclipse SWT/cocoa/org/eclipse/swt/widgets/Display.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT/cocoa/org/eclipse/swt/widgets/Display.java
@@ -1324,7 +1324,7 @@
* over top of, or null if it is not currently over one of the
* controls built by the currently running application.
*
- * @return the control under the cursor
+ * @return the control under the cursor or <code>null</code>
*
* @exception SWTException <ul>
* <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
@@ -1493,7 +1493,7 @@
* any of the controls built by the currently running
* application.
*
- * @return the control under the cursor
+ * @return the focus control or <code>null</code>
*
* @exception SWTException <ul>
* <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
@@ -2059,6 +2059,11 @@
/**
* Returns true if a touch-aware input device is attached to the system,
* enabled, and ready for use.
+ *
+ * @exception SWTException <ul>
+ * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
+ * <li>ERROR_DEVICE_DISPOSED - if the receiver has been disposed</li>
+ * </ul>
*
* @since 3.7
*/
diff --git a/bundles/org.eclipse.swt/Eclipse SWT/cocoa/org/eclipse/swt/widgets/Menu.java b/bundles/org.eclipse.swt/Eclipse SWT/cocoa/org/eclipse/swt/widgets/Menu.java
index 828b65b..60ecde2 100755
--- a/bundles/org.eclipse.swt/Eclipse SWT/cocoa/org/eclipse/swt/widgets/Menu.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT/cocoa/org/eclipse/swt/widgets/Menu.java
@@ -593,6 +593,19 @@
return result;
}
+/**
+ * Returns the orientation of the receiver, which will be one of the
+ * constants <code>SWT.LEFT_TO_RIGHT</code> or <code>SWT.RIGHT_TO_LEFT</code>.
+ *
+ * @return the orientation style
+ *
+ * @exception SWTException <ul>
+ * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
+ * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
+ * </ul>
+ *
+ * @since 3.7
+ */
public int getOrientation () {
checkWidget ();
return style & (SWT.LEFT_TO_RIGHT | SWT.RIGHT_TO_LEFT);
@@ -1076,6 +1089,20 @@
setLocation (location.x, location.y);
}
+/**
+ * Sets the orientation of the receiver, which must be one
+ * of the constants <code>SWT.LEFT_TO_RIGHT</code> or <code>SWT.RIGHT_TO_LEFT</code>.
+ * <p>
+ *
+ * @param orientation new orientation style
+ *
+ * @exception SWTException <ul>
+ * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
+ * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
+ * </ul>
+ *
+ * @since 3.7
+ */
public void setOrientation (int orientation) {
checkWidget ();
}
diff --git a/bundles/org.eclipse.swt/Eclipse SWT/gtk/org/eclipse/swt/widgets/Control.java b/bundles/org.eclipse.swt/Eclipse SWT/gtk/org/eclipse/swt/widgets/Control.java
index 9579f7a..f3a5e06 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT/gtk/org/eclipse/swt/widgets/Control.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT/gtk/org/eclipse/swt/widgets/Control.java
@@ -202,6 +202,19 @@
return handle;
}
+/**
+ * Returns the orientation of the receiver, which will be one of the
+ * constants <code>SWT.LEFT_TO_RIGHT</code> or <code>SWT.RIGHT_TO_LEFT</code>.
+ *
+ * @return the orientation style
+ *
+ * @exception SWTException <ul>
+ * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
+ * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
+ * </ul>
+ *
+ * @since 3.7
+ */
public int getOrientation () {
checkWidget();
return style & (SWT.LEFT_TO_RIGHT | SWT.RIGHT_TO_LEFT);
@@ -646,8 +659,11 @@
/**
* Returns the accessible object for the receiver.
+ * <p>
* If this is the first time this object is requested,
- * then the object is created and returned.
+ * then the object is created and returned. The object
+ * returned by getAccessible() does not need to be disposed.
+ * </p>
*
* @return the accessible object
*
@@ -1398,7 +1414,7 @@
/**
* Adds the listener to the collection of listeners who will
* be notified when gesture events are generated for the control,
- * by sending it one of the messages defined in the
+ * by sending it one of the messages defined in the
* <code>GestureListener</code> interface.
*
* @param listener the listener which should be notified
@@ -1664,6 +1680,8 @@
* windowing toolkit that you want touch events to be generated.
* </p>
*
+ * @param listener the listener which should be notified
+ *
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
* </ul>
@@ -1674,6 +1692,7 @@
*
* @see TouchListener
* @see #removeTouchListener
+ *
* @since 3.7
*/
public void addTouchListener (TouchListener listener) {
@@ -1786,7 +1805,7 @@
}
/**
* Removes the listener from the collection of listeners who will
- * be notified when a gesture is performed on the control
+ * be notified when gesture events are generated for the control.
*
* @param listener the listener which should no longer be notified
*
@@ -1800,6 +1819,7 @@
*
* @see GestureListener
* @see #addGestureListener
+ *
* @since 3.7
*/
public void removeGestureListener (GestureListener listener) {
@@ -2033,6 +2053,7 @@
*
* @see TouchListener
* @see #addTouchListener
+ *
* @since 3.7
*/
public void removeTouchListener(TouchListener listener) {
@@ -4062,6 +4083,20 @@
}
}
+/**
+ * Sets the orientation of the receiver, which must be one
+ * of the constants <code>SWT.LEFT_TO_RIGHT</code> or <code>SWT.RIGHT_TO_LEFT</code>.
+ * <p>
+ *
+ * @param orientation new orientation style
+ *
+ * @exception SWTException <ul>
+ * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
+ * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
+ * </ul>
+ *
+ * @since 3.7
+ */
public void setOrientation (int orientation) {
checkWidget ();
if (OS.GTK_VERSION < OS.VERSION (2, 4, 0)) return;
@@ -4254,18 +4289,15 @@
}
/**
- * Sets the receiver to receive touch events from the OS. By default, touch
- * events are not delivered to a control unless specifically requested for that control.
- * This is independent of whether or not there are any <code>TouchListener</code> instances
- * registered for the control.
- *
- * @param enabled the new touch-enabled state.
- *
+ * Sets whether the receiver should accept touch events. By default, a Control does not accept touch
+ * events. No error or exception is thrown if the underlying hardware does not support touch input.
+ *
+ * @param enabled the new touch-enabled state
+ *
* @exception SWTException <ul>
* <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
* <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
- * </ul>
- *
+ *
* @since 3.7
*/
public void setTouchEnabled(boolean enabled) {
diff --git a/bundles/org.eclipse.swt/Eclipse SWT/gtk/org/eclipse/swt/widgets/Display.java b/bundles/org.eclipse.swt/Eclipse SWT/gtk/org/eclipse/swt/widgets/Display.java
index 2864252..481990a 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT/gtk/org/eclipse/swt/widgets/Display.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT/gtk/org/eclipse/swt/widgets/Display.java
@@ -1450,7 +1450,7 @@
* over top of, or null if it is not currently over one of the
* controls built by the currently running application.
*
- * @return the control under the cursor
+ * @return the control under the cursor or <code>null</code>
*
* @exception SWTException <ul>
* <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
@@ -1759,7 +1759,7 @@
* any of the controls built by the currently running
* application.
*
- * @return the control under the cursor
+ * @return the focus control or <code>null</code>
*
* @exception SWTException <ul>
* <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
@@ -2381,6 +2381,11 @@
/**
* Returns true if a touch-aware input device is attached to the system,
* enabled, and ready for use.
+ *
+ * @exception SWTException <ul>
+ * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
+ * <li>ERROR_DEVICE_DISPOSED - if the receiver has been disposed</li>
+ * </ul>
*
* @since 3.7
*/
diff --git a/bundles/org.eclipse.swt/Eclipse SWT/gtk/org/eclipse/swt/widgets/Menu.java b/bundles/org.eclipse.swt/Eclipse SWT/gtk/org/eclipse/swt/widgets/Menu.java
index 163df87..2cc30e3 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT/gtk/org/eclipse/swt/widgets/Menu.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT/gtk/org/eclipse/swt/widgets/Menu.java
@@ -524,6 +524,19 @@
return result;
}
+/**
+ * Returns the orientation of the receiver, which will be one of the
+ * constants <code>SWT.LEFT_TO_RIGHT</code> or <code>SWT.RIGHT_TO_LEFT</code>.
+ *
+ * @return the orientation style
+ *
+ * @exception SWTException <ul>
+ * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
+ * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
+ * </ul>
+ *
+ * @since 3.7
+ */
public int getOrientation () {
checkWidget();
return style & (SWT.LEFT_TO_RIGHT | SWT.RIGHT_TO_LEFT);
@@ -984,6 +997,20 @@
setLocation (location.x, location.y);
}
+/**
+ * Sets the orientation of the receiver, which must be one
+ * of the constants <code>SWT.LEFT_TO_RIGHT</code> or <code>SWT.RIGHT_TO_LEFT</code>.
+ * <p>
+ *
+ * @param orientation new orientation style
+ *
+ * @exception SWTException <ul>
+ * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
+ * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
+ * </ul>
+ *
+ * @since 3.7
+ */
public void setOrientation (int orientation) {
checkWidget ();
if ((style & (SWT.BAR | SWT.DROP_DOWN)) != 0) return;
diff --git a/bundles/org.eclipse.swt/Eclipse SWT/gtk/org/eclipse/swt/widgets/Text.java b/bundles/org.eclipse.swt/Eclipse SWT/gtk/org/eclipse/swt/widgets/Text.java
index 95419a7..bd44119 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT/gtk/org/eclipse/swt/widgets/Text.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT/gtk/org/eclipse/swt/widgets/Text.java
@@ -1055,6 +1055,7 @@
* <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
* <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
* </ul>
+ * @see #setTextChars(char[])
* @since 3.7
*/
public char [] getTextChars () {
@@ -2122,6 +2123,7 @@
* <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
* <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
* </ul>
+ * @see #getTextChars()
* @since 3.7
*/
public void setTextChars (char [] text) {
diff --git a/bundles/org.eclipse.swt/Eclipse SWT/gtk/org/eclipse/swt/widgets/ToolItem.java b/bundles/org.eclipse.swt/Eclipse SWT/gtk/org/eclipse/swt/widgets/ToolItem.java
index 90f58b5..72122a4 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT/gtk/org/eclipse/swt/widgets/ToolItem.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT/gtk/org/eclipse/swt/widgets/ToolItem.java
@@ -1083,7 +1083,14 @@
/**
* Sets the width of the receiver, for <code>SEPARATOR</code> ToolItems.
*
- * @param width the new width
+ * @param width the new width. If the new value is <code>SWT.DEFAULT</code>,
+ * the width is a fixed-width area whose amount is determined by the platform.
+ * If the new value is 0 a vertical or horizontal line will be drawn, depending
+ * on the setting of the corresponding style bit (<code>SWT.VERTICAL</code> or
+ * <code>SWT.HORIZONTAL</code>). If the new value is <code>SWT.SEPARATOR_FILL</code>
+ * a variable-width space is inserted that acts as a spring between the two adjoining
+ * items which will push them out to the extent of the containing ToolBar.
+ *
*
* @exception SWTException <ul>
* <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
diff --git a/bundles/org.eclipse.swt/Eclipse SWT/motif/org/eclipse/swt/widgets/Control.java b/bundles/org.eclipse.swt/Eclipse SWT/motif/org/eclipse/swt/widgets/Control.java
index f9b9ee1..2406ede 100755
--- a/bundles/org.eclipse.swt/Eclipse SWT/motif/org/eclipse/swt/widgets/Control.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT/motif/org/eclipse/swt/widgets/Control.java
@@ -173,7 +173,7 @@
/**
* Adds the listener to the collection of listeners who will
* be notified when gesture events are generated for the control,
- * by sending it one of the messages defined in the
+ * by sending it one of the messages defined in the
* <code>GestureListener</code> interface.
*
* @param listener the listener which should be notified
@@ -427,6 +427,8 @@
* windowing toolkit that you want touch events to be generated.
* </p>
*
+ * @param listener the listener which should be notified
+ *
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
* </ul>
@@ -437,6 +439,7 @@
*
* @see TouchListener
* @see #removeTouchListener
+ *
* @since 3.7
*/
public void addTouchListener (TouchListener listener) {
@@ -865,8 +868,11 @@
/**
* Returns the accessible object for the receiver.
+ * <p>
* If this is the first time this object is requested,
- * then the object is created and returned.
+ * then the object is created and returned. The object
+ * returned by getAccessible() does not need to be disposed.
+ * </p>
*
* @return the accessible object
*
@@ -1270,6 +1276,19 @@
return argList [1];
}
+/**
+ * Returns the orientation of the receiver, which will be one of the
+ * constants <code>SWT.LEFT_TO_RIGHT</code> or <code>SWT.RIGHT_TO_LEFT</code>.
+ *
+ * @return the orientation style
+ *
+ * @exception SWTException <ul>
+ * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
+ * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
+ * </ul>
+ *
+ * @since 3.7
+ */
public int getOrientation () {
checkWidget ();
return style & (SWT.LEFT_TO_RIGHT | SWT.RIGHT_TO_LEFT);
@@ -2008,7 +2027,7 @@
}
/**
* Removes the listener from the collection of listeners who will
- * be notified when a gesture is performed on the control
+ * be notified when gesture events are generated for the control.
*
* @param listener the listener which should no longer be notified
*
@@ -2022,6 +2041,7 @@
*
* @see GestureListener
* @see #addGestureListener
+ *
* @since 3.7
*/
public void removeGestureListener (GestureListener listener) {
@@ -2240,6 +2260,7 @@
*
* @see TouchListener
* @see #addTouchListener
+ *
* @since 3.7
*/
public void removeTouchListener(TouchListener listener) {
@@ -2903,6 +2924,20 @@
this.menu = menu;
}
+/**
+ * Sets the orientation of the receiver, which must be one
+ * of the constants <code>SWT.LEFT_TO_RIGHT</code> or <code>SWT.RIGHT_TO_LEFT</code>.
+ * <p>
+ *
+ * @param orientation new orientation style
+ *
+ * @exception SWTException <ul>
+ * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
+ * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
+ * </ul>
+ *
+ * @since 3.7
+ */
public void setOrientation (int orientation) {
checkWidget ();
}
@@ -3133,18 +3168,15 @@
display.setToolTipText (handle, toolTipText = string);
}
/**
- * Sets the receiver to receive touch events from the OS. By default, touch
- * events are not delivered to a control unless specifically requested for that control.
- * This is independent of whether or not there are any <code>TouchListener</code> instances
- * registered for the control.
- *
- * @param enabled the new touch-enabled state.
- *
+ * Sets whether the receiver should accept touch events. By default, a Control does not accept touch
+ * events. No error or exception is thrown if the underlying hardware does not support touch input.
+ *
+ * @param enabled the new touch-enabled state
+ *
* @exception SWTException <ul>
* <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
* <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
- * </ul>
- *
+ *
* @since 3.7
*/
public void setTouchEnabled(boolean enabled) {
diff --git a/bundles/org.eclipse.swt/Eclipse SWT/motif/org/eclipse/swt/widgets/Display.java b/bundles/org.eclipse.swt/Eclipse SWT/motif/org/eclipse/swt/widgets/Display.java
index 5ffa624..e934028 100755
--- a/bundles/org.eclipse.swt/Eclipse SWT/motif/org/eclipse/swt/widgets/Display.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT/motif/org/eclipse/swt/widgets/Display.java
@@ -1320,7 +1320,7 @@
* over top of, or null if it is not currently over one of the
* controls built by the currently running application.
*
- * @return the control under the cursor
+ * @return the control under the cursor or <code>null</code>
*
* @exception SWTException <ul>
* <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
@@ -1508,7 +1508,7 @@
* any of the controls built by the currently running
* application.
*
- * @return the control under the cursor
+ * @return the focus control or <code>null</code>
*
* @exception SWTException <ul>
* <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
@@ -2041,6 +2041,11 @@
/**
* Returns true if a touch-aware input device is attached to the system,
* enabled, and ready for use.
+ *
+ * @exception SWTException <ul>
+ * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
+ * <li>ERROR_DEVICE_DISPOSED - if the receiver has been disposed</li>
+ * </ul>
*
* @since 3.7
*/
diff --git a/bundles/org.eclipse.swt/Eclipse SWT/motif/org/eclipse/swt/widgets/Menu.java b/bundles/org.eclipse.swt/Eclipse SWT/motif/org/eclipse/swt/widgets/Menu.java
index 5b4fd26..e1957d2 100755
--- a/bundles/org.eclipse.swt/Eclipse SWT/motif/org/eclipse/swt/widgets/Menu.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT/motif/org/eclipse/swt/widgets/Menu.java
@@ -514,6 +514,19 @@
return result;
}
+/**
+ * Returns the orientation of the receiver, which will be one of the
+ * constants <code>SWT.LEFT_TO_RIGHT</code> or <code>SWT.RIGHT_TO_LEFT</code>.
+ *
+ * @return the orientation style
+ *
+ * @exception SWTException <ul>
+ * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
+ * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
+ * </ul>
+ *
+ * @since 3.7
+ */
public int getOrientation () {
checkWidget ();
return style & (SWT.LEFT_TO_RIGHT | SWT.RIGHT_TO_LEFT);
@@ -877,6 +890,20 @@
setLocation (location.x, location.y);
}
+/**
+ * Sets the orientation of the receiver, which must be one
+ * of the constants <code>SWT.LEFT_TO_RIGHT</code> or <code>SWT.RIGHT_TO_LEFT</code>.
+ * <p>
+ *
+ * @param orientation new orientation style
+ *
+ * @exception SWTException <ul>
+ * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
+ * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
+ * </ul>
+ *
+ * @since 3.7
+ */
public void setOrientation (int orientation) {
checkWidget ();
}
diff --git a/bundles/org.eclipse.swt/Eclipse SWT/motif/org/eclipse/swt/widgets/Text.java b/bundles/org.eclipse.swt/Eclipse SWT/motif/org/eclipse/swt/widgets/Text.java
index 6269586..dcf0402 100755
--- a/bundles/org.eclipse.swt/Eclipse SWT/motif/org/eclipse/swt/widgets/Text.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT/motif/org/eclipse/swt/widgets/Text.java
@@ -948,6 +948,7 @@
* <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
* <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
* </ul>
+ * @see #setTextChars(char[])
* @since 3.7
*/
public char [] getTextChars () {
@@ -1569,6 +1570,7 @@
* <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
* <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
* </ul>
+ * @see #getTextChars()
* @since 3.7
*/
public void setTextChars (char [] text) {
diff --git a/bundles/org.eclipse.swt/Eclipse SWT/motif/org/eclipse/swt/widgets/ToolItem.java b/bundles/org.eclipse.swt/Eclipse SWT/motif/org/eclipse/swt/widgets/ToolItem.java
index 3acbc23..1844c6d 100755
--- a/bundles/org.eclipse.swt/Eclipse SWT/motif/org/eclipse/swt/widgets/ToolItem.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT/motif/org/eclipse/swt/widgets/ToolItem.java
@@ -845,7 +845,14 @@
/**
* Sets the width of the receiver, for <code>SEPARATOR</code> ToolItems.
*
- * @param width the new width
+ * @param width the new width. If the new value is <code>SWT.DEFAULT</code>,
+ * the width is a fixed-width area whose amount is determined by the platform.
+ * If the new value is 0 a vertical or horizontal line will be drawn, depending
+ * on the setting of the corresponding style bit (<code>SWT.VERTICAL</code> or
+ * <code>SWT.HORIZONTAL</code>). If the new value is <code>SWT.SEPARATOR_FILL</code>
+ * a variable-width space is inserted that acts as a spring between the two adjoining
+ * items which will push them out to the extent of the containing ToolBar.
+ *
*
* @exception SWTException <ul>
* <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
diff --git a/bundles/org.eclipse.swt/Eclipse SWT/photon/org/eclipse/swt/widgets/Control.java b/bundles/org.eclipse.swt/Eclipse SWT/photon/org/eclipse/swt/widgets/Control.java
index 1b8805a..7fc70cf 100755
--- a/bundles/org.eclipse.swt/Eclipse SWT/photon/org/eclipse/swt/widgets/Control.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT/photon/org/eclipse/swt/widgets/Control.java
@@ -178,7 +178,7 @@
/**
* Adds the listener to the collection of listeners who will
* be notified when gesture events are generated for the control,
- * by sending it one of the messages defined in the
+ * by sending it one of the messages defined in the
* <code>GestureListener</code> interface.
*
* @param listener the listener which should be notified
@@ -441,6 +441,8 @@
* windowing toolkit that you want touch events to be generated.
* </p>
*
+ * @param listener the listener which should be notified
+ *
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
* </ul>
@@ -451,6 +453,7 @@
*
* @see TouchListener
* @see #removeTouchListener
+ *
* @since 3.7
*/
public void addTouchListener (TouchListener listener) {
@@ -820,8 +823,11 @@
/**
* Returns the accessible object for the receiver.
+ * <p>
* If this is the first time this object is requested,
- * then the object is created and returned.
+ * then the object is created and returned. The object
+ * returned by getAccessible() does not need to be disposed.
+ * </p>
*
* @return the accessible object
*
@@ -1144,6 +1150,24 @@
}
/**
+ * Returns the orientation of the receiver, which will be one of the
+ * constants <code>SWT.LEFT_TO_RIGHT</code> or <code>SWT.RIGHT_TO_LEFT</code>.
+ *
+ * @return the orientation style
+ *
+ * @exception SWTException <ul>
+ * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
+ * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
+ * </ul>
+ *
+ * @since 3.7
+ */
+public int getOrientation () {
+ checkWidget ();
+ return style & (SWT.LEFT_TO_RIGHT | SWT.RIGHT_TO_LEFT);
+}
+
+/**
* Returns the receiver's parent, which must be a <code>Composite</code>
* or null when the receiver is a shell that was created with null or
* a display for a parent.
@@ -2150,7 +2174,7 @@
/**
* Removes the listener from the collection of listeners who will
- * be notified when a gesture is performed on the control
+ * be notified when gesture events are generated for the control.
*
* @param listener the listener which should no longer be notified
*
@@ -2164,6 +2188,7 @@
*
* @see GestureListener
* @see #addGestureListener
+ *
* @since 3.7
*/
public void removeGestureListener (GestureListener listener) {
@@ -2391,6 +2416,7 @@
*
* @see TouchListener
* @see #addTouchListener
+ *
* @since 3.7
*/
public void removeTouchListener(TouchListener listener) {
@@ -2895,6 +2921,24 @@
}
/**
+ * Sets the orientation of the receiver, which must be one
+ * of the constants <code>SWT.LEFT_TO_RIGHT</code> or <code>SWT.RIGHT_TO_LEFT</code>.
+ * <p>
+ *
+ * @param orientation new orientation style
+ *
+ * @exception SWTException <ul>
+ * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
+ * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
+ * </ul>
+ *
+ * @since 3.7
+ */
+public void setOrientation (int orientation) {
+ checkWidget ();
+}
+
+/**
* Changes the parent of the widget to be the one provided if
* the underlying operating system supports this feature.
* Returns <code>true</code> if the parent is successfully changed.
@@ -3032,18 +3076,15 @@
}
/**
- * Sets the receiver to receive touch events from the OS. By default, touch
- * events are not delivered to a control unless specifically requested for that control.
- * This is independent of whether or not there are any <code>TouchListener</code> instances
- * registered for the control.
- *
- * @param enabled the new touch-enabled state.
- *
+ * Sets whether the receiver should accept touch events. By default, a Control does not accept touch
+ * events. No error or exception is thrown if the underlying hardware does not support touch input.
+ *
+ * @param enabled the new touch-enabled state
+ *
* @exception SWTException <ul>
* <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
* <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
- * </ul>
- *
+ *
* @since 3.7
*/
public void setTouchEnabled(boolean enabled) {
diff --git a/bundles/org.eclipse.swt/Eclipse SWT/photon/org/eclipse/swt/widgets/Display.java b/bundles/org.eclipse.swt/Eclipse SWT/photon/org/eclipse/swt/widgets/Display.java
index 0a848eb..90e38b2 100755
--- a/bundles/org.eclipse.swt/Eclipse SWT/photon/org/eclipse/swt/widgets/Display.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT/photon/org/eclipse/swt/widgets/Display.java
@@ -804,7 +804,7 @@
* over top of, or null if it is not currently over one of the
* controls built by the currently running application.
*
- * @return the control under the cursor
+ * @return the control under the cursor or <code>null</code>
*
* @exception SWTException <ul>
* <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
@@ -1025,7 +1025,7 @@
* any of the controls built by the currently running
* application.
*
- * @return the control under the cursor
+ * @return the focus control or <code>null</code>
*
* @exception SWTException <ul>
* <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
@@ -1477,6 +1477,11 @@
/**
* Returns true if a touch-aware input device is attached to the system,
* enabled, and ready for use.
+ *
+ * @exception SWTException <ul>
+ * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
+ * <li>ERROR_DEVICE_DISPOSED - if the receiver has been disposed</li>
+ * </ul>
*
* @since 3.7
*/
diff --git a/bundles/org.eclipse.swt/Eclipse SWT/photon/org/eclipse/swt/widgets/Menu.java b/bundles/org.eclipse.swt/Eclipse SWT/photon/org/eclipse/swt/widgets/Menu.java
index c54ba7b..caa3c4f 100755
--- a/bundles/org.eclipse.swt/Eclipse SWT/photon/org/eclipse/swt/widgets/Menu.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT/photon/org/eclipse/swt/widgets/Menu.java
@@ -413,6 +413,24 @@
}
/**
+ * Returns the orientation of the receiver, which will be one of the
+ * constants <code>SWT.LEFT_TO_RIGHT</code> or <code>SWT.RIGHT_TO_LEFT</code>.
+ *
+ * @return the orientation style
+ *
+ * @exception SWTException <ul>
+ * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
+ * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
+ * </ul>
+ *
+ * @since 3.7
+ */
+public int getOrientation () {
+ checkWidget ();
+ return style & (SWT.LEFT_TO_RIGHT | SWT.RIGHT_TO_LEFT);
+}
+
+/**
* Returns the receiver's parent, which must be a <code>Decorations</code>.
*
* @return the receiver's parent
@@ -804,6 +822,24 @@
}
/**
+ * Sets the orientation of the receiver, which must be one
+ * of the constants <code>SWT.LEFT_TO_RIGHT</code> or <code>SWT.RIGHT_TO_LEFT</code>.
+ * <p>
+ *
+ * @param orientation new orientation style
+ *
+ * @exception SWTException <ul>
+ * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
+ * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
+ * </ul>
+ *
+ * @since 3.7
+ */
+public void setOrientation (int orientation) {
+ checkWidget ();
+}
+
+/**
* Marks the receiver as visible if the argument is <code>true</code>,
* and marks it invisible otherwise.
* <p>
diff --git a/bundles/org.eclipse.swt/Eclipse SWT/photon/org/eclipse/swt/widgets/Text.java b/bundles/org.eclipse.swt/Eclipse SWT/photon/org/eclipse/swt/widgets/Text.java
index 9a7d1ad..846c272 100755
--- a/bundles/org.eclipse.swt/Eclipse SWT/photon/org/eclipse/swt/widgets/Text.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT/photon/org/eclipse/swt/widgets/Text.java
@@ -842,6 +842,7 @@
* <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
* <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
* </ul>
+ * @see #setTextChars(char[])
* @since 3.7
*/
public char [] getTextChars () {
@@ -1551,6 +1552,7 @@
* <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
* <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
* </ul>
+ * @see #getTextChars()
* @since 3.7
*/
public void setTextChars (char [] text) {
diff --git a/bundles/org.eclipse.swt/Eclipse SWT/photon/org/eclipse/swt/widgets/ToolItem.java b/bundles/org.eclipse.swt/Eclipse SWT/photon/org/eclipse/swt/widgets/ToolItem.java
index 74ea3c3..4afb3d0 100755
--- a/bundles/org.eclipse.swt/Eclipse SWT/photon/org/eclipse/swt/widgets/ToolItem.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT/photon/org/eclipse/swt/widgets/ToolItem.java
@@ -953,7 +953,14 @@
/**
* Sets the width of the receiver, for <code>SEPARATOR</code> ToolItems.
*
- * @param width the new width
+ * @param width the new width. If the new value is <code>SWT.DEFAULT</code>,
+ * the width is a fixed-width area whose amount is determined by the platform.
+ * If the new value is 0 a vertical or horizontal line will be drawn, depending
+ * on the setting of the corresponding style bit (<code>SWT.VERTICAL</code> or
+ * <code>SWT.HORIZONTAL</code>). If the new value is <code>SWT.SEPARATOR_FILL</code>
+ * a variable-width space is inserted that acts as a spring between the two adjoining
+ * items which will push them out to the extent of the containing ToolBar.
+ *
*
* @exception SWTException <ul>
* <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
diff --git a/bundles/org.eclipse.swt/Eclipse SWT/wpf/org/eclipse/swt/widgets/Composite.java b/bundles/org.eclipse.swt/Eclipse SWT/wpf/org/eclipse/swt/widgets/Composite.java
index bfceaad..530535f 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT/wpf/org/eclipse/swt/widgets/Composite.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT/wpf/org/eclipse/swt/widgets/Composite.java
@@ -356,6 +356,40 @@
return 0;
}
+/**
+ * Fills the interior of the rectangle specified by the arguments,
+ * with the receiver's background.
+ *
+ * <p>The <code>offsetX</code> and <code>offsetY</code> are used to map from
+ * the <code>gc</code> origin to the origin of the parent image background. This is useful
+ * to ensure proper alignment of the image background.</p>
+ *
+ * @param gc the gc where the rectangle is to be filled
+ * @param x the x coordinate of the rectangle to be filled
+ * @param y the y coordinate of the rectangle to be filled
+ * @param width the width of the rectangle to be filled
+ * @param height the height of the rectangle to be filled
+ * @param offsetX the image background x offset
+ * @param offsetY the image background y offset
+ *
+ * @exception IllegalArgumentException <ul>
+ * <li>ERROR_NULL_ARGUMENT - if the gc is null</li>
+ * <li>ERROR_INVALID_ARGUMENT - if the gc has been disposed</li>
+ * </ul>
+ * @exception SWTException <ul>
+ * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
+ * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
+ * </ul>
+ *
+ * @since 3.6
+ */
+public void drawBackground (GC gc, int x, int y, int width, int height, int offsetX, int offsetY) {
+ checkWidget ();
+ if (gc == null) error (SWT.ERROR_NULL_ARGUMENT);
+ if (gc.isDisposed ()) error (SWT.ERROR_INVALID_ARGUMENT);
+ //gc.fillRectangle (x, y, width, height);
+}
+
void enableWidget (boolean enabled) {
if ((state & CANVAS) != 0) {
OS.UIElement_IsHitTestVisible (topHandle (), enabled);
diff --git a/bundles/org.eclipse.swt/Eclipse SWT/wpf/org/eclipse/swt/widgets/Control.java b/bundles/org.eclipse.swt/Eclipse SWT/wpf/org/eclipse/swt/widgets/Control.java
index d119470..e01421f 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT/wpf/org/eclipse/swt/widgets/Control.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT/wpf/org/eclipse/swt/widgets/Control.java
@@ -185,7 +185,7 @@
/**
* Adds the listener to the collection of listeners who will
* be notified when gesture events are generated for the control,
- * by sending it one of the messages defined in the
+ * by sending it one of the messages defined in the
* <code>GestureListener</code> interface.
*
* @param listener the listener which should be notified
@@ -448,6 +448,8 @@
* windowing toolkit that you want touch events to be generated.
* </p>
*
+ * @param listener the listener which should be notified
+ *
* @exception IllegalArgumentException <ul>
* <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
* </ul>
@@ -458,6 +460,7 @@
*
* @see TouchListener
* @see #removeTouchListener
+ *
* @since 3.7
*/
public void addTouchListener (TouchListener listener) {
@@ -905,8 +908,11 @@
/**
* Returns the accessible object for the receiver.
+ * <p>
* If this is the first time this object is requested,
- * then the object is created and returned.
+ * then the object is created and returned. The object
+ * returned by getAccessible() does not need to be disposed.
+ * </p>
*
* @return the accessible object
*
@@ -1194,6 +1200,24 @@
}
/**
+ * Returns the orientation of the receiver, which will be one of the
+ * constants <code>SWT.LEFT_TO_RIGHT</code> or <code>SWT.RIGHT_TO_LEFT</code>.
+ *
+ * @return the orientation style
+ *
+ * @exception SWTException <ul>
+ * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
+ * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
+ * </ul>
+ *
+ * @since 3.7
+ */
+public int getOrientation () {
+ checkWidget ();
+ return style & (SWT.LEFT_TO_RIGHT | SWT.RIGHT_TO_LEFT);
+}
+
+/**
* Returns the receiver's parent, which must be a <code>Composite</code>
* or null when the receiver is a shell that was created with null or
* a display for a parent.
@@ -2221,7 +2245,7 @@
/**
* Removes the listener from the collection of listeners who will
- * be notified when a gesture is performed on the control
+ * be notified when gesture events are generated for the control.
*
* @param listener the listener which should no longer be notified
*
@@ -2235,6 +2259,7 @@
*
* @see GestureListener
* @see #addGestureListener
+ *
* @since 3.7
*/
public void removeGestureListener (GestureListener listener) {
@@ -2462,6 +2487,7 @@
*
* @see TouchListener
* @see #addTouchListener
+ *
* @since 3.7
*/
public void removeTouchListener(TouchListener listener) {
@@ -3276,18 +3302,15 @@
}
/**
- * Sets the receiver to receive touch events from the OS. By default, touch
- * events are not delivered to a control unless specifically requested for that control.
- * This is independent of whether or not there are any <code>TouchListener</code> instances
- * registered for the control.
- *
- * @param enabled the new touch-enabled state.
- *
+ * Sets whether the receiver should accept touch events. By default, a Control does not accept touch
+ * events. No error or exception is thrown if the underlying hardware does not support touch input.
+ *
+ * @param enabled the new touch-enabled state
+ *
* @exception SWTException <ul>
* <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
* <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
- * </ul>
- *
+ *
* @since 3.7
*/
public void setTouchEnabled(boolean enabled) {
@@ -3926,6 +3949,24 @@
}
/**
+ * Sets the orientation of the receiver, which must be one
+ * of the constants <code>SWT.LEFT_TO_RIGHT</code> or <code>SWT.RIGHT_TO_LEFT</code>.
+ * <p>
+ *
+ * @param orientation new orientation style
+ *
+ * @exception SWTException <ul>
+ * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
+ * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
+ * </ul>
+ *
+ * @since 3.7
+ */
+public void setOrientation (int orientation) {
+ checkWidget ();
+}
+
+/**
* Changes the parent of the widget to be the one provided if
* the underlying operating system supports this feature.
* Returns <code>true</code> if the parent is successfully changed.
diff --git a/bundles/org.eclipse.swt/Eclipse SWT/wpf/org/eclipse/swt/widgets/Display.java b/bundles/org.eclipse.swt/Eclipse SWT/wpf/org/eclipse/swt/widgets/Display.java
index 7f659dc..9f31160 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT/wpf/org/eclipse/swt/widgets/Display.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT/wpf/org/eclipse/swt/widgets/Display.java
@@ -164,6 +164,9 @@
Shell [] shells;
+ static String APP_NAME = "SWT";
+ static String APP_VERSION = ""; //$NON-NLS-1$
+
/* Key Mappings */
static final int [] [] KeyTable = {
@@ -1039,7 +1042,7 @@
* over top of, or null if it is not currently over one of the
* controls built by the currently running application.
*
- * @return the control under the cursor
+ * @return the control under the cursor or <code>null</code>
*
* @exception SWTException <ul>
* <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
@@ -1248,7 +1251,7 @@
* any of the controls built by the currently running
* application.
*
- * @return the control under the cursor
+ * @return the focus control or <code>null</code>
*
* @exception SWTException <ul>
* <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
@@ -1733,6 +1736,11 @@
/**
* Returns true if a touch-aware input device is attached to the system,
* enabled, and ready for use.
+ *
+ * @exception SWTException <ul>
+ * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
+ * <li>ERROR_DEVICE_DISPOSED - if the receiver has been disposed</li>
+ * </ul>
*
* @since 3.7
*/
@@ -2880,6 +2888,32 @@
}
/**
+ * Returns the application name.
+ *
+ * @return the application name
+ *
+ * @see #setAppName(String)
+ *
+ * @since 3.6
+ */
+public static String getAppName () {
+ return APP_NAME;
+}
+
+/**
+ * Returns the application version.
+ *
+ * @return the application version
+ *
+ * @see #setAppVersion(String)
+ *
+ * @since 3.6
+ */
+public static String getAppVersion () {
+ return APP_VERSION;
+}
+
+/**
* Sets the application name to the argument.
* <p>
* The application name can be used in several ways,
@@ -2894,7 +2928,18 @@
* @param name the new app name or <code>null</code>
*/
public static void setAppName (String name) {
- /* Do nothing */
+ APP_NAME = name;
+}
+
+/**
+ * Sets the application version to the argument.
+ *
+ * @param version the new app version
+ *
+ * @since 3.6
+ */
+public static void setAppVersion (String version) {
+ APP_VERSION = version;
}
//void setModalDialogShell (Shell modalDailog) {
diff --git a/bundles/org.eclipse.swt/Eclipse SWT/wpf/org/eclipse/swt/widgets/Menu.java b/bundles/org.eclipse.swt/Eclipse SWT/wpf/org/eclipse/swt/widgets/Menu.java
index 5130e87..d7fc61c 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT/wpf/org/eclipse/swt/widgets/Menu.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT/wpf/org/eclipse/swt/widgets/Menu.java
@@ -491,6 +491,24 @@
}
/**
+ * Returns the orientation of the receiver, which will be one of the
+ * constants <code>SWT.LEFT_TO_RIGHT</code> or <code>SWT.RIGHT_TO_LEFT</code>.
+ *
+ * @return the orientation style
+ *
+ * @exception SWTException <ul>
+ * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
+ * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
+ * </ul>
+ *
+ * @since 3.7
+ */
+public int getOrientation () {
+ checkWidget ();
+ return style & (SWT.LEFT_TO_RIGHT | SWT.RIGHT_TO_LEFT);
+}
+
+/**
* Returns the receiver's parent, which must be a <code>Decorations</code>.
*
* @return the receiver's parent
@@ -895,6 +913,24 @@
}
/**
+ * Sets the orientation of the receiver, which must be one
+ * of the constants <code>SWT.LEFT_TO_RIGHT</code> or <code>SWT.RIGHT_TO_LEFT</code>.
+ * <p>
+ *
+ * @param orientation new orientation style
+ *
+ * @exception SWTException <ul>
+ * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
+ * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
+ * </ul>
+ *
+ * @since 3.7
+ */
+public void setOrientation (int orientation) {
+ checkWidget ();
+}
+
+/**
* Marks the receiver as visible if the argument is <code>true</code>,
* and marks it invisible otherwise.
* <p>
diff --git a/bundles/org.eclipse.swt/Eclipse SWT/wpf/org/eclipse/swt/widgets/Text.java b/bundles/org.eclipse.swt/Eclipse SWT/wpf/org/eclipse/swt/widgets/Text.java
index 19bc191..a1c1c41 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT/wpf/org/eclipse/swt/widgets/Text.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT/wpf/org/eclipse/swt/widgets/Text.java
@@ -757,6 +757,7 @@
* <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
* <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
* </ul>
+ * @see #setTextChars(char[])
* @since 3.7
*/
public char [] getTextChars () {
@@ -1408,6 +1409,7 @@
* <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
* <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
* </ul>
+ * @see #getTextChars()
* @since 3.7
*/
public void setTextChars (char [] text) {
diff --git a/bundles/org.eclipse.swt/Eclipse SWT/wpf/org/eclipse/swt/widgets/ToolItem.java b/bundles/org.eclipse.swt/Eclipse SWT/wpf/org/eclipse/swt/widgets/ToolItem.java
index 203dba1..ca7b059 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT/wpf/org/eclipse/swt/widgets/ToolItem.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT/wpf/org/eclipse/swt/widgets/ToolItem.java
@@ -825,7 +825,14 @@
/**
* Sets the width of the receiver, for <code>SEPARATOR</code> ToolItems.
*
- * @param width the new width
+ * @param width the new width. If the new value is <code>SWT.DEFAULT</code>,
+ * the width is a fixed-width area whose amount is determined by the platform.
+ * If the new value is 0 a vertical or horizontal line will be drawn, depending
+ * on the setting of the corresponding style bit (<code>SWT.VERTICAL</code> or
+ * <code>SWT.HORIZONTAL</code>). If the new value is <code>SWT.SEPARATOR_FILL</code>
+ * a variable-width space is inserted that acts as a spring between the two adjoining
+ * items which will push them out to the extent of the containing ToolBar.
+ *
*
* @exception SWTException <ul>
* <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
