diff options
author | Carolyn MacLeod <carolyn> | 2011-05-09 17:12:22 +0000 |
---|---|---|
committer | Carolyn MacLeod <carolyn> | 2011-05-09 17:12:22 +0000 |
commit | 0c693ec68aa92990fed67d5ac8294b0904382aa6 (patch) | |
tree | b59636fb131d9237001b502c89ac93b81a964fdf /bundles | |
parent | d05fd93fefebb6bc1d07ca12de432d36944a8740 (diff) | |
download | eclipse.platform.swt-0c693ec68aa92990fed67d5ac8294b0904382aa6.tar.gz eclipse.platform.swt-0c693ec68aa92990fed67d5ac8294b0904382aa6.tar.xz eclipse.platform.swt-0c693ec68aa92990fed67d5ac8294b0904382aa6.zip |
After javadoc bash for 3.7RC1AFTER_JAVADOC_BASH_FOR_37RC1
Diffstat (limited to 'bundles')
42 files changed, 1043 insertions, 427 deletions
diff --git a/bundles/org.eclipse.swt/Eclipse SWT AWT/cocoa/org/eclipse/swt/awt/SWT_AWT.java b/bundles/org.eclipse.swt/Eclipse SWT AWT/cocoa/org/eclipse/swt/awt/SWT_AWT.java index 08b8e4aefa..a80ca86abb 100755 --- a/bundles/org.eclipse.swt/Eclipse SWT AWT/cocoa/org/eclipse/swt/awt/SWT_AWT.java +++ b/bundles/org.eclipse.swt/Eclipse SWT AWT/cocoa/org/eclipse/swt/awt/SWT_AWT.java @@ -83,231 +83,231 @@ public class SWT_AWT { } catch (Throwable e) {} } - /** - * Returns a <code>java.awt.Frame</code> which is the embedded frame - * associated with the specified composite. - * - * @param parent the parent <code>Composite</code> of the <code>java.awt.Frame</code> - * @return a <code>java.awt.Frame</code> the embedded frame or <code>null</code>. - * - * @exception IllegalArgumentException <ul> - * <li>ERROR_NULL_ARGUMENT - if the parent is null</li> - * </ul> - * - * @since 3.2 - */ - public static Frame getFrame(Composite parent) { - if (parent == null) SWT.error(SWT.ERROR_NULL_ARGUMENT); - if ((parent.getStyle() & SWT.EMBEDDED) == 0) return null; - return (Frame) parent.getData(EMBEDDED_FRAME_KEY); +/** + * Returns a <code>java.awt.Frame</code> which is the embedded frame + * associated with the specified composite. + * + * @param parent the parent <code>Composite</code> of the <code>java.awt.Frame</code> + * @return a <code>java.awt.Frame</code> the embedded frame or <code>null</code>. + * + * @exception IllegalArgumentException <ul> + * <li>ERROR_NULL_ARGUMENT - if the parent is null</li> + * </ul> + * + * @since 3.2 + */ +public static Frame getFrame(Composite parent) { + if (parent == null) SWT.error(SWT.ERROR_NULL_ARGUMENT); + if ((parent.getStyle() & SWT.EMBEDDED) == 0) return null; + return (Frame) parent.getData(EMBEDDED_FRAME_KEY); +} + +/** + * Creates a new <code>java.awt.Frame</code>. This frame is the root for + * the AWT components that will be embedded within the composite. In order + * for the embedding to succeed, the composite must have been created + * with the SWT.EMBEDDED style. + * <p> + * IMPORTANT: As of JDK1.5, the embedded frame does not receive mouse events. + * When a lightweight component is added as a child of the embedded frame, + * the cursor does not change. In order to work around both these problems, it is + * strongly recommended that a heavyweight component such as <code>java.awt.Panel</code> + * be added to the frame as the root of all components. + * </p> + * + * @param parent the parent <code>Composite</code> of the new <code>java.awt.Frame</code> + * @return a <code>java.awt.Frame</code> to be the parent of the embedded AWT components + * + * @exception IllegalArgumentException <ul> + * <li>ERROR_NULL_ARGUMENT - if the parent is null</li> + * <li>ERROR_INVALID_ARGUMENT - if the parent Composite does not have the SWT.EMBEDDED style</li> + * </ul> + * + * @since 3.0 + */ +public static Frame new_Frame(final Composite parent) { + if (parent == null) SWT.error(SWT.ERROR_NULL_ARGUMENT); + if ((parent.getStyle() & SWT.EMBEDDED) == 0) { + SWT.error(SWT.ERROR_INVALID_ARGUMENT); } - /** - * Creates a new <code>java.awt.Frame</code>. This frame is the root for - * the AWT components that will be embedded within the composite. In order - * for the embedding to succeed, the composite must have been created - * with the SWT.EMBEDDED style. - * <p> - * IMPORTANT: As of JDK1.5, the embedded frame does not receive mouse events. - * When a lightweight component is added as a child of the embedded frame, - * the cursor does not change. In order to work around both these problems, it is - * strongly recommended that a heavyweight component such as <code>java.awt.Panel</code> - * be added to the frame as the root of all components. - * </p> - * - * @param parent the parent <code>Composite</code> of the new <code>java.awt.Frame</code> - * @return a <code>java.awt.Frame</code> to be the parent of the embedded AWT components - * - * @exception IllegalArgumentException <ul> - * <li>ERROR_NULL_ARGUMENT - if the parent is null</li> - * <li>ERROR_INVALID_ARGUMENT - if the parent Composite does not have the SWT.EMBEDDED style</li> - * </ul> - * - * @since 3.0 - */ - public static Frame new_Frame(final Composite parent) { - if (parent == null) SWT.error(SWT.ERROR_NULL_ARGUMENT); - if ((parent.getStyle() & SWT.EMBEDDED) == 0) { - SWT.error(SWT.ERROR_INVALID_ARGUMENT); + final int /*long*/ handle = parent.view.id; + + Class clazz = null; + try { + String className = embeddedFrameClass != null ? embeddedFrameClass : "apple.awt.CEmbeddedFrame"; + if (embeddedFrameClass == null) { + clazz = Class.forName(className, true, ClassLoader.getSystemClassLoader()); + } else { + clazz = Class.forName(className); } - - final int /*long*/ handle = parent.view.id; - - Class clazz = null; - try { - String className = embeddedFrameClass != null ? embeddedFrameClass : "apple.awt.CEmbeddedFrame"; - if (embeddedFrameClass == null) { - clazz = Class.forName(className, true, ClassLoader.getSystemClassLoader()); - } else { - clazz = Class.forName(className); + } catch (ClassNotFoundException cne) { + SWT.error (SWT.ERROR_NOT_IMPLEMENTED, cne); + } catch (Throwable e) { + SWT.error (SWT.ERROR_UNSPECIFIED , e, " [Error while starting AWT]"); + } + + initializeSwing(); + Object value = null; + Constructor constructor = null; + try { + constructor = clazz.getConstructor (new Class [] {long.class}); + value = constructor.newInstance (new Object [] {new Long(handle)}); + } catch (Throwable e) { + SWT.error(SWT.ERROR_NOT_IMPLEMENTED, e); + } + final Frame frame = (Frame) value; + frame.addNotify(); + + parent.setData(EMBEDDED_FRAME_KEY, frame); + + /* Forward the iconify and deiconify events */ + final Listener shellListener = new Listener () { + public void handleEvent (Event e) { + switch (e.type) { + case SWT.Deiconify: + EventQueue.invokeLater(new Runnable () { + public void run () { + frame.dispatchEvent (new WindowEvent (frame, WindowEvent.WINDOW_DEICONIFIED)); + } + }); + break; + case SWT.Iconify: + EventQueue.invokeLater(new Runnable () { + public void run () { + frame.dispatchEvent (new WindowEvent (frame, WindowEvent.WINDOW_ICONIFIED)); + } + }); + break; } - } catch (ClassNotFoundException cne) { - SWT.error (SWT.ERROR_NOT_IMPLEMENTED, cne); - } catch (Throwable e) { - SWT.error (SWT.ERROR_UNSPECIFIED , e, " [Error while starting AWT]"); - } - - initializeSwing(); - Object value = null; - Constructor constructor = null; - try { - constructor = clazz.getConstructor (new Class [] {long.class}); - value = constructor.newInstance (new Object [] {new Long(handle)}); - } catch (Throwable e) { - SWT.error(SWT.ERROR_NOT_IMPLEMENTED, e); } - final Frame frame = (Frame) value; - frame.addNotify(); - - parent.setData(EMBEDDED_FRAME_KEY, frame); - - /* Forward the iconify and deiconify events */ - final Listener shellListener = new Listener () { - public void handleEvent (Event e) { - switch (e.type) { - case SWT.Deiconify: - EventQueue.invokeLater(new Runnable () { - public void run () { - frame.dispatchEvent (new WindowEvent (frame, WindowEvent.WINDOW_DEICONIFIED)); - } - }); - break; - case SWT.Iconify: - EventQueue.invokeLater(new Runnable () { - public void run () { - frame.dispatchEvent (new WindowEvent (frame, WindowEvent.WINDOW_ICONIFIED)); - } - }); - break; - } + }; + Shell shell = parent.getShell (); + shell.addListener (SWT.Deiconify, shellListener); + shell.addListener (SWT.Iconify, shellListener); + + /* + * Generate the appropriate events to activate and deactivate + * the embedded frame. This is needed in order to make keyboard + * focus work properly for lightweights. + */ + Listener listener = new Listener () { + public void handleEvent (Event e) { + switch (e.type) { + case SWT.Dispose: + Shell shell = parent.getShell (); + shell.removeListener (SWT.Deiconify, shellListener); + shell.removeListener (SWT.Iconify, shellListener); + parent.setVisible(false); + EventQueue.invokeLater(new Runnable () { + public void run () { + try { + frame.dispose (); + } catch (Throwable e) {} + } + }); + break; + case SWT.FocusIn: + EventQueue.invokeLater(new Runnable () { + public void run () { + if (frame.isActive()) return; + try { + Class clazz = frame.getClass(); + Method method = clazz.getMethod("synthesizeWindowActivation", new Class[]{boolean.class}); + if (method != null) method.invoke(frame, new Object[]{new Boolean(true)}); + } catch (Throwable e) {e.printStackTrace();} + } + }); + break; + case SWT.Deactivate: + EventQueue.invokeLater(new Runnable () { + public void run () { + if (!frame.isActive()) return; + try { + Class clazz = frame.getClass(); + Method method = clazz.getMethod("synthesizeWindowActivation", new Class[]{boolean.class}); + if (method != null) method.invoke(frame, new Object[]{new Boolean(false)}); + } catch (Throwable e) {e.printStackTrace();} + } + }); + break; } - }; - Shell shell = parent.getShell (); - shell.addListener (SWT.Deiconify, shellListener); - shell.addListener (SWT.Iconify, shellListener); - - /* - * Generate the appropriate events to activate and deactivate - * the embedded frame. This is needed in order to make keyboard - * focus work properly for lightweights. - */ - Listener listener = new Listener () { - public void handleEvent (Event e) { - switch (e.type) { - case SWT.Dispose: - Shell shell = parent.getShell (); - shell.removeListener (SWT.Deiconify, shellListener); - shell.removeListener (SWT.Iconify, shellListener); - parent.setVisible(false); - EventQueue.invokeLater(new Runnable () { - public void run () { - try { - frame.dispose (); - } catch (Throwable e) {} - } - }); - break; - case SWT.FocusIn: - EventQueue.invokeLater(new Runnable () { - public void run () { - if (frame.isActive()) return; - try { - Class clazz = frame.getClass(); - Method method = clazz.getMethod("synthesizeWindowActivation", new Class[]{boolean.class}); - if (method != null) method.invoke(frame, new Object[]{new Boolean(true)}); - } catch (Throwable e) {e.printStackTrace();} - } - }); - break; - case SWT.Deactivate: - EventQueue.invokeLater(new Runnable () { - public void run () { - if (!frame.isActive()) return; - try { - Class clazz = frame.getClass(); - Method method = clazz.getMethod("synthesizeWindowActivation", new Class[]{boolean.class}); - if (method != null) method.invoke(frame, new Object[]{new Boolean(false)}); - } catch (Throwable e) {e.printStackTrace();} - } - }); - break; + } + }; + + parent.addListener (SWT.FocusIn, listener); + parent.addListener (SWT.Deactivate, listener); + parent.addListener (SWT.Dispose, listener); + + parent.getDisplay().asyncExec(new Runnable() { + public void run () { + if (parent.isDisposed()) return; + final Rectangle clientArea = parent.getClientArea(); + EventQueue.invokeLater(new Runnable () { + public void run () { + frame.setSize (clientArea.width, clientArea.height); + frame.validate(); + + // Bug in Cocoa AWT? For some reason the frame isn't showing up on first draw. + // Toggling visibility seems to be the only thing that works. + frame.setVisible(false); + frame.setVisible(true); } - } - }; - - parent.addListener (SWT.FocusIn, listener); - parent.addListener (SWT.Deactivate, listener); - parent.addListener (SWT.Dispose, listener); - - parent.getDisplay().asyncExec(new Runnable() { - public void run () { - if (parent.isDisposed()) return; - final Rectangle clientArea = parent.getClientArea(); - EventQueue.invokeLater(new Runnable () { - public void run () { - frame.setSize (clientArea.width, clientArea.height); - frame.validate(); - - // Bug in Cocoa AWT? For some reason the frame isn't showing up on first draw. - // Toggling visibility seems to be the only thing that works. - frame.setVisible(false); - frame.setVisible(true); - } - }); - } - }); - - return frame; + }); + } + }); + + return frame; +} + +/** + * Creates a new <code>Shell</code>. This Shell is the root for + * the SWT widgets that will be embedded within the AWT canvas. + * + * @param display the display for the new Shell + * @param parent the parent <code>java.awt.Canvas</code> of the new Shell + * @return a <code>Shell</code> to be the parent of the embedded SWT widgets + * + * @exception IllegalArgumentException <ul> + * <li>ERROR_NULL_ARGUMENT - if the display is null</li> + * <li>ERROR_NULL_ARGUMENT - if the parent is null</li> + * <li>ERROR_INVALID_ARGUMENT - if the parent's peer is not created</li> + * </ul> + * + * @since 3.0 + */ +public static Shell new_Shell(final Display display, final Canvas parent) { + if (display == null) SWT.error (SWT.ERROR_NULL_ARGUMENT); + if (parent == null) SWT.error (SWT.ERROR_NULL_ARGUMENT); + int /*long*/ handle = 0; + + try { + loadLibrary (); + handle = getAWTHandle (parent); + } catch (Throwable e) { + SWT.error (SWT.ERROR_NOT_IMPLEMENTED, e); } + if (handle == 0) SWT.error (SWT.ERROR_INVALID_ARGUMENT, null, " [peer not created]"); - /** - * Creates a new <code>Shell</code>. This Shell is the root for - * the SWT widgets that will be embedded within the AWT canvas. - * - * @param display the display for the new Shell - * @param parent the parent <code>java.awt.Canvas</code> of the new Shell - * @return a <code>Shell</code> to be the parent of the embedded SWT widgets - * - * @exception IllegalArgumentException <ul> - * <li>ERROR_NULL_ARGUMENT - if the display is null</li> - * <li>ERROR_NULL_ARGUMENT - if the parent is null</li> - * <li>ERROR_INVALID_ARGUMENT - if the parent's peer is not created</li> - * </ul> - * - * @since 3.0 - */ - public static Shell new_Shell(final Display display, final Canvas parent) { - if (display == null) SWT.error (SWT.ERROR_NULL_ARGUMENT); - if (parent == null) SWT.error (SWT.ERROR_NULL_ARGUMENT); - int /*long*/ handle = 0; - - try { - loadLibrary (); - handle = getAWTHandle (parent); - } catch (Throwable e) { - SWT.error (SWT.ERROR_NOT_IMPLEMENTED, e); + final Shell shell = Shell.cocoa_new (display, handle); + final ComponentListener listener = new ComponentAdapter () { + public void componentResized (ComponentEvent e) { + display.asyncExec (new Runnable () { + public void run () { + if (shell.isDisposed()) return; + Dimension dim = parent.getSize (); + shell.setSize (dim.width, dim.height); + } + }); } - if (handle == 0) SWT.error (SWT.ERROR_INVALID_ARGUMENT, null, " [peer not created]"); - - final Shell shell = Shell.cocoa_new (display, handle); - final ComponentListener listener = new ComponentAdapter () { - public void componentResized (ComponentEvent e) { - display.asyncExec (new Runnable () { - public void run () { - if (shell.isDisposed()) return; - Dimension dim = parent.getSize (); - shell.setSize (dim.width, dim.height); - } - }); - } - }; - parent.addComponentListener(listener); - shell.addListener(SWT.Dispose, new Listener() { - public void handleEvent(Event event) { - parent.removeComponentListener(listener); - } - }); - shell.setVisible (true); - return shell; - } + }; + parent.addComponentListener(listener); + shell.addListener(SWT.Dispose, new Listener() { + public void handleEvent(Event event) { + parent.removeComponentListener(listener); + } + }); + shell.setVisible (true); + return shell; +} }
\ No newline at end of file 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 0f439c79e2..c89cf209a6 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 @@ public class Accessible { * <li>ERROR_NULL_ARGUMENT - if the parent is null</li> * </ul> * + * @see #dispose * @see Control#getAccessible * * @since 3.6 @@ -234,10 +235,10 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { * * @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 bf6f4e76c4..1861d8f33e 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 @@ public class Accessible { * <li>ERROR_NULL_ARGUMENT - if the parent is null</li> * </ul> * + * @see #dispose * @see Control#getAccessible * * @since 3.6 @@ -239,10 +240,10 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { * * @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 df3ede136d..1c53ae2d68 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 @@ public class Accessible { * <li>ERROR_NULL_ARGUMENT - if the parent is null</li> * </ul> * + * @see #dispose * @see Control#getAccessible * * @since 3.6 @@ -233,10 +234,10 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { * * @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 8c2723ecc5..0e90d22a12 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 @@ public class Accessible { * <li>ERROR_NULL_ARGUMENT - if the parent is null</li> * </ul> * + * @see #dispose * @see Control#getAccessible * * @since 3.6 @@ -210,10 +211,10 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { /** * 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 @@ public class Accessible { * * @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 981acde037..a60d32fd5c 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 @@ protected void checkWidget () { } /** + * 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 @@ public TransferData[] getAvailableTypes() { } /** + * 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 7b12bbdbb9..9b0308b6c0 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 @@ static int unpackData(int[] handle, byte[] buffer, int offset) { * </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 c5a4310e98..8d345dfa60 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 @@ public static PrinterData getDefaultPrinterData() { * </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 00c30a80fb..a81e7eb85a 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 @@ static DeviceData checkNull (PrinterData data) { * </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 2e31cb3de2..c163bb2f62 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 @@ static DeviceData checkNull (PrinterData data) { * </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 83ac822497..5fcba9aa06 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 @@ static String[] getXPServerList() { * </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 c3cf7f5ced..7691964f1c 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 @@ public static PrinterData getDefaultPrinterData() { * </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 c3cf7f5ced..7691964f1c 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 @@ public static PrinterData getDefaultPrinterData() { * </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 07a49df176..64190fb4ef 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 @@ public void addFocusListener(FocusListener listener) { /** * 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 @@ public void addPaintListener(PaintListener listener) { * 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 @@ public void addPaintListener(PaintListener listener) { * * @see TouchListener * @see #removeTouchListener + * * @since 3.7 */ public void addTouchListener (TouchListener listener) { @@ -1080,8 +1083,11 @@ public boolean forceFocus () { /** * 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 @@ public Monitor getMonitor () { 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 @@ public void removeFocusListener(FocusListener listener) { /** * 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 @@ public void removeFocusListener(FocusListener listener) { * * @see GestureListener * @see #addGestureListener + * * @since 3.7 */ public void removeGestureListener (GestureListener listener) { @@ -3017,6 +3037,7 @@ void removeRelation () { * * @see TouchListener * @see #addTouchListener + * * @since 3.7 */ public void removeTouchListener(TouchListener listener) { @@ -3788,6 +3809,20 @@ public void setMenu (Menu menu) { 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 @@ public void setToolTipText (String 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/carbon/org/eclipse/swt/widgets/Display.java b/bundles/org.eclipse.swt/Eclipse SWT/carbon/org/eclipse/swt/widgets/Display.java index f50d98d4a0..1a599c10c8 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 @@ public Rectangle getClientArea () { * 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 @@ public int getDoubleClickTime () { * 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 @@ public Thread getThread () { /** * 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 2e69fb8f50..9e54430b50 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 @@ String getNameText () { 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 @@ public void setLocation (Point location) { 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 76370d0b64..f1b203fe91 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 @@ public String getText (int start, int end) { * <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 @@ public void setText (String string) { * <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 c2bd67b18e..ffaa881d5a 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 @@ void setVisible (boolean visible) { /** * 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 04970162ba..f0617605ff 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 @@ public void addFocusListener(FocusListener listener) { /** * 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 @@ void addTraits(NSMutableDictionary dict, Font font) { * 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 @@ void addTraits(NSMutableDictionary dict, Font font) { * * @see TouchListener * @see #removeTouchListener + * * @since 3.7 */ public void addTouchListener (TouchListener listener) { @@ -1485,8 +1488,11 @@ boolean gestureEvent(int /*long*/ id, int /*long*/ eventPtr, int detail) { /** * 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 @@ public Monitor getMonitor () { } /** + * 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 @@ public void removeFocusListener(FocusListener listener) { /** * 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 @@ public void removeFocusListener(FocusListener listener) { * * @see GestureListener * @see #addGestureListener + * * @since 3.7 */ public void removeGestureListener (GestureListener listener) { @@ -3162,6 +3179,7 @@ void removeRelation () { * * @see TouchListener * @see #addTouchListener + * * @since 3.7 */ public void removeTouchListener(TouchListener listener) { @@ -3849,7 +3867,17 @@ public void setMenu (Menu menu) { } /** - * @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 @@ public void setToolTipText (String 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/cocoa/org/eclipse/swt/widgets/Display.java b/bundles/org.eclipse.swt/Eclipse SWT/cocoa/org/eclipse/swt/widgets/Display.java index 346760c10f..398a34fe8b 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 @@ public Rectangle getClientArea () { * 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 @@ public int getDoubleClickTime () { * 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 @@ public Thread getThread () { /** * 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 828b65bd35..60ecde28f7 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 @@ String getNameText () { 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 @@ public void setLocation (Point location) { 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 9579f7a18c..f3a5e06fe0 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 @@ int /*long*/ fontHandle () { 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 @@ void forceResize () { /** * 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 @@ public void addFocusListener(FocusListener listener) { /** * 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 @@ void addRelation (Control control) { * 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 @@ void addRelation (Control control) { * * @see TouchListener * @see #removeTouchListener + * * @since 3.7 */ public void addTouchListener (TouchListener listener) { @@ -1786,7 +1805,7 @@ public void removeFocusListener(FocusListener listener) { } /** * 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 @@ public void removeFocusListener(FocusListener listener) { * * @see GestureListener * @see #addGestureListener + * * @since 3.7 */ public void removeGestureListener (GestureListener listener) { @@ -2033,6 +2053,7 @@ void removeRelation () { * * @see TouchListener * @see #addTouchListener + * * @since 3.7 */ public void removeTouchListener(TouchListener listener) { @@ -4062,6 +4083,20 @@ void setOrientation (boolean create) { } } +/** + * 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 @@ void setToolTipText (Shell shell, String newString) { } /** - * 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 286425294e..481990aa23 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 @@ int getCaretBlinkTime () { * 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 @@ public int getDoubleClickTime () { * 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 @@ public Thread getThread () { /** * 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 163df876e5..2cc30e37f6 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 @@ String getNameText () { 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 @@ public void setLocation (Point location) { 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 95419a7079..bd44119c38 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 @@ public String getText (int start, int end) { * <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 @@ public void setText (String string) { * <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 90f58b5b16..72122a4592 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 @@ void setToolTipText (Shell shell, String newString) { /** * 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 f9b9ee1947..2406edea94 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 @@ public void addFocusListener(FocusListener listener) { /** * 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 @@ public void addPaintListener(PaintListener listener) { * 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 @@ public void addPaintListener(PaintListener listener) { * * @see TouchListener * @see #removeTouchListener + * * @since 3.7 */ public void addTouchListener (TouchListener listener) { @@ -865,8 +868,11 @@ public boolean forceFocus () { /** * 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 @@ int getNavigationType () { 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 @@ public void removeFocusListener(FocusListener listener) { } /** * 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 @@ public void removeFocusListener(FocusListener listener) { * * @see GestureListener * @see #addGestureListener + * * @since 3.7 */ public void removeGestureListener (GestureListener listener) { @@ -2240,6 +2260,7 @@ public void removePaintListener(PaintListener listener) { * * @see TouchListener * @see #addTouchListener + * * @since 3.7 */ public void removeTouchListener(TouchListener listener) { @@ -2903,6 +2924,20 @@ public void setMenu (Menu menu) { 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 @@ public void setToolTipText (String string) { 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 5ffa624fe4..e934028ebc 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 @@ int getCaretBlinkTime () { * 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 @@ public int getDoubleClickTime () { * 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 @@ public Thread getThread () { /** * 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 5b4fd26cf8..e1957d2ef9 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 @@ String getNameText () { 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 @@ public void setLocation (Point location) { 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 6269586881..dcf0402e95 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 @@ public String getText (int start, int end) { * <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 @@ public void setText (String string) { * <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 3acbc239c6..1844c6db93 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 @@ void setVisible (boolean visible) { /** * 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 1b8805a6b3..7fc70cf2e3 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 @@ public void addFocusListener (FocusListener listener) { /** * 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 @@ public void addPaintListener (PaintListener listener) { * 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 @@ public void addPaintListener (PaintListener listener) { * * @see TouchListener * @see #removeTouchListener + * * @since 3.7 */ public void addTouchListener (TouchListener listener) { @@ -820,8 +823,11 @@ void enableWidget (boolean enabled) { /** * 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 @@ public Monitor getMonitor () { } /** + * 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 @@ public void removeFocusListener(FocusListener listener) { /** * 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 @@ public void removeFocusListener(FocusListener listener) { * * @see GestureListener * @see #addGestureListener + * * @since 3.7 */ public void removeGestureListener (GestureListener listener) { @@ -2391,6 +2416,7 @@ public void removePaintListener(PaintListener listener) { * * @see TouchListener * @see #addTouchListener + * * @since 3.7 */ public void removeTouchListener(TouchListener listener) { @@ -2895,6 +2921,24 @@ public void setMenu (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 (); +} + +/** * 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 @@ public void setSize (int width, int height) { } /** - * 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 0a848eb693..90e38b2967 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 @@ public Shell getActiveShell () { * 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 @@ public int getDoubleClickTime () { * 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 @@ public Thread getThread () { /** * 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 c54ba7b0b3..caa3c4f915 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 @@ String getNameText () { } /** + * 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 @@ public void setLocation (Point location) { } /** + * 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 9a7d1adbb0..846c272cc5 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 @@ public String getText (int start, int end) { * <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 @@ public void setText (String string) { * <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 74ea3c3991..4afb3d044c 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 @@ public void setToolTipText (String string) { /** * 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 bfceaad59a..530535f1c7 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 @@ int defaultBackground () { 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 d119470b39..e01421f0c6 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 @@ public void addFocusListener (FocusListener listener) { /** * 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 @@ public void addPaintListener (PaintListener listener) { * 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 @@ public void addPaintListener (PaintListener listener) { * * @see TouchListener * @see #removeTouchListener + * * @since 3.7 */ public void addTouchListener (TouchListener listener) { @@ -905,8 +908,11 @@ public boolean forceFocus () { /** * 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 @@ public Monitor getMonitor () { } /** + * 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 @@ public void removeFocusListener(FocusListener listener) { /** * 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 @@ public void removeFocusListener(FocusListener listener) { * * @see GestureListener * @see #addGestureListener + * * @since 3.7 */ public void removeGestureListener (GestureListener listener) { @@ -2462,6 +2487,7 @@ public void removePaintListener(PaintListener listener) { * * @see TouchListener * @see #addTouchListener + * * @since 3.7 */ public void removeTouchListener(TouchListener listener) { @@ -3276,18 +3302,15 @@ public void setTransform (Transform t) { } /** - * 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 @@ int widgetParent () { } /** + * 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 7f659dc92a..9f31160e55 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 @@ public class Display extends Device { Shell [] shells; + static String APP_NAME = "SWT"; + static String APP_VERSION = ""; //$NON-NLS-1$ + /* Key Mappings */ static final int [] [] KeyTable = { @@ -1039,7 +1042,7 @@ Widget getWidget (int handle) { * 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 @@ public int getDoubleClickTime () { * 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 @@ public Thread getThread () { /** * 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 @@ public void setData (Object data) { } /** + * 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 @@ public void setData (Object data) { * @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 5130e87dec..d7fc61cd6d 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 @@ String getNameText () { } /** + * 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 @@ void setNameScope() { } /** + * 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 19bc1913b5..a1c1c41232 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 @@ public String getText (int start, int end) { * <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 @@ public void setText (String string) { * <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 203dba1a30..ca7b0597ab 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 @@ public void setToolTipText (String string) { /** * 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> |