Mercurial > projects > dwt-linux
changeset 259:c0d810de7093
Update SWT 3.4M7 to 3.4
line wrap: on
line diff
--- a/dwt/DWT.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/DWT.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -69,6 +69,8 @@ * <em>HINT</em> may change from release to release, although we typically * will not withdraw support for a <em>HINT</em> once it is made available. * </p> + * + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ /* NOTE: @@ -443,7 +445,9 @@ * @see dwt.widgets.Display#addFilter * @see dwt.widgets.Event * + * @see dwt.custom.CCombo#addVerifyListener * @see dwt.widgets.Combo#addVerifyListener + * @see dwt.custom.StyledText#addVerifyListener * @see dwt.widgets.Text#addVerifyListener * @see dwt.events.VerifyListener#verifyText * @see dwt.events.VerifyEvent
--- a/dwt/DWTError.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/DWTError.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2005 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -43,6 +43,7 @@ * * @see DWTException * @see DWT#error(int) + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class DWTError : PlatformException {
--- a/dwt/DWTException.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/DWTException.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2005 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -34,6 +34,7 @@ * </p> * * @see DWTError + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class DWTException : Exception {
--- a/dwt/accessibility/ACC.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/accessibility/ACC.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2004 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -17,6 +17,8 @@ * Class ACC contains all the constants used in defining an * Accessible object. * + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> + * * @since 2.0 */ public class ACC {
--- a/dwt/accessibility/Accessible.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/accessibility/Accessible.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2005 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -45,6 +45,8 @@ * @see AccessibleEvent * @see AccessibleControlListener * @see AccessibleControlEvent + * @see <a href="http://www.eclipse.org/swt/snippets/#accessibility">Accessibility snippets</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> * * @since 2.0 */
--- a/dwt/accessibility/AccessibleAdapter.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/accessibility/AccessibleAdapter.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -31,6 +31,7 @@ * * @see AccessibleListener * @see AccessibleEvent + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> * * @since 2.0 */
--- a/dwt/accessibility/AccessibleControlAdapter.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/accessibility/AccessibleControlAdapter.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -37,6 +37,7 @@ * * @see AccessibleControlListener * @see AccessibleControlEvent + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> * * @since 2.0 */
--- a/dwt/accessibility/AccessibleControlEvent.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/accessibility/AccessibleControlEvent.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2004 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -32,6 +32,7 @@ * * @see AccessibleControlListener * @see AccessibleControlAdapter + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> * * @since 2.0 */
--- a/dwt/accessibility/AccessibleEvent.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/accessibility/AccessibleEvent.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2004 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -29,6 +29,7 @@ * * @see AccessibleListener * @see AccessibleAdapter + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> * * @since 2.0 */
--- a/dwt/accessibility/AccessibleFactory.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/accessibility/AccessibleFactory.d Sun Jun 29 14:33:38 2008 +0200 @@ -167,7 +167,7 @@ listeners [i].getRole (event); } bool action = false, hypertext = false, selection = false, text = false; - if (event.detail !is 0) { /* a role was specified */ + if (event.detail !is 0) { /* a role was specified */ for (int i = 0; i < actionRoles.length; i++) { if (event.detail is actionRoles [i]) { action = true;
--- a/dwt/accessibility/AccessibleTextAdapter.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/accessibility/AccessibleTextAdapter.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -37,6 +37,7 @@ * * @see AccessibleTextListener * @see AccessibleTextEvent + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> * * @since 3.0 */
--- a/dwt/accessibility/AccessibleTextEvent.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/accessibility/AccessibleTextEvent.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2004 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -31,6 +31,7 @@ * * @see AccessibleTextListener * @see AccessibleTextAdapter + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> * * @since 3.0 */
--- a/dwt/custom/AnimatedProgress.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/custom/AnimatedProgress.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2004 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -38,6 +38,8 @@ * <dl> * <dt><b>Styles:</b><dd>VERTICAL, HORIZONTAL, BORDER * </dl> + * + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class AnimatedProgress : Canvas {
--- a/dwt/custom/BidiSegmentEvent.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/custom/BidiSegmentEvent.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2005 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -61,6 +61,8 @@ * "R4R5R6". * visual line = "R3R2R1" + "R6R5R4" * </pre> + * + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class BidiSegmentEvent : TypedEvent {
--- a/dwt/custom/Bullet.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/custom/Bullet.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -34,18 +34,39 @@ * </p> * * @see StyledText#setLineBullet(int, int, Bullet) + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> * * @since 3.2 */ public class Bullet { + /** + * The bullet type. Possible values are: + * <ul> + * <li><code>ST.BULLET_DOT</code></li> + * <li><code>ST.BULLET_NUMBER</code></li> + * <li><code>ST.BULLET_LETTER_LOWER</code></li> + * <li><code>ST.BULLET_LETTER_UPPER</code></li> + * <li><code>ST.BULLET_TEXT</code></li> + * <li><code>ST.BULLET_CUSTOM</code></li> + * </ul> + */ public int type; + + /** + * The bullet style. + */ public StyleRange style; + + /** + * The bullet text. + */ public String text; + int[] linesIndices; int count; /** - * Create a new bullet the specified style, the type is set to ST.BULLET_DOT. + * Create a new bullet with the specified style, and type <code>ST.BULLET_DOT</code>. * The style must have a glyph metrics set. * * @param style the style @@ -61,6 +82,7 @@ * Create a new bullet the specified style and type. * The style must have a glyph metrics set. * + * @param type the bullet type * @param style the style * * @exception IllegalArgumentException <ul>
--- a/dwt/custom/BusyIndicator.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/custom/BusyIndicator.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -23,6 +23,9 @@ /** * Support for showing a Busy Cursor during a long running process. + * + * @see <a href="http://www.eclipse.org/swt/snippets/#busyindicator">BusyIndicator snippets</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class BusyIndicator {
--- a/dwt/custom/CBanner.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/custom/CBanner.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -53,6 +53,8 @@ * IMPORTANT: This class is <em>not</em> intended to be subclassed. * </p> * + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> + * * @since 3.0 */
--- a/dwt/custom/CCombo.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/custom/CCombo.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -76,6 +76,10 @@ * <dt><b>Events:</b> * <dd>DefaultSelection, Modify, Selection, Verify</dd> * </dl> + * + * @see <a href="http://www.eclipse.org/swt/snippets/#ccombo">CCombo snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: CustomControlExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public final class CCombo : Composite { @@ -528,7 +532,7 @@ list.deselectAll (); } void dropDown (bool drop) { - if (drop is isDropped ()) return; + if (drop is isDropped () || !isVisible()) return; if (!drop) { popup.setVisible (false); if (!isDisposed () && isFocusControl()) { @@ -1575,7 +1579,9 @@ * If so then do not continue. */ if (isDisposed ()) return; - if (!visible) popup.setVisible(false); + // TEMPORARY CODE + if (popup is null || popup.isDisposed ()) return; + if (!visible) popup.setVisible (false); } /** * Sets the number of items that are visible in the drop
--- a/dwt/custom/CLabel.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/custom/CLabel.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -65,6 +65,9 @@ * </p><p> * IMPORTANT: This class is <em>not</em> intended to be subclassed. * </p> + * + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: CustomControlExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class CLabel : Canvas {
--- a/dwt/custom/CTabFolder.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/custom/CTabFolder.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -78,6 +78,10 @@ * </p><p> * IMPORTANT: This class is <em>not</em> intended to be subclassed. * </p> + * + * @see <a href="http://www.eclipse.org/swt/snippets/#ctabfolder">CTabFolder, CTabItem snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: CustomControlExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class CTabFolder : Composite { @@ -2397,7 +2401,7 @@ /** * Removes the listener. * - * @param listener the listener + * @param listener the listener which should no longer be notified * * @exception IllegalArgumentException <ul> * <li>ERROR_NULL_ARGUMENT - if the listener is null</li> @@ -2436,7 +2440,7 @@ /** * Removes the listener. * - * @param listener the listener + * @param listener the listener which should no longer be notified * * @exception IllegalArgumentException <ul> * <li>ERROR_NULL_ARGUMENT - if the listener is null</li> @@ -3234,7 +3238,7 @@ * @param item the tab item to be selected * * @exception IllegalArgumentException <ul> - * <li>ERROR_NULL_ARGUMENT - if the listener is null</li> + * <li>ERROR_NULL_ARGUMENT - if the item is null</li> * </ul> * * @exception DWTException <ul>
--- a/dwt/custom/CTabFolder2Adapter.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/custom/CTabFolder2Adapter.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2004 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -25,6 +25,7 @@ * * @see CTabFolder2Listener * @see CTabFolderEvent + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> * * @since 3.0 */
--- a/dwt/custom/CTabFolderAdapter.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/custom/CTabFolderAdapter.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2004 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -15,6 +15,14 @@ import dwt.custom.CTabFolderListener; +/** + * This adapter class provides a default implementation for the + * method described by the <code>CTabFolderListener</code> interface. + * + * @see CTabFolderListener + * @see CTabFolderEvent + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> + */ public class CTabFolderAdapter : CTabFolderListener { public void itemClosed(CTabFolderEvent event){} }
--- a/dwt/custom/CTabFolderEvent.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/custom/CTabFolderEvent.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -22,7 +22,9 @@ import tango.util.Convert; /** + * This event is sent when an event is generated in the CTabFolder. * + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class CTabFolderEvent : TypedEvent { /**
--- a/dwt/custom/CTabItem.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/custom/CTabItem.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -45,6 +45,9 @@ * <p> * IMPORTANT: This class is <em>not</em> intended to be subclassed. * </p> + * + * @see <a href="http://www.eclipse.org/swt/snippets/#ctabfolder">CTabFolder, CTabItem snippets</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class CTabItem : Item { CTabFolder parent;
--- a/dwt/custom/ControlEditor.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/custom/ControlEditor.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -66,6 +66,8 @@ * editor.minimumHeight = size.y; * editor.setEditor (button); * </pre></code> +* +* @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class ControlEditor {
--- a/dwt/custom/DefaultContent.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/custom/DefaultContent.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -733,7 +733,8 @@ * Removes the specified <code>TextChangeListener</code>. * <p> * - * @param listener the listener + * @param listener the listener which should no longer be notified + * * @exception IllegalArgumentException <ul> * <li>ERROR_NULL_ARGUMENT when listener is null</li> * </ul>
--- a/dwt/custom/ExtendedModifyEvent.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/custom/ExtendedModifyEvent.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2004 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -19,6 +19,8 @@ /** * This event is sent after a text change occurs. + * + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public final class ExtendedModifyEvent : TypedEvent { /** start offset of the new text */ @@ -30,6 +32,12 @@ static final long serialVersionUID = 3258696507027830832L; +/** + * Constructs a new instance of this class based on the + * information in the given event. + * + * @param e the event containing the information + */ public this(StyledTextEvent e) { super(cast(Object)e); start = e.start;
--- a/dwt/custom/ExtendedModifyListener.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/custom/ExtendedModifyListener.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2005 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -15,7 +15,16 @@ import dwt.internal.DWTEventListener; import dwt.custom.ExtendedModifyEvent; +/** + * Classes which implement this interface provide a method + * that deals with the event that is generated when text + * is modified. + * + * @see ExtendedModifyEvent + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> + */ public interface ExtendedModifyListener : DWTEventListener { + /** * This method is called after a text change occurs. * <p>
--- a/dwt/custom/LineBackgroundEvent.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/custom/LineBackgroundEvent.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2005 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -21,6 +21,8 @@ /** * This event is sent when a line is about to be drawn. + * + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class LineBackgroundEvent : TypedEvent { @@ -41,6 +43,12 @@ static final long serialVersionUID = 3978711687853324342L; +/** + * Constructs a new instance of this class based on the + * information in the given event. + * + * @param e the event containing the information + */ public this(StyledTextEvent e) { super(cast(Object)e); lineOffset = e.detail;
--- a/dwt/custom/LineBackgroundListener.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/custom/LineBackgroundListener.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2005 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -15,6 +15,14 @@ import dwt.internal.DWTEventListener; import dwt.custom.LineBackgroundEvent; +/** + * Classes which implement this interface provide a method + * that can provide the background color for a line that + * is to be drawn. + * + * @see LineBackgroundEvent + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> + */ public interface LineBackgroundListener : DWTEventListener { /**
--- a/dwt/custom/LineStyleEvent.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/custom/LineStyleEvent.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -21,6 +21,8 @@ /** * This event is sent when a line is about to be drawn. + * + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class LineStyleEvent : TypedEvent { @@ -87,6 +89,12 @@ static final long serialVersionUID = 3906081274027192884L; +/** + * Constructs a new instance of this class based on the + * information in the given event. + * + * @param e the event containing the information + */ public this(StyledTextEvent e) { super(cast(Object)e); styles = e.styles;
--- a/dwt/custom/LineStyleListener.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/custom/LineStyleListener.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2005 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -15,7 +15,16 @@ import dwt.internal.DWTEventListener; import dwt.custom.LineStyleEvent; +/** + * Classes which implement this interface provide a method + * that can provide the style information for a line that + * is to be drawn. + * + * @see LineStyleEvent + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> + */ public interface LineStyleListener : DWTEventListener { + /** * This method is called when a line is about to be drawn in order to get the * line's style information.
--- a/dwt/custom/MovementEvent.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/custom/MovementEvent.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -21,6 +21,8 @@ * This event is sent when a new offset is required based on the current * offset and a movement type. * + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> + * * @since 3.3 */ public class MovementEvent : TypedEvent { @@ -58,6 +60,12 @@ static final long serialVersionUID = 3978765487853324342L; +/** + * Constructs a new instance of this class based on the + * information in the given event. + * + * @param e the event containing the information + */ public this(StyledTextEvent e) { super(cast(Object)e); lineOffset = e.detail;
--- a/dwt/custom/PaintObjectEvent.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/custom/PaintObjectEvent.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -22,6 +22,8 @@ /** * This event is sent when an object needs to be drawn. * + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> + * * @since 3.2 */ public class PaintObjectEvent : TypedEvent { @@ -68,6 +70,12 @@ static final long serialVersionUID = 3906081274027192855L; +/** + * Constructs a new instance of this class based on the + * information in the given event. + * + * @param e the event containing the information + */ public this(StyledTextEvent e) { super(cast(Object)e); gc = e.gc;
--- a/dwt/custom/PopupList.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/custom/PopupList.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -31,6 +31,7 @@ import dwt.widgets.List; import dwt.widgets.Listener; import dwt.widgets.Shell; + /** * A PopupList is a list of selectable items that appears in its own shell positioned above * its parent shell. It is used for selecting items when editing a Table cell (similar to the @@ -39,6 +40,8 @@ * The list will be positioned so that it does not run off the screen and the largest number of items * are visible. It may appear above the current cursor location or below it depending how close you * are to the edge of the screen. +* +* @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class PopupList { Shell shell;
--- a/dwt/custom/ST.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/custom/ST.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -15,6 +15,8 @@ /** * This class provides access to the public constants provided by <code>StyledText</code>. + * + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class ST {
--- a/dwt/custom/SashForm.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/custom/SashForm.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -40,9 +40,16 @@ * <dd>HORIZONTAL, VERTICAL, SMOOTH</dd> * </dl> * </p> + * + * @see <a href="http://www.eclipse.org/swt/snippets/#sashform">SashForm snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: CustomControlExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class SashForm : Composite { + /** + * The width of all sashes in the form. + */ public int SASH_WIDTH = 3; int sashStyle;
--- a/dwt/custom/ScrolledComposite.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/custom/ScrolledComposite.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -113,6 +113,9 @@ * <dl> * <dt><b>Styles:</b><dd>H_SCROLL, V_SCROLL * </dl> + * + * @see <a href="http://www.eclipse.org/swt/snippets/#scrolledcomposite">ScrolledComposite snippets</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class ScrolledComposite : Composite { @@ -313,6 +316,8 @@ * Returns <code>true</code> if the receiver automatically scrolls to a focused child control * to make it visible. Otherwise, returns <code>false</code>. * + * @return a bool indicating whether focused child controls are automatically scrolled into the viewport + * * @exception DWTException <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> @@ -648,7 +653,7 @@ * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> * - * @since 3.4 + * @since 3.4 */ public void setShowFocusedControl(bool show) { checkWidget();
--- a/dwt/custom/StackLayout.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/custom/StackLayout.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -71,6 +71,10 @@ * } * } * </code></pre> + * + * @see <a href="http://www.eclipse.org/swt/snippets/#stacklayout">StackLayout snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: LayoutExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class StackLayout : Layout {
--- a/dwt/custom/StyleRange.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/custom/StyleRange.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -26,6 +26,18 @@ static import tango.text.Text; alias tango.text.Text.Text!(char) StringBuffer; +/** + * <code>StyleRange</code> defines a set of styles for a specified + * range of text. + * <p> + * The hashCode() method in this class uses the values of the public + * fields to compute the hash value. When storing instances of the + * class in hashed collections, do not modify these fields after the + * object has been inserted. + * </p> + * + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> + */ public class StyleRange : TextStyle, CloneableCompatibility { /** @@ -67,9 +79,9 @@ /** * Create a new style range from an existing text style. * - *@param style the text style to copy + * @param style the text style to copy * - *@since 3.4 + * @since 3.4 */ public this(TextStyle style) { super(style);
--- a/dwt/custom/StyledText.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/custom/StyledText.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -143,6 +143,10 @@ * </p><p> * IMPORTANT: This class is <em>not</em> intended to be subclassed. * </p> + * + * @see <a href="http://www.eclipse.org/swt/snippets/#styledtext">StyledText snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Examples: CustomControlExample, TextEditor</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class StyledText : Canvas { alias Canvas.computeSize computeSize; @@ -196,8 +200,8 @@ Point doubleClickSelection; // selection after last mouse double click bool editable = true; bool wordWrap = false; - bool doubleClickEnabled = true; // see getDoubleClickEnabled - bool overwrite = false; // insert/overwrite edit mode + bool doubleClickEnabled = true; // see getDoubleClickEnabled + bool overwrite = false; // insert/overwrite edit mode int textLimit = -1; // limits the number of characters the user can type in the widget. Unlimited by default. int[int] keyActionMap; Color background = null; // workaround for bug 4791 @@ -213,7 +217,7 @@ int lastTextChangeReplaceCharCount; int lastLineBottom; // the bottom pixel of the last line been replaced bool isMirrored_; - bool bidiColoring = false; // apply the BIDI algorithm on text segments of the same color + bool bidiColoring = false; // apply the BIDI algorithm on text segments of the same color Image leftCaretBitmap = null; Image rightCaretBitmap = null; int caretDirection = DWT.NULL; @@ -262,9 +266,9 @@ int endPage; // last page to print int startLine; // first (wrapped) line to print int endLine; // last (wrapped) line to print - bool singleLine; // widget single line mode + bool singleLine; // widget single line mode Point selection = null; // selected text - bool mirrored; // indicates the printing gc should be mirrored + bool mirrored; // indicates the printing gc should be mirrored int lineSpacing; int printMargin; @@ -3819,6 +3823,8 @@ * lineIndex is lineCount it returns the bottom pixel of the last line. * It means this function can be used to retrieve the bottom pixel of any line. * + * @return the top pixel of a given line index + * * @since 3.2 */ public int getLinePixel(int lineIndex) { @@ -3845,6 +3851,10 @@ /** * Returns the line index for a y, relative to the client area. * The line index returned is always in the range 0..lineCount - 1. + * + * @param y the y-coordinate pixel + * + * @return the line index for a given y-coordinate pixel * * @since 3.2 */ @@ -5121,13 +5131,14 @@ int length = text.length; if (length is ime.getCommitCount()) { content.replaceTextRange(start, end - start, ""); - caretOffset = start; + caretOffset = ime.getCompositionOffset(); caretWidth = 0; caretDirection = DWT.NULL; } else { content.replaceTextRange(start, end - start, text); caretOffset = ime.getCaretOffset(); if (ime.getWideCaret()) { + start = ime.getCompositionOffset(); int lineIndex = getCaretLine(); int lineOffset = content.getOffsetAtLine(lineIndex); TextLayout layout = renderer.getTextLayout(lineIndex); @@ -5511,7 +5522,6 @@ int newLastLineBottom = getLinePixel(lastLine + 1); if (lastLineBottom !is newLastLineBottom) { super.redraw(); - if (wordWrap) setCaretLocation(); } else { super.redraw(0, firstLineTop, clientAreaWidth, newLastLineBottom - firstLineTop, false); redrawLinesBullet(renderer.redrawLines); @@ -6058,6 +6068,9 @@ * </p> * * @param printer the printer to print to + * + * @return a <code>Runnable</code> for printing the receiver's text + * * @exception DWTException <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> @@ -6087,6 +6100,9 @@ * * @param printer the printer to print to * @param options print options to use during printing + * + * @return a <code>Runnable</code> for printing the receiver's text + * * @exception DWTException <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> @@ -6245,7 +6261,8 @@ /** * Removes the specified bidirectional segment listener. * - * @param listener the listener + * @param listener the listener which should no longer be notified + * * @exception DWTException <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> @@ -6253,6 +6270,7 @@ * @exception IllegalArgumentException <ul> * <li>ERROR_NULL_ARGUMENT when listener is null</li> * </ul> + * * @since 2.0 */ public void removeBidiSegmentListener(BidiSegmentListener listener) { @@ -6263,7 +6281,8 @@ /** * Removes the specified extended modify listener. * - * @param extendedModifyListener the listener + * @param extendedModifyListener the listener which should no longer be notified + * * @exception DWTException <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> @@ -6280,7 +6299,8 @@ /** * Removes the specified line background listener. * - * @param listener the listener + * @param listener the listener which should no longer be notified + * * @exception DWTException <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> @@ -6297,7 +6317,8 @@ /** * Removes the specified line style listener. * - * @param listener the listener + * @param listener the listener which should no longer be notified + * * @exception DWTException <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> @@ -6314,7 +6335,8 @@ /** * Removes the specified modify listener. * - * @param modifyListener the listener + * @param modifyListener the listener which should no longer be notified + * * @exception DWTException <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> @@ -6331,7 +6353,8 @@ /** * Removes the specified listener. * - * @param listener the listener + * @param listener the listener which should no longer be notified + * * @exception DWTException <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> @@ -6371,7 +6394,8 @@ /** * Removes the specified verify listener. * - * @param verifyListener the listener + * @param verifyListener the listener which should no longer be notified + * * @exception DWTException <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> @@ -6388,7 +6412,8 @@ /** * Removes the specified key verify listener. * - * @param listener the listener + * @param listener the listener which should no longer be notified + * * @exception DWTException <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> @@ -6404,7 +6429,8 @@ /** * Removes the specified word movement listener. * - * @param listener the listener + * @param listener the listener which should no longer be notified + * * @exception DWTException <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> @@ -7102,9 +7128,6 @@ setCaretLocation(); super.redraw(); } -/** - * @see dwt.widgets.Control#setForeground - */ public override void setForeground(Color color) { checkWidget(); foreground = color; @@ -8397,6 +8420,7 @@ void updateSelection(int startOffset, int replacedLength, int newLength) { if (selection.y <= startOffset) { // selection ends before text change + if (wordWrap) setCaretLocation(); return; } if (selection.x < startOffset) {
--- a/dwt/custom/StyledTextContent.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/custom/StyledTextContent.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -142,7 +142,8 @@ * Remove the specified text changed listener. * <p> * - * @param listener the listener + * @param listener the listener which should no longer be notified + * * @exception IllegalArgumentException <ul> * <li>ERROR_NULL_ARGUMENT when listener is null</li> * </ul>
--- a/dwt/custom/StyledTextDropTargetEffect.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/custom/StyledTextDropTargetEffect.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -57,6 +57,7 @@ * * @see DropTargetAdapter * @see DropTargetEvent + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> * * @since 3.3 */
--- a/dwt/custom/StyledTextListener.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/custom/StyledTextListener.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -46,6 +46,8 @@ } /** * Process StyledText events by invoking the event's handler. + * + * @param e the event to handle */ public override void handleEvent(Event e) {
--- a/dwt/custom/StyledTextPrintOptions.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/custom/StyledTextPrintOptions.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -31,6 +31,9 @@ * Runnable runnable = styledText.print(new Printer(), options); * runnable.run(); * </pre> + * + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> + * * @since 2.1 */ public class StyledTextPrintOptions {
--- a/dwt/custom/StyledTextRenderer.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/custom/StyledTextRenderer.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at
--- a/dwt/custom/TableCursor.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/custom/TableCursor.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -151,6 +151,8 @@ * * @since 2.0 * + * @see <a href="http://www.eclipse.org/swt/snippets/#tablecursor">TableCursor snippets</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class TableCursor : Canvas {
--- a/dwt/custom/TableEditor.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/custom/TableEditor.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -81,6 +81,9 @@ * } * }); * </pre></code> +* +* @see <a href="http://www.eclipse.org/swt/snippets/#tableeditor">TableEditor snippets</a> +* @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class TableEditor : ControlEditor { Table table; @@ -230,6 +233,11 @@ tableColumn.addControlListener(columnListener); resize(); } +/** +* Specifies the <code>TableItem</code> that is to be edited. +* +* @param item the item to be edited +*/ public void setItem (TableItem item) { this.item = item; resize();
--- a/dwt/custom/TableTreeItem.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/custom/TableTreeItem.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at
--- a/dwt/custom/TextChangedEvent.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/custom/TextChangedEvent.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2004 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -17,6 +17,8 @@ /** * This event is sent by the StyledTextContent implementor when a change to * the text occurs. + * + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class TextChangedEvent : TypedEvent {
--- a/dwt/custom/TextChangingEvent.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/custom/TextChangingEvent.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2004 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -22,6 +22,8 @@ /** * This event is sent by the StyledTextContent implementor when a change * to the text is about to occur. + * + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class TextChangingEvent : TypedEvent { /**
--- a/dwt/custom/TreeEditor.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/custom/TreeEditor.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -79,6 +79,9 @@ * } * }); * </pre></code> +* +* @see <a href="http://www.eclipse.org/swt/snippets/#treeeditor">TreeEditor snippets</a> +* @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class TreeEditor : ControlEditor { @@ -275,6 +278,11 @@ resize(); } +/** +* Specifies the <code>TreeItem</code> that is to be edited. +* +* @param item the item to be edited +*/ public void setItem (TreeItem item) { this.item = item; resize();
--- a/dwt/custom/VerifyKeyListener.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/custom/VerifyKeyListener.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2005 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -16,6 +16,14 @@ import dwt.events.VerifyEvent; import dwt.internal.DWTEventListener; +/** + * Classes which implement this interface provide a method + * that deals with the event that is generated when a + * key is pressed. + * + * @see VerifyEvent + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> + */ public interface VerifyKeyListener : DWTEventListener { /** * The following event fields are used:<ul>
--- a/dwt/custom/ViewForm.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/custom/ViewForm.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -48,6 +48,8 @@ * <p> * IMPORTANT: This class is <em>not</em> intended to be subclassed. * </p> + * + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class ViewForm : Composite {
--- a/dwt/dnd/ByteArrayTransfer.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/dnd/ByteArrayTransfer.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -21,8 +21,7 @@ /** * The class <code>ByteArrayTransfer</code> provides a platform specific * mechanism for converting a java <code>byte[]</code> to a platform - * specific representation of the byte array and vice versa. See - * <code>Transfer</code> for additional information. + * specific representation of the byte array and vice versa. * * <p><code>ByteArrayTransfer</code> is never used directly but is sub-classed * by transfer agents that convert between data in a java format such as a @@ -121,6 +120,8 @@ * } * } * </code></pre> + * + * @see Transfer */ public abstract class ByteArrayTransfer : Transfer { @@ -145,14 +146,13 @@ /** * This implementation of <code>javaToNative</code> converts a java - * <code>byte[]</code> to a platform specific representation. For additional - * information see <code>Transfer#javaToNative</code>. - * - * @see Transfer#javaToNative - * + * <code>byte[]</code> to a platform specific representation. + * * @param object a java <code>byte[]</code> containing the data to be converted - * @param transferData an empty <code>TransferData</code> object; this - * object will be filled in on return with the platform specific format of the data + * @param transferData an empty <code>TransferData</code> object that will + * be filled in on return with the platform specific format of the data + * + * @see Transfer#nativeToJava */ protected override void javaToNative (Object object, TransferData transferData) { transferData.result = 0; @@ -173,14 +173,12 @@ /** * This implementation of <code>nativeToJava</code> converts a platform specific * representation of a byte array to a java <code>byte[]</code>. - * For additional information see <code>Transfer#nativeToJava</code>. - * - * @see Transfer#nativeToJava * - * @param transferData the platform specific representation of the data to be - * been converted - * @return a java <code>byte[]</code> containing the converted data if the - * conversion was successful; otherwise null + * @param transferData the platform specific representation of the data to be converted + * @return a java <code>byte[]</code> containing the converted data if the conversion was + * successful; otherwise null + * + * @see Transfer#javaToNative */ protected override Object nativeToJava(TransferData transferData) { if ( !isSupportedType(transferData) || transferData.pValue is null) return null;
--- a/dwt/dnd/Clipboard.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/dnd/Clipboard.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -35,6 +35,10 @@ * application to another or within an application. * * <p>IMPORTANT: This class is <em>not</em> intended to be subclassed.</p> + * + * @see <a href="http://www.eclipse.org/swt/snippets/#clipboard">Clipboard snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: ClipboardExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class Clipboard {
--- a/dwt/dnd/DND.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/dnd/DND.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -26,6 +26,7 @@ * Class DND contains all the constants used in defining a * DragSource or a DropTarget. * + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class DND {
--- a/dwt/dnd/DragSource.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/dnd/DragSource.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -115,6 +115,10 @@ * <dt><b>Styles</b></dt> <dd>DND.DROP_NONE, DND.DROP_COPY, DND.DROP_MOVE, DND.DROP_LINK</dd> * <dt><b>Events</b></dt> <dd>DND.DragStart, DND.DragSetData, DND.DragEnd</dd> * </dl> + * + * @see <a href="http://www.eclipse.org/swt/snippets/#dnd">Drag and Drop snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: DNDExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class DragSource : Widget { @@ -295,6 +299,7 @@ * </ul> * * @see DragSourceListener + * @see #getDragListeners * @see #removeDragListener * @see DragSourceEvent */ @@ -435,6 +440,9 @@ * operation is in progress, by sending it one of the messages defined in * the <code>DragSourceListener</code> interface. * + * @return the listeners who will be notified when a drag and drop + * operation is in progress + * * @exception DWTException <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> @@ -532,7 +540,7 @@ * Removes the listener from the collection of listeners who will * be notified when a drag and drop operation is in progress. * - * @param listener the listener which should be notified + * @param listener the listener which should no longer be notified * * @exception IllegalArgumentException <ul> * <li>ERROR_NULL_ARGUMENT - if the listener is null</li> @@ -544,6 +552,7 @@ * * @see DragSourceListener * @see #addDragListener + * @see #getDragListeners */ public void removeDragListener(DragSourceListener listener) { if (listener is null) DND.error (DWT.ERROR_NULL_ARGUMENT);
--- a/dwt/dnd/DragSourceAdapter.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/dnd/DragSourceAdapter.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2004 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -25,21 +25,32 @@ * * @see DragSourceListener * @see DragSourceEvent + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class DragSourceAdapter : DragSourceListener { - /** - * This implementation of <code>dragStart</code> permits the drag operation to start. - * For additional information see <code>DragSourceListener.dragStart</code>. - */ - public void dragStart(DragSourceEvent event){} - /** - * This implementation of <code>dragFinished</code> does nothing. - * For additional information see <code>DragSourceListener.dragFinished</code>. - */ - public void dragFinished(DragSourceEvent event){} - /** - * This implementation of <code>dragSetData</code> does nothing. - * For additional information see <code>DragSourceListener.dragSetData</code>. - */ - public void dragSetData(DragSourceEvent event){} + +/** + * This implementation of <code>dragStart</code> permits the drag operation to start. + * For additional information see <code>DragSourceListener.dragStart</code>. + * + * @param event the information associated with the drag start event + */ +public void dragStart(DragSourceEvent event){} + +/** + * This implementation of <code>dragFinished</code> does nothing. + * For additional information see <code>DragSourceListener.dragFinished</code>. + * + * @param event the information associated with the drag finished event + */ +public void dragFinished(DragSourceEvent event){} + +/** + * This implementation of <code>dragSetData</code> does nothing. + * For additional information see <code>DragSourceListener.dragSetData</code>. + * + * @param event the information associated with the drag set data event + */ +public void dragSetData(DragSourceEvent event){} + }
--- a/dwt/dnd/DragSourceEffect.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/dnd/DragSourceEffect.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2007 IBM Corporation and others. + * Copyright (c) 2007, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -36,6 +36,7 @@ * * @see DragSourceAdapter * @see DragSourceEvent + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> * * @since 3.3 */
--- a/dwt/dnd/DragSourceEvent.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/dnd/DragSourceEvent.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -23,6 +23,7 @@ * The DragSourceEvent contains the event information passed in the methods of the DragSourceListener. * * @see DragSourceListener + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class DragSourceEvent : TypedEvent { /**
--- a/dwt/dnd/DropTarget.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/dnd/DropTarget.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -92,6 +92,10 @@ * <dt><b>Events</b></dt> <dd>DND.DragEnter, DND.DragLeave, DND.DragOver, DND.DragOperationChanged, * DND.DropAccept, DND.Drop </dd> * </dl> + * + * @see <a href="http://www.eclipse.org/swt/snippets/#dnd">Drag and Drop snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: DNDExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class DropTarget : Widget { @@ -353,6 +357,7 @@ * </ul> * * @see DropTargetListener + * @see #getDropListeners * @see #removeDropListener * @see DropTargetEvent */ @@ -583,6 +588,9 @@ * operation is in progress, by sending it one of the messages defined in * the <code>DropTargetListener</code> interface. * + * @return the listeners who will be notified when a drag and drop + * operation is in progress + * * @exception DWTException <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> @@ -688,7 +696,7 @@ * Removes the listener from the collection of listeners who will * be notified when a drag and drop operation is in progress. * - * @param listener the listener which should be notified + * @param listener the listener which should no longer be notified * * @exception IllegalArgumentException <ul> * <li>ERROR_NULL_ARGUMENT - if the listener is null</li> @@ -700,6 +708,7 @@ * * @see DropTargetListener * @see #addDropListener + * @see #getDropListeners */ public void removeDropListener(DropTargetListener listener) { if (listener is null) DND.error (DWT.ERROR_NULL_ARGUMENT);
--- a/dwt/dnd/DropTargetAdapter.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/dnd/DropTargetAdapter.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2004 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -26,6 +26,7 @@ * * @see DropTargetListener * @see DropTargetEvent + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class DropTargetAdapter : DropTargetListener { @@ -34,37 +35,54 @@ * operation defined in <code>event.detail</code>to be performed on the current data type * defined in <code>event.currentDataType</code>. * For additional information see <code>DropTargetListener.dragEnter</code>. + * + * @param event the information associated with the drag enter event */ public void dragEnter(DropTargetEvent event){} + /** * This implementation of <code>dragLeave</code> does nothing. * For additional information see <code>DropTargetListener.dragOperationChanged</code>. + * + * @param event the information associated with the drag leave event */ public void dragLeave(DropTargetEvent event){} + /** * This implementation of <code>dragOperationChanged</code> permits the default * operation defined in <code>event.detail</code>to be performed on the current data type * defined in <code>event.currentDataType</code>. * For additional information see <code>DropTargetListener.dragOperationChanged</code>. + * + * @param event the information associated with the drag operation changed event */ public void dragOperationChanged(DropTargetEvent event){} + /** * This implementation of <code>dragOver</code> permits the default * operation defined in <code>event.detail</code>to be performed on the current data type * defined in <code>event.currentDataType</code>. * For additional information see <code>DropTargetListener.dragOver</code>. + * + * @param event the information associated with the drag over event */ public void dragOver(DropTargetEvent event){} + /** * This implementation of <code>drop</code> does nothing. * For additional information see <code>DropTargetListener.drop</code>. + * + * @param event the information associated with the drop event */ public void drop(DropTargetEvent event){} + /** * This implementation of <code>dropAccept</code> permits the default * operation defined in <code>event.detail</code>to be performed on the current data type * defined in <code>event.currentDataType</code>. * For additional information see <code>DropTargetListener.dropAccept</code>. + * + * @param event the information associated with the drop accept event */ public void dropAccept(DropTargetEvent event){}
--- a/dwt/dnd/DropTargetEffect.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/dnd/DropTargetEffect.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2007 IBM Corporation and others. + * Copyright (c) 2007, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -54,6 +54,7 @@ * * @see DropTargetAdapter * @see DropTargetEvent + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> * * @since 3.3 */
--- a/dwt/dnd/DropTargetEvent.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/dnd/DropTargetEvent.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -21,6 +21,8 @@ /** * The DropTargetEvent contains the event information passed in the methods of the DropTargetListener. + * + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class DropTargetEvent : TypedEvent { /**
--- a/dwt/dnd/FileTransfer.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/dnd/FileTransfer.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2005 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -24,7 +24,6 @@ * platform specific representation of the data and vice versa. * Each <code>String</code> in the array contains the absolute path for a single * file or directory. - * See <code>Transfer</code> for additional information. * * <p>An example of a java <code>String[]</code> containing a list of files is shown * below:</p> @@ -36,6 +35,8 @@ * fileData[0] = file1.getAbsolutePath(); * fileData[1] = file2.getAbsolutePath(); * </code></pre> + * + * @see Transfer */ public class FileTransfer : ByteArrayTransfer { @@ -64,13 +65,13 @@ * This implementation of <code>javaToNative</code> converts a list of file names * represented by a java <code>String[]</code> to a platform specific representation. * Each <code>String</code> in the array contains the absolute path for a single - * file or directory. For additional information see - * <code>Transfer#javaToNative</code>. - * - * @param object a java <code>String[]</code> containing the file names to be - * converted - * @param transferData an empty <code>TransferData</code> object; this - * object will be filled in on return with the platform specific format of the data + * file or directory. + * + * @param object a java <code>String[]</code> containing the file names to be converted + * @param transferData an empty <code>TransferData</code> object that will + * be filled in on return with the platform specific format of the data + * + * @see Transfer#nativeToJava */ public override void javaToNative(Object object, TransferData transferData) { transferData.result = 0; @@ -116,12 +117,12 @@ * This implementation of <code>nativeToJava</code> converts a platform specific * representation of a list of file names to a java <code>String[]</code>. * Each String in the array contains the absolute path for a single file or directory. - * For additional information see <code>Transfer#nativeToJava</code>. * - * @param transferData the platform specific representation of the data to be - * been converted - * @return a java <code>String[]</code> containing a list of file names if the - * conversion was successful; otherwise null + * @param transferData the platform specific representation of the data to be converted + * @return a java <code>String[]</code> containing a list of file names if the conversion + * was successful; otherwise null + * + * @see Transfer#javaToNative */ public override Object nativeToJava(TransferData transferData) { if ( !isSupportedType(transferData) || transferData.pValue is null || transferData.length <= 0 ) return null;
--- a/dwt/dnd/HTMLTransfer.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/dnd/HTMLTransfer.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2005 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -23,8 +23,7 @@ /** * The class <code>HTMLTransfer</code> provides a platform specific mechanism * for converting text in HTML format represented as a java <code>String</code> - * to a platform specific representation of the data and vice versa. See - * <code>Transfer</code> for additional information. + * to a platform specific representation of the data and vice versa. * * <p>An example of a java <code>String</code> containing HTML text is shown * below:</p> @@ -32,6 +31,8 @@ * <code><pre> * String htmlData = "<p>This is a paragraph of text.</p>"; * </code></pre> + * + * @see Transfer */ public class HTMLTransfer : ByteArrayTransfer { @@ -61,11 +62,12 @@ /** * This implementation of <code>javaToNative</code> converts HTML-formatted text * represented by a java <code>String</code> to a platform specific representation. - * For additional information see <code>Transfer#javaToNative</code>. * * @param object a java <code>String</code> containing HTML text - * @param transferData an empty <code>TransferData</code> object; this - * object will be filled in on return with the platform specific format of the data + * @param transferData an empty <code>TransferData</code> object that will + * be filled in on return with the platform specific format of the data + * + * @see Transfer#nativeToJava */ public override void javaToNative (Object object, TransferData transferData){ transferData.result = 0; @@ -85,12 +87,12 @@ /** * This implementation of <code>nativeToJava</code> converts a platform specific * representation of HTML text to a java <code>String</code>. - * For additional information see <code>Transfer#nativeToJava</code>. * - * @param transferData the platform specific representation of the data to be - * been converted - * @return a java <code>String</code> containing HTML text if the - * conversion was successful; otherwise null + * @param transferData the platform specific representation of the data to be converted + * @return a java <code>String</code> containing HTML text if the conversion was successful; + * otherwise null + * + * @see Transfer#javaToNative */ public override Object nativeToJava(TransferData transferData){ if ( !isSupportedType(transferData) || transferData.pValue is null ) return null;
--- a/dwt/dnd/ImageTransfer.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/dnd/ImageTransfer.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2004 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -24,17 +24,19 @@ /** * The class <code>ImageTransfer</code> provides a platform specific mechanism - * for converting a Image represented as a java <code>ImageData</code> to a + * for converting an Image represented as a java <code>ImageData</code> to a * platform specific representation of the data and vice versa. - * See <code>Transfer</code> for additional information. * - * <p>An example of a java <code>ImageData</code> is shown - * below:</p> + * <p>An example of a java <code>ImageData</code> is shown below:</p> * * <code><pre> - * Image image = new Image("C:\temp\img1.gif"); + * Image image = new Image(display, "C:\temp\img1.gif"); * ImageData imgData = image.getImageData(); * </code></pre> + * + * @see Transfer + * + * @since 3.4 */ public class ImageTransfer : ByteArrayTransfer { @@ -93,12 +95,12 @@ /** * This implementation of <code>javaToNative</code> converts an ImageData object represented * by java <code>ImageData</code> to a platform specific representation. - * For additional information see <code>Transfer#javaToNative</code>. * - * @param object a java <code>ImageData</code> containing the ImageData to be - * converted - * @param transferData an empty <code>TransferData</code> object; this - * object will be filled in on return with the platform specific format of the data + * @param object a java <code>ImageData</code> containing the ImageData to be converted + * @param transferData an empty <code>TransferData</code> object that will + * be filled in on return with the platform specific format of the data + * + * @see Transfer#nativeToJava */ public void javaToNative(Object object, TransferData transferData) { if (!checkImage(object) || !isSupportedType(transferData)) { @@ -144,13 +146,13 @@ /** * This implementation of <code>nativeToJava</code> converts a platform specific - * representation of an <code>ImageData</code> to java. - * For additional information see <code>Transfer#nativeToJava</code>. - * - * @param transferData the platform specific representation of the data to be - * been converted - * @return a java <code>ImageData</code> the imageData of the image if - * conversion was successful; otherwise null + * representation of an image to java <code>ImageData</code>. + * + * @param transferData the platform specific representation of the data to be converted + * @return a java <code>ImageData</code> of the image if the conversion was successful; + * otherwise null + * + * @see Transfer#javaToNative */ public Object nativeToJava(TransferData transferData) { ImageData imgData = null;
--- a/dwt/dnd/RTFTransfer.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/dnd/RTFTransfer.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2005 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -24,8 +24,7 @@ /** * The class <code>RTFTransfer</code> provides a platform specific mechanism * for converting text in RTF format represented as a java <code>String</code> - * to a platform specific representation of the data and vice versa. See - * <code>Transfer</code> for additional information. + * to a platform specific representation of the data and vice versa. * * <p>An example of a java <code>String</code> containing RTF text is shown * below:</p> @@ -33,6 +32,8 @@ * <code><pre> * String rtfData = "{\\rtf1{\\colortbl;\\red255\\green0\\blue0;}\\uc1\\b\\i Hello World}"; * </code></pre> + * + * @see Transfer */ public class RTFTransfer : ByteArrayTransfer { @@ -65,11 +66,12 @@ /** * This implementation of <code>javaToNative</code> converts RTF-formatted text * represented by a java <code>String</code> to a platform specific representation. - * For additional information see <code>Transfer#javaToNative</code>. * * @param object a java <code>String</code> containing RTF text - * @param transferData an empty <code>TransferData</code> object; this - * object will be filled in on return with the platform specific format of the data + * @param transferData an empty <code>TransferData</code> object that will + * be filled in on return with the platform specific format of the data + * + * @see Transfer#nativeToJava */ public override void javaToNative (Object object, TransferData transferData){ transferData.result = 0; @@ -90,12 +92,12 @@ /** * This implementation of <code>nativeToJava</code> converts a platform specific * representation of RTF text to a java <code>String</code>. - * For additional information see <code>Transfer#nativeToJava</code>. * - * @param transferData the platform specific representation of the data to be - * been converted - * @return a java <code>String</code> containing RTF text if the - * conversion was successful; otherwise null + * @param transferData the platform specific representation of the data to be converted + * @return a java <code>String</code> containing RTF text if the conversion was successful; + * otherwise null + * + * @see Transfer#javaToNative */ public override Object nativeToJava(TransferData transferData){ if ( !isSupportedType(transferData) || transferData.pValue is null ) return null;
--- a/dwt/dnd/TableDragSourceEffect.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/dnd/TableDragSourceEffect.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -37,6 +37,7 @@ * * @see DragSourceEffect * @see DragSourceEvent + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> * * @since 3.3 */
--- a/dwt/dnd/TableDropTargetEffect.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/dnd/TableDropTargetEffect.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -48,6 +48,7 @@ * * @see DropTargetAdapter * @see DropTargetEvent + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> * * @since 3.3 */
--- a/dwt/dnd/TextTransfer.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/dnd/TextTransfer.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -67,10 +67,10 @@ * represented by a java <code>String</code> to a platform specific representation. * * @param object a java <code>String</code> containing text - * @param transferData an empty <code>TransferData</code> object; this object - * will be filled in on return with the platform specific format of the data + * @param transferData an empty <code>TransferData</code> object that will + * be filled in on return with the platform specific format of the data * - * @see Transfer#javaToNative + * @see Transfer#nativeToJava */ override public void javaToNative (Object object, TransferData transferData) { transferData.result = 0; @@ -121,7 +121,7 @@ * @param transferData the platform specific representation of the data to be converted * @return a java <code>String</code> containing text if the conversion was successful; otherwise null * - * @see Transfer#nativeToJava + * @see Transfer#javaToNative */ override public Object nativeToJava(TransferData transferData){ if (!isSupportedType(transferData) || transferData.pValue is null) return null;
--- a/dwt/dnd/Transfer.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/dnd/Transfer.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -31,6 +31,9 @@ * ByteArrayTransfer class.</p> * * @see ByteArrayTransfer + * @see <a href="http://www.eclipse.org/swt/snippets/#dnd">Drag and Drop snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: DNDExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public abstract class Transfer {
--- a/dwt/dnd/TransferData.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/dnd/TransferData.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2005 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -26,6 +26,8 @@ * <p>You should only need to become familiar with the fields in this class if you * are implementing a Transfer subclass and you are unable to subclass the * ByteArrayTransfer class.</p> + * + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class TransferData { /**
--- a/dwt/dnd/TreeDragSourceEffect.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/dnd/TreeDragSourceEffect.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -36,6 +36,7 @@ * * @see DragSourceEffect * @see DragSourceEvent + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> * * @since 3.3 */
--- a/dwt/dnd/TreeDropTargetEffect.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/dnd/TreeDropTargetEffect.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -50,6 +50,7 @@ * * @see DropTargetAdapter * @see DropTargetEvent + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> * * @since 3.3 */
--- a/dwt/dnd/URLTransfer.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/dnd/URLTransfer.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2007 IBM Corporation and others. + * Copyright (c) 2007, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -23,14 +23,14 @@ * for converting text in URL format represented as a java <code>String</code> * to a platform specific representation of the data and vice versa. See * <code>Transfer</code> for additional information. The string - * must be a fully specified url. * - * <p>An example of a java <code>String[]</code> containing a URL is shown - * below:</p> + * <p>An example of a java <code>String</code> containing a URL is shown below:</p> * * <code><pre> - * String urlData = "http://www.eclipse.org"; + * String url = "http://www.eclipse.org"; * </code></pre> + * + * @see Transfer */ public class URLTransfer : ByteArrayTransfer { @@ -60,11 +60,12 @@ /** * This implementation of <code>javaToNative</code> converts a URL * represented by a java <code>String</code> to a platform specific representation. - * For additional information see <code>Transfer#javaToNative</code>. * * @param object a java <code>String</code> containing a URL - * @param transferData an empty <code>TransferData</code> object; this - * object will be filled in on return with the platform specific format of the data + * @param transferData an empty <code>TransferData</code> object that will + * be filled in on return with the platform specific format of the data + * + * @see Transfer#nativeToJava */ public void javaToNative (Object object, TransferData transferData){ transferData.result = 0; @@ -83,14 +84,14 @@ } /** - * This implementation of <code>nativeToJava</code> converts a platform specific - * representation of a URL <code>String</code>. - * For additional information see <code>Transfer#nativeToJava</code>. - * - * @param transferData the platform specific representation of the data to be - * converted - * @return a java <code>String</code> containing a URL if the - * conversion was successful; otherwise null + * This implementation of <code>nativeToJava</code> converts a platform + * specific representation of a URL to a java <code>String</code>. + * + * @param transferData the platform specific representation of the data to be converted + * @return a java <code>String</code> containing a URL if the conversion was successful; + * otherwise null + * + * @see Transfer#javaToNative */ public Object nativeToJava(TransferData transferData){ if (!isSupportedType(transferData) || transferData.pValue is null) return null;
--- a/dwt/events/ArmEvent.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/events/ArmEvent.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2004 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -20,6 +20,7 @@ * a widget such as a menu item being armed. * * @see ArmListener + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public final class ArmEvent : TypedEvent {
--- a/dwt/events/ControlAdapter.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/events/ControlAdapter.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -24,6 +24,7 @@ * * @see ControlListener * @see ControlEvent + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public abstract class ControlAdapter : ControlListener {
--- a/dwt/events/ControlEvent.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/events/ControlEvent.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2004 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -21,6 +21,7 @@ * controls being moved or resized. * * @see ControlListener + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public final class ControlEvent : TypedEvent {
--- a/dwt/events/DisposeEvent.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/events/DisposeEvent.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2004 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -21,6 +21,7 @@ * widgets being disposed. * * @see DisposeListener + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public final class DisposeEvent : TypedEvent {
--- a/dwt/events/DragDetectEvent.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/events/DragDetectEvent.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -20,6 +20,7 @@ * a drag gesture. * * @see DragDetectListener + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> * * @since 3.3 */
--- a/dwt/events/ExpandAdapter.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/events/ExpandAdapter.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -25,6 +25,7 @@ * * @see ExpandListener * @see ExpandEvent + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> * * @since 3.2 */
--- a/dwt/events/ExpandEvent.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/events/ExpandEvent.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -21,6 +21,7 @@ * <code>ExpandItem</code>s being expanded or collapsed. * * @see ExpandListener + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> * * @since 3.2 */
--- a/dwt/events/FocusAdapter.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/events/FocusAdapter.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -25,6 +25,7 @@ * * @see FocusListener * @see FocusEvent + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public abstract class FocusAdapter : FocusListener {
--- a/dwt/events/FocusEvent.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/events/FocusEvent.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2004 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -21,6 +21,7 @@ * widgets gaining and losing focus. * * @see FocusListener + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public final class FocusEvent : TypedEvent {
--- a/dwt/events/HelpEvent.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/events/HelpEvent.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2004 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -21,6 +21,7 @@ * help being requested for a widget. * * @see HelpListener + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public final class HelpEvent : TypedEvent {
--- a/dwt/events/KeyAdapter.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/events/KeyAdapter.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -25,6 +25,7 @@ * * @see KeyListener * @see KeyEvent + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public abstract class KeyAdapter : KeyListener {
--- a/dwt/events/KeyEvent.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/events/KeyEvent.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -35,8 +35,10 @@ * not necessary to add traversal listeners for these controls, * unless you want to override the default traversal. * </p> + * * @see KeyListener * @see TraverseListener + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class KeyEvent : TypedEvent {
--- a/dwt/events/MenuAdapter.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/events/MenuAdapter.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -25,6 +25,7 @@ * * @see MenuListener * @see MenuEvent + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public abstract class MenuAdapter : MenuListener {
--- a/dwt/events/MenuDetectEvent.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/events/MenuDetectEvent.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -24,6 +24,7 @@ * specific trigger for showing a context menu is detected. * * @see MenuDetectListener + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> * * @since 3.3 */
--- a/dwt/events/MenuEvent.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/events/MenuEvent.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2004 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -21,6 +21,7 @@ * menus being shown and hidden. * * @see MenuListener + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public final class MenuEvent : TypedEvent {
--- a/dwt/events/ModifyEvent.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/events/ModifyEvent.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2004 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -21,6 +21,7 @@ * text being modified. * * @see ModifyListener + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public final class ModifyEvent : TypedEvent {
--- a/dwt/events/MouseAdapter.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/events/MouseAdapter.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2004 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -26,6 +26,7 @@ * * @see MouseListener * @see MouseEvent + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public abstract class MouseAdapter : MouseListener {
--- a/dwt/events/MouseEvent.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/events/MouseEvent.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -34,6 +34,7 @@ * @see MouseListener * @see MouseMoveListener * @see MouseTrackListener + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class MouseEvent : TypedEvent {
--- a/dwt/events/MouseTrackAdapter.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/events/MouseTrackAdapter.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2004 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -26,6 +26,7 @@ * * @see MouseTrackListener * @see MouseEvent + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public abstract class MouseTrackAdapter : MouseTrackListener {
--- a/dwt/events/PaintEvent.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/events/PaintEvent.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2004 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -27,6 +27,7 @@ * visible areas of controls requiring re-painting. * * @see PaintListener + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public final class PaintEvent : TypedEvent {
--- a/dwt/events/SelectionAdapter.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/events/SelectionAdapter.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -25,6 +25,7 @@ * * @see SelectionListener * @see SelectionEvent + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public abstract class SelectionAdapter : SelectionListener {
--- a/dwt/events/SelectionEvent.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/events/SelectionEvent.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -28,6 +28,7 @@ * </p> * * @see SelectionListener + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class SelectionEvent : TypedEvent {
--- a/dwt/events/ShellAdapter.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/events/ShellAdapter.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -25,6 +25,7 @@ * * @see ShellListener * @see ShellEvent + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public abstract class ShellAdapter : ShellListener {
--- a/dwt/events/ShellEvent.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/events/ShellEvent.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2004 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -25,6 +25,7 @@ * operations being performed on shells. * * @see ShellListener + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public final class ShellEvent : TypedEvent {
--- a/dwt/events/TraverseEvent.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/events/TraverseEvent.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -81,6 +81,7 @@ * </p> * * @see TraverseListener + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public final class TraverseEvent : KeyEvent {
--- a/dwt/events/TreeAdapter.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/events/TreeAdapter.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2003 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -25,6 +25,7 @@ * * @see TreeListener * @see TreeEvent + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public abstract class TreeAdapter : TreeListener {
--- a/dwt/events/TreeEvent.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/events/TreeEvent.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2004 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -21,6 +21,7 @@ * trees being expanded and collapsed. * * @see TreeListener + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public final class TreeEvent : SelectionEvent {
--- a/dwt/events/TypedEvent.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/events/TypedEvent.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -29,6 +29,7 @@ * applicable to the event occurrence. * * @see dwt.widgets.Event + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class TypedEvent : DWTEventObject {
--- a/dwt/events/VerifyEvent.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/events/VerifyEvent.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -24,6 +24,7 @@ * widgets handling keyboard events * * @see VerifyListener + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public final class VerifyEvent : KeyEvent {
--- a/dwt/graphics/Color.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/graphics/Color.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2005 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -37,6 +37,9 @@ * * @see RGB * @see Device#getSystemColor + * @see <a href="http://www.eclipse.org/swt/snippets/#color">Color and RGB snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: PaintExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public final class Color : Resource { alias Resource.init_ init_;
--- a/dwt/graphics/Cursor.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/graphics/Cursor.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -50,6 +50,9 @@ * <p> * Note: Only one of the above styles may be specified. * </p> + * + * @see <a href="http://www.eclipse.org/swt/snippets/#cursor">Cursor snippets</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public final class Cursor : Resource { /**
--- a/dwt/graphics/Device.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/graphics/Device.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -35,6 +35,8 @@ * such as the Display device and the Printer device. Devices * can have a graphics context (GC) created for them, and they * can be drawn on by sending messages to the associated GC. + * + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public abstract class Device : Drawable { /**
--- a/dwt/graphics/Font.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/graphics/Font.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -36,6 +36,9 @@ * </p> * * @see FontData + * @see <a href="http://www.eclipse.org/swt/snippets/#font">Font snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Examples: GraphicsExample, PaintExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public final class Font : Resource {
--- a/dwt/graphics/FontData.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/graphics/FontData.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -44,6 +44,7 @@ * required, and thus no <code>dispose()</code> method is provided. * * @see Font + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public final class FontData { /**
--- a/dwt/graphics/FontMetrics.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/graphics/FontMetrics.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2005 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -21,6 +21,7 @@ * using the <code>getFontMetrics()</code> method. * * @see GC#getFontMetrics + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public final class FontMetrics { int ascent, descent, averageCharWidth, leading, height;
--- a/dwt/graphics/GC.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/graphics/GC.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -75,6 +75,9 @@ * </p> * * @see dwt.events.PaintEvent + * @see <a href="http://www.eclipse.org/swt/snippets/#gc">GC snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Examples: GraphicsExample, PaintExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public final class GC : Resource { @@ -1030,7 +1033,7 @@ } /* Merge clipping with mask if necessary */ - if (data.clipRgn !is null) { + if (data.clipRgn !is null) { int newWidth = srcX + srcWidth; int newHeight = srcY + srcHeight; int bytesPerLine = (newWidth + 7) / 8; @@ -2186,7 +2189,8 @@ } /** - * Returns the receiver's alpha value. + * Returns the receiver's alpha value. The alpha value + * is between 0 (transparent) and 255 (opaque). * * @return the alpha value * @@ -2984,7 +2988,8 @@ } /** - * Sets the receiver's alpha value. + * Sets the receiver's alpha value which must be + * between 0 (transparent) and 255 (opaque). * <p> * This operation requires the operating system's advanced * graphics subsystem which may not be available on some
--- a/dwt/graphics/GCData.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/graphics/GCData.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -30,6 +30,7 @@ * within the packages provided by DWT. It is not available on all * platforms, and should never be called from application code. * </p> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public final class GCData { public Device device;
--- a/dwt/graphics/GlyphMetrics.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/graphics/GlyphMetrics.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -32,6 +32,7 @@ * * @see TextStyle * @see TextLayout + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> * * @since 3.2 */ @@ -56,13 +57,17 @@ * Constructs an instance of this class with the given * ascent, descent and width values. * + * @param ascent the GlyphMetrics ascent + * @param descent the GlyphMetrics descent + * @param width the GlyphMetrics width + * * @exception IllegalArgumentException <ul> * <li>ERROR_INVALID_ARGUMENT - if the ascent, descent or width argument is negative</li> * </ul> */ public this(int ascent, int descent, int width) { if (ascent < 0 || descent < 0 || width < 0) { - DWT.error(DWT.ERROR_INVALID_ARGUMENT); + DWT.error(DWT.ERROR_INVALID_ARGUMENT); } this.ascent = ascent; this.descent = descent;
--- a/dwt/graphics/Image.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/graphics/Image.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -80,6 +80,9 @@ * @see Color * @see ImageData * @see ImageLoader + * @see <a href="http://www.eclipse.org/swt/snippets/#image">Image snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Examples: GraphicsExample, ImageAnalyzer</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public final class Image : Resource, Drawable { alias Resource.init_ init_; @@ -202,11 +205,11 @@ * provided image, with an appearance that varies depending * on the value of the flag. The possible flag values are: * <dl> - * <dt><b>IMAGE_COPY</b></dt> + * <dt><b>{@link DWT#IMAGE_COPY}</b></dt> * <dd>the result is an identical copy of srcImage</dd> - * <dt><b>IMAGE_DISABLE</b></dt> + * <dt><b>{@link DWT#IMAGE_DISABLE}</b></dt> * <dd>the result is a copy of srcImage which has a <em>disabled</em> look</dd> - * <dt><b>IMAGE_GRAY</b></dt> + * <dt><b>{@link DWT#IMAGE_GRAY}</b></dt> * <dd>the result is a copy of srcImage which has a <em>gray scale</em> look</dd> * </dl> *
--- a/dwt/graphics/ImageData.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/graphics/ImageData.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -40,6 +40,9 @@ * * @see Image * @see ImageLoader + * @see <a href="http://www.eclipse.org/swt/snippets/#image">ImageData snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: ImageAnalyzer</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public final class ImageData : CloneableCompatibility { @@ -600,6 +603,8 @@ /** * Returns the alpha value at offset <code>x</code> in * scanline <code>y</code> in the receiver's alpha data. + * The alpha value is between 0 (transparent) and + * 255 (opaque). * * @param x the x coordinate of the pixel to get the alpha value of * @param y the y coordinate of the pixel to get the alpha value of @@ -619,7 +624,9 @@ /** * Returns <code>getWidth</code> alpha values starting at offset * <code>x</code> in scanline <code>y</code> in the receiver's alpha - * data starting at <code>startIndex</code>. + * data starting at <code>startIndex</code>. The alpha values + * are unsigned, between <code>(byte)0</code> (transparent) and + * <code>(byte)255</code> (opaque). * * @param x the x position of the pixel to begin getting alpha values * @param y the y position of the pixel to begin getting alpha values @@ -1173,6 +1180,8 @@ /** * Sets the alpha value at offset <code>x</code> in * scanline <code>y</code> in the receiver's alpha data. + * The alpha value must be between 0 (transparent) + * and 255 (opaque). * * @param x the x coordinate of the alpha value to set * @param y the y coordinate of the alpha value to set @@ -1194,7 +1203,8 @@ * Sets the alpha values starting at offset <code>x</code> in * scanline <code>y</code> in the receiver's alpha data to the * values from the array <code>alphas</code> starting at - * <code>startIndex</code>. + * <code>startIndex</code>. The alpha values must be between + * <code>(byte)0</code> (transparent) and <code>(byte)255</code> (opaque) * * @param x the x coordinate of the pixel to being setting the alpha values * @param y the y coordinate of the pixel to being setting the alpha values
--- a/dwt/graphics/ImageLoader.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/graphics/ImageLoader.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -48,6 +48,9 @@ * <li>load interlaced GIF/PNG images</li> * <li>load progressive JPEG images</li> * </ul> + * + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: ImageAnalyzer</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class ImageLoader {
--- a/dwt/graphics/ImageLoaderEvent.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/graphics/ImageLoaderEvent.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2004 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -37,6 +37,7 @@ * * @see ImageLoader * @see ImageLoaderListener + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class ImageLoaderEvent : DWTEventObject {
--- a/dwt/graphics/LineAttributes.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/graphics/LineAttributes.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -25,6 +25,7 @@ * * @see GC#getLineAttributes() * @see GC#setLineAttributes(LineAttributes) + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> * * @since 3.3 */
--- a/dwt/graphics/PaletteData.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/graphics/PaletteData.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2005 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -53,6 +53,7 @@ * * @see Image * @see RGB + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public final class PaletteData {
--- a/dwt/graphics/Path.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/graphics/Path.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -41,6 +41,10 @@ * which may not be available on some platforms. * </p> * + * @see <a href="http://www.eclipse.org/swt/snippets/#path">Path, Pattern snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: GraphicsExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> + * * @since 3.1 */ public class Path : Resource { @@ -92,6 +96,37 @@ init_(); } +/** + * Constructs a new Path that is a copy of <code>path</code>. If + * <code>flatness</code> is less than or equal to zero, an unflatten + * copy of the path is created. Otherwise, it specifies the maximum + * error between the path and its flatten copy. Smaller numbers give + * better approximation. + * <p> + * This operation requires the operating system's advanced + * graphics subsystem which may not be available on some + * platforms. + * </p> + * + * @param device the device on which to allocate the path + * @param path the path to make a copy + * @param flatness the flatness value + * + * @exception IllegalArgumentException <ul> + * <li>ERROR_NULL_ARGUMENT - if the device is null and there is no current device</li> + * <li>ERROR_NULL_ARGUMENT - if the path is null</li> + * <li>ERROR_INVALID_ARGUMENT - if the path has been disposed</li> + * </ul> + * @exception DWTException <ul> + * <li>ERROR_NO_GRAPHICS_LIBRARY - if advanced graphics are not available</li> + * </ul> + * @exception DWTError <ul> + * <li>ERROR_NO_HANDLES if a handle for the path could not be obtained</li> + * </ul> + * + * @see #dispose() + * @since 3.4 + */ public this (Device device, Path path, float flatness) { super(device); if (path is null) DWT.error(DWT.ERROR_NULL_ARGUMENT); @@ -120,6 +155,31 @@ init_(); } +/** + * Constructs a new Path with the specifed PathData. + * <p> + * This operation requires the operating system's advanced + * graphics subsystem which may not be available on some + * platforms. + * </p> + * + * @param device the device on which to allocate the path + * @param data the data for the path + * + * @exception IllegalArgumentException <ul> + * <li>ERROR_NULL_ARGUMENT - if the device is null and there is no current device</li> + * <li>ERROR_NULL_ARGUMENT - if the data is null</li> + * </ul> + * @exception DWTException <ul> + * <li>ERROR_NO_GRAPHICS_LIBRARY - if advanced graphics are not available</li> + * </ul> + * @exception DWTError <ul> + * <li>ERROR_NO_HANDLES if a handle for the path could not be obtained</li> + * </ul> + * + * @see #dispose() + * @since 3.4 + */ public this (Device device, PathData data) { this(device); if (data is null) DWT.error(DWT.ERROR_NULL_ARGUMENT);
--- a/dwt/graphics/PathData.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/graphics/PathData.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2005 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -17,6 +17,7 @@ * Instances of this class describe device-independent paths. * * @see Path + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> * * @since 3.1 */
--- a/dwt/graphics/Pattern.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/graphics/Pattern.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -38,6 +38,10 @@ * which may not be available on some platforms. * </p> * + * @see <a href="http://www.eclipse.org/swt/snippets/#path">Path, Pattern snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: GraphicsExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> + * * @since 3.1 */ public class Pattern : Resource {
--- a/dwt/graphics/Point.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/graphics/Point.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2005 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -41,6 +41,7 @@ * </p> * * @see Rectangle + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public final class Point : SerializableCompatibility {
--- a/dwt/graphics/RGB.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/graphics/RGB.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2005 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -41,6 +41,8 @@ * </p> * * @see Color + * @see <a href="http://www.eclipse.org/swt/snippets/#color">Color and RGB snippets</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public final class RGB : SerializableCompatibility {
--- a/dwt/graphics/Rectangle.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/graphics/Rectangle.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2005 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -45,6 +45,7 @@ * </p> * * @see Point + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public final class Rectangle : SerializableCompatibility {
--- a/dwt/graphics/Region.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/graphics/Region.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2005 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -33,6 +33,9 @@ * method to release the operating system resources managed by each instance * when those instances are no longer required. * </p> + * + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: GraphicsExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public final class Region : Resource { /**
--- a/dwt/graphics/Resource.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/graphics/Resource.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2005 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -36,6 +36,7 @@ * * @see #dispose * @see #isDisposed + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> * * @since 3.1 */ @@ -46,7 +47,7 @@ */ Device device; -this() { +public this() { } this(Device device) {
--- a/dwt/graphics/TextLayout.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/graphics/TextLayout.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -49,7 +49,11 @@ * when those instances are no longer required. * </p> * - * @since 3.0 + * @see <a href="http://www.eclipse.org/swt/snippets/#textlayout">TextLayout, TextStyle snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: CustomControlExample, StyledText tab</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> + * + * @since 3.0 */ public final class TextLayout : Resource { @@ -101,6 +105,7 @@ */ public this (Device device) { super(device); + device = this.device; context = OS.gdk_pango_context_get(); if (context is null) DWT.error(DWT.ERROR_NO_HANDLES); OS.pango_context_set_language(context, OS.gtk_get_default_language()); @@ -110,7 +115,7 @@ if (layout is null) DWT.error(DWT.ERROR_NO_HANDLES); OS.pango_layout_set_font_description(layout, device.systemFont.handle); OS.pango_layout_set_wrap(layout, OS.PANGO_WRAP_WORD_CHAR); - OS.pango_layout_set_tabs(layout, this.device.emptyTab); + OS.pango_layout_set_tabs(layout, device.emptyTab); if (OS.GTK_VERSION >= OS.buildVERSION(2, 4, 0)) { OS.pango_layout_set_auto_dir(layout, false); } @@ -200,6 +205,7 @@ } } int slen = strlen(ptr); + Font defaultFont = font !is null ? font : device.systemFont; for (int i = 0; i < styles.length - 1; i++) { StyleItem styleItem = styles[i]; TextStyle style = styleItem.style; @@ -211,7 +217,7 @@ byteStart = Math.min(byteStart, slen); byteEnd = Math.min(byteEnd, slen); Font font = style.font; - if (font !is null && !font.isDisposed()) { + if (font !is null && !font.isDisposed() && !defaultFont.equals(font)) { auto attr = OS.pango_attr_font_desc_new (font.handle); attr.start_index = byteStart; attr.end_index = byteEnd; @@ -883,13 +889,18 @@ } /** - * Returns the bounds of the receiver. + * Returns the bounds of the receiver. The width returned is either the + * width of the longest line or the width set using {@link TextLayout#setWidth(int)}. + * To obtain the text bounds of a line use {@link TextLayout#getLineBounds(int)}. * * @return the bounds of the receiver * * @exception DWTException <ul> * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> * </ul> + * + * @see #setWidth(int) + * @see #getLineBounds(int) */ public Rectangle getBounds() { checkLayout(); @@ -1810,6 +1821,7 @@ if (font !is null && font.isDisposed()) DWT.error(DWT.ERROR_INVALID_ARGUMENT); Font oldFont = this.font; if (oldFont is font) return; + freeRuns(); this.font = font; if (oldFont !is null && oldFont.opEquals(font)) return; OS.pango_layout_set_font_description(layout, font !is null ? font.handle : device.systemFont.handle);
--- a/dwt/graphics/TextStyle.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/graphics/TextStyle.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -38,6 +38,8 @@ * @see TextLayout * @see Font * @see Color + * @see <a href="http://www.eclipse.org/swt/snippets/#textlayout">TextLayout, TextStyle snippets</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> * * @since 3.0 */
--- a/dwt/graphics/Transform.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/graphics/Transform.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -35,6 +35,9 @@ * which may not be available on some platforms. * </p> * + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: GraphicsExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> + * * @since 3.1 */ public class Transform : Resource { @@ -179,13 +182,23 @@ elements[5] = cast(float)handle[5]; } +/** + * Modifies the receiver such that the matrix it represents becomes the + * identity matrix. + * + * @exception DWTException <ul> + * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> + * </ul> + * + * @since 3.4 + */ public void identity() { if (isDisposed()) DWT.error(DWT.ERROR_GRAPHIC_DISPOSED); Cairo.cairo_matrix_init(cast(cairo_matrix_t*)handle.ptr, 1, 0, 0, 1, 0, 0); } /** - * Modifies the receiver such that the matrix it represents becomes the + * Modifies the receiver such that the matrix it represents becomes * the mathematical inverse of the matrix it previously represented. * * @exception DWTException <ul> @@ -303,6 +316,19 @@ Cairo.cairo_matrix_init(cast(cairo_matrix_t*)handle.ptr, m11, m12, m21, m22, dx, dy); } +/** + * Modifies the receiver so that it represents a transformation that is + * equivalent to its previous transformation sheared by (shearX, shearY). + * + * @param shearX the shear factor in the X direction + * @param shearY the shear factor in the Y direction + * + * @exception DWTException <ul> + * <li>ERROR_GRAPHIC_DISPOSED - if the receiver has been disposed</li> + * </ul> + * + * @since 3.4 + */ public void shear(float shearX, float shearY) { if (isDisposed()) DWT.error(DWT.ERROR_GRAPHIC_DISPOSED); double[] matrix = [ 1.0, shearX, shearY, 1, 0, 0];
--- a/dwt/internal/BidiUtil.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/internal/BidiUtil.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2004 IBM Corporation and others. + * Copyright (c) 2000, 2007 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at
--- a/dwt/internal/Compatibility.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/internal/Compatibility.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2007 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at
--- a/dwt/internal/Library.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/internal/Library.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -35,7 +35,7 @@ /** * DWT Minor version number (must be in the range 0..999) */ - static const int MINOR_VERSION = 442; + static const int MINOR_VERSION = 448; /** * DWT revision number (must be >= 0)
--- a/dwt/internal/gtk/OS.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/internal/gtk/OS.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. All rights reserved. + * Copyright (c) 2000, 2008 IBM Corporation and others. All rights reserved. * The contents of this file are made available under the terms * of the GNU Lesser General Public License (LGPL) Version 2.1 that * accompanies this distribution (lgpl-v21.txt). The LGPL is also @@ -2240,6 +2240,7 @@ mixin ForwardGtkOsCFunc!(.pango_layout_iter_next_run); mixin ForwardGtkOsCFunc!(.pango_layout_line_get_extents); mixin ForwardGtkOsCFunc!(.pango_layout_line_x_to_index); + mixin ForwardGtkOsCFunc!(.pango_layout_line_get_resolved_dir); mixin ForwardGtkOsCFunc!(.pango_layout_new); mixin ForwardGtkOsCFunc!(.pango_layout_set_alignment ); mixin ForwardGtkOsCFunc!(.pango_layout_set_attributes);
--- a/dwt/internal/image/FileFormat.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/internal/image/FileFormat.d Sun Jun 29 14:33:38 2008 +0200 @@ -82,7 +82,7 @@ public static ImageData[] load(InputStream istr, ImageLoader loader) { FileFormat fileFormat = null; LEDataInputStream stream = new LEDataInputStream(istr); - bool isSupported = false; + bool isSupported = false; foreach( TFormat; TFormats ){ try{ fileFormat = new TFormat();
--- a/dwt/internal/image/GIFFileFormat.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/internal/image/GIFFileFormat.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2005 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at
--- a/dwt/internal/image/JPEGDecoder.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/internal/image/JPEGDecoder.d Sun Jun 29 14:33:38 2008 +0200 @@ -243,7 +243,7 @@ * You could suppress output of a table by setting this to true. * (See jpeg_suppress_tables for an example.) */ - bool sent_table; /* true when table has been output */ + bool sent_table; /* true when table has been output */ } static final class JHUFF_TBL { @@ -256,7 +256,7 @@ * You could suppress output of a table by setting this to true. * (See jpeg_suppress_tables for an example.) */ - bool sent_table; /* true when table has been output */ + bool sent_table; /* true when table has been output */ } static final class bitread_perm_state { /* Bitreading state saved across MCUs */ @@ -374,7 +374,7 @@ /* This is here to share code between baseline and progressive decoders; */ /* other modules probably should not use it */ - bool insufficient_data; /* set true after emitting warning */ + bool insufficient_data; /* set true after emitting warning */ bitread_working_state br_state_local; savable_state state_local; @@ -979,7 +979,7 @@ r = s >> 4; s &= 15; if (s !is 0) { - if (s !is 1) { /* size of new coef should always be 1 */ + if (s !is 1) { /* size of new coef should always be 1 */ // WARNMS(cinfo, JWRN_HUFF_BAD_CODE); } // CHECK_BIT_BUFFER(br_state, 1, goto undoit); @@ -1242,7 +1242,7 @@ k += 15; /* skip 15 zeroes in band */ } else { /* EOBr, run length is 2^r + appended bits */ EOBRUN = 1 << r; - if (r !is 0) { /* EOBr, r > 0 */ + if (r !is 0) { /* EOBr, r > 0 */ // CHECK_BIT_BUFFER(br_state, r, return FALSE); { if (bits_left < (r)) { @@ -1280,7 +1280,7 @@ return true; } - bool decode_mcu_DC_first (jpeg_decompress_struct cinfo, short[][] MCU_data) { + bool decode_mcu_DC_first (jpeg_decompress_struct cinfo, short[][] MCU_data) { phuff_entropy_decoder entropy = this; int Al = cinfo.Al; int s = 0, r; @@ -1596,7 +1596,7 @@ * components will be ignored (eg grayscale output from YCbCr image), * we can skip most computations for the unused components. */ - bool component_needed; /* do we need the value of this component? */ + bool component_needed; /* do we need the value of this component? */ /* These values are computed before starting a scan of the component. */ /* The decompressor output side may not use these variables. */ @@ -1634,7 +1634,7 @@ * premultiplied as described above. Since colormap indexes must fit into * JSAMPLEs, the entries of this array will too. */ - bool is_padded; /* is the colorindex padded for odither? */ + bool is_padded; /* is the colorindex padded for odither? */ int[MAX_Q_COMPS] Ncolors;// = new int [MAX_Q_COMPS]; /* # of values alloced to each component */ @@ -1644,7 +1644,7 @@ /* Variables for Floyd-Steinberg dithering */ // FSERRPTR fserrors[MAX_Q_COMPS]; /* accumulated errors */ - bool on_odd_row; + bool on_odd_row; void start_pass (jpeg_decompress_struct cinfo, bool is_pre_scan) { error(); @@ -1661,7 +1661,7 @@ // JDIMENSION *out_row_ctr, // JDIMENSION out_rows_avail)); - bool need_context_rows; /* TRUE if need rows above & below */ + bool need_context_rows; /* TRUE if need rows above & below */ /* Color conversion buffer. When using separate upsampling and color * conversion steps, this buffer holds one upsampled row group until it @@ -1706,8 +1706,8 @@ /* State of marker reader --- nominally internal, but applications * supplying COM or APPn handlers might like to know the state. */ - bool saw_SOI; /* found SOI? */ - bool saw_SOF; /* found SOF? */ + bool saw_SOI; /* found SOI? */ + bool saw_SOF; /* found SOF? */ int next_restart_num; /* next restart number expected (0-7) */ int discarded_bytes; /* # of bytes skipped looking for a marker */ @@ -1734,7 +1734,7 @@ byte[][][MAX_COMPONENTS] buffer;// = new byte[MAX_COMPONENTS][][]; int[MAX_COMPONENTS] buffer_offset;// = new int[MAX_COMPONENTS]; - bool buffer_full; /* Have we gotten an iMCU row from decoder? */ + bool buffer_full; /* Have we gotten an iMCU row from decoder? */ int[1] rowgroup_ctr;// = new int[1]; /* counts row groups output to postprocessor */ /* Remaining fields are only used in the context case. */ @@ -1958,10 +1958,10 @@ static final class jpeg_input_controller { int consume_input; - bool has_multiple_scans; /* True if file has multiple scans */ + bool has_multiple_scans; /* True if file has multiple scans */ bool eoi_reached; - bool inheaders; /* true until first SOS is reached */ + bool inheaders; /* true until first SOS is reached */ } static final class jpeg_color_deconverter { @@ -2050,7 +2050,7 @@ // struct jpeg_memory_mgr * mem; /* Memory manager module */\ // struct jpeg_progress_mgr * progress; /* Progress monitor, or null if none */\ // void * client_data; /* Available for use by application */\ - bool is_decompressor; /* So common code can tell which is which */ + bool is_decompressor; /* So common code can tell which is which */ int global_state; /* For checking call sequence validity */ // /* Source of compressed data */ @@ -2080,22 +2080,22 @@ double output_gamma; /* image gamma wanted in output */ - bool buffered_image; /* true=multiple output passes */ - bool raw_data_out; /* true=downsampled data wanted */ + bool buffered_image; /* true=multiple output passes */ + bool raw_data_out; /* true=downsampled data wanted */ int dct_method; /* IDCT algorithm selector */ - bool do_fancy_upsampling; /* true=apply fancy upsampling */ - bool do_block_smoothing; /* true=apply interblock smoothing */ - - bool quantize_colors; /* true=colormapped output wanted */ + bool do_fancy_upsampling; /* true=apply fancy upsampling */ + bool do_block_smoothing; /* true=apply interblock smoothing */ + + bool quantize_colors; /* true=colormapped output wanted */ /* the following are ignored if not quantize_colors: */ int dither_mode; /* type of color dithering to use */ - bool two_pass_quantize; /* true=use two-pass color quantization */ + bool two_pass_quantize; /* true=use two-pass color quantization */ int desired_number_of_colors; /* max # colors to use in created colormap */ /* these are significant only in buffered-image mode: */ - bool enable_1pass_quant; /* enable future use of 1-pass quantizer */ + bool enable_1pass_quant; /* enable future use of 1-pass quantizer */ bool enable_external_quant;/* enable future use of external colormap */ - bool enable_2pass_quant; /* enable future use of 2-pass quantizer */ + bool enable_2pass_quant; /* enable future use of 2-pass quantizer */ /* Description of actual output image that will be returned to application. * These fields are computed by jpeg_start_decompress(). @@ -2182,8 +2182,8 @@ jpeg_component_info[] comp_info; /* comp_info[i] describes component that appears i'th in SOF */ - bool progressive_mode; /* true if SOFn specifies progressive mode */ - bool arith_code; /* true=arithmetic coding, false=Huffman */ + bool progressive_mode; /* true if SOFn specifies progressive mode */ + bool arith_code; /* true=arithmetic coding, false=Huffman */ byte[NUM_ARITH_TBLS] arith_dc_L;// = new byte[NUM_ARITH_TBLS]; /* L values for DC arith-coding tables */ byte[NUM_ARITH_TBLS] arith_dc_U;// = new byte[NUM_ARITH_TBLS]; /* U values for DC arith-coding tables */ @@ -2194,17 +2194,17 @@ /* These fields record data obtained from optional markers recognized by * the JPEG library. */ - bool saw_JFIF_marker; /* true iff a JFIF APP0 marker was found */ + bool saw_JFIF_marker; /* true iff a JFIF APP0 marker was found */ /* Data copied from JFIF marker; only valid if saw_JFIF_marker is true: */ byte JFIF_major_version; /* JFIF version number */ byte JFIF_minor_version; byte density_unit; /* JFIF code for pixel size units */ short X_density; /* Horizontal pixel density */ short Y_density; /* Vertical pixel density */ - bool saw_Adobe_marker; /* true iff an Adobe APP14 marker was found */ + bool saw_Adobe_marker; /* true iff an Adobe APP14 marker was found */ byte Adobe_transform; /* Color transform code from Adobe marker */ - bool CCIR601_sampling; /* true=first samples are cosited */ + bool CCIR601_sampling; /* true=first samples are cosited */ /* Aside from the specific data retained from APPn markers known to the * library, the uninterpreted contents of any or all APPn and COM markers @@ -4448,7 +4448,7 @@ length -= count; - if ((index & 0x10) !is 0) { /* AC table definition */ + if ((index & 0x10) !is 0) { /* AC table definition */ index -= 0x10; htblptr = cinfo.ac_huff_tbl_ptrs[index] = new JHUFF_TBL(); } else { /* DC table definition */ @@ -5237,7 +5237,7 @@ // GETJOCTET(data[12]), GETJOCTET(data[13])); } totallen -= APP0_DATA_LEN; - if (totallen !is ((data[12] & 0xFF) * (data[13] & 0xFF) * 3)) { + if (totallen !is ((data[12] & 0xFF) * (data[13] & 0xFF) * 3)) { // TRACEMS1(cinfo, 1, JTRC_JFIF_BADTHUMBNAILSIZE, cast(int) totallen); } } else if (datalen >= 6 &&
--- a/dwt/internal/image/JPEGFileFormat.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/internal/image/JPEGFileFormat.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This source file is made available under the terms contained in the README file * accompanying this program. The README file should be located in the about_files directory of the * plug-in that contains this source file.
--- a/dwt/internal/image/LEDataInputStream.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/internal/image/LEDataInputStream.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2007 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at
--- a/dwt/internal/image/OS2BMPFileFormat.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/internal/image/OS2BMPFileFormat.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2005 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at
--- a/dwt/internal/image/PNGFileFormat.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/internal/image/PNGFileFormat.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -176,7 +176,7 @@ if ((signature[4] & 0xFF) !is 13) return false; //<RETURN> if ((signature[5] & 0xFF) !is 10) return false; //<LINEFEED> if ((signature[6] & 0xFF) !is 26) return false; //<CTRL/Z> - if ((signature[7] & 0xFF) !is 10) return false; //<LINEFEED> + if ((signature[7] & 0xFF) !is 10) return false; //<LINEFEED> return true; } catch (Exception e) { return false;
--- a/dwt/internal/image/PngDeflater.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/internal/image/PngDeflater.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at
--- a/dwt/internal/image/PngEncoder.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/internal/image/PngEncoder.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2007 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at
--- a/dwt/internal/image/PngHuffmanTable.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/internal/image/PngHuffmanTable.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at
--- a/dwt/internal/image/PngPlteChunk.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/internal/image/PngPlteChunk.d Sun Jun 29 14:33:38 2008 +0200 @@ -112,7 +112,7 @@ // Palette chunks' data fields must be event multiples // of 3. Each 3-byte group represents an RGB value. - if (getLength() % 3 !is 0) DWT.error(DWT.ERROR_INVALID_IMAGE); + if (getLength() % 3 !is 0) DWT.error(DWT.ERROR_INVALID_IMAGE); // Palettes cannot have more entries than 2^bitDepth // where bitDepth is the bit depth of the image given
--- a/dwt/internal/image/TIFFFileFormat.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/internal/image/TIFFFileFormat.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2005 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at
--- a/dwt/internal/image/WinBMPFileFormat.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/internal/image/WinBMPFileFormat.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at
--- a/dwt/internal/image/WinICOFileFormat.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/internal/image/WinICOFileFormat.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at
--- a/dwt/layout/FillLayout.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/layout/FillLayout.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -49,6 +49,9 @@ * shell.setLayout(fillLayout); * </pre> * </p> + * + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: LayoutExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public final class FillLayout : Layout { /**
--- a/dwt/layout/FormAttachment.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/layout/FormAttachment.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -79,6 +79,7 @@ * * @see FormLayout * @see FormData + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> * * @since 2.0 */ @@ -126,12 +127,12 @@ * </p> * * <br>Possible values are: <ul> - * <li>TOP: Attach the side to the top side of the specified control.</li> - * <li>BOTTOM : Attach the side to the bottom side of the specified control.</li> - * <li>LEFT: Attach the side to the left side of the specified control.</li> - * <li>RIGHT: Attach the side to the right side of the specified control.</li> - * <li>CENTER: Attach the side at a position which will center the control on the specified control.</li> - * <li>DEFAULT: Attach the side to the adjacent side of the specified control.</li> + * <li>{@link DWT#TOP}: Attach the side to the top side of the specified control.</li> + * <li>{@link DWT#BOTTOM}: Attach the side to the bottom side of the specified control.</li> + * <li>{@link DWT#LEFT}: Attach the side to the left side of the specified control.</li> + * <li>{@link DWT#RIGHT}: Attach the side to the right side of the specified control.</li> + * <li>{@link DWT#CENTER}: Attach the side at a position which will center the control on the specified control.</li> + * <li>{@link DWT#DEFAULT}: Attach the side to the adjacent side of the specified control.</li> * </ul> */ public int alignment; @@ -220,11 +221,26 @@ /** * Constructs a new instance of this class given a control, - * an offset and an alignment. + * an offset and an alignment. The possible alignment values are: + * <dl> + * <dt><b>{@link DWT#TOP}</b></dt> + * <dd>the side will be attached to the top side of the specified control</dd> + * <dt><b>{@link DWT#BOTTOM}</b></dt> + * <dd>the side will be attached to the bottom side of the specified control</dd> + * <dt><b>{@link DWT#LEFT}</b></dt> + * <dd>the side will be attached to the left side of the specified control</dd> + * <dt><b>{@link DWT#RIGHT}</b></dt> + * <dd>the side will be attached to the right side of the specified control</dd> + * <dt><b>{@link DWT#CENTER}</b></dt> + * <dd>the side will be centered on the same side of the specified control</dd> + * <dt><b>{@link DWT#DEFAULT}</b></dt> + * <dd>the side will be attached to the adjacent side of the specified control</dd> + * </dl> * * @param control the control the side is attached to * @param offset the offset of the side from the control - * @param alignment the alignment of the side to the control it is attached to + * @param alignment the alignment of the side to the control it is attached to, + * one of TOP, BOTTOM, LEFT, RIGHT, CENTER, or DEFAULT */ public this (Control control, int offset, int alignment) { this.control = control;
--- a/dwt/layout/FormData.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/layout/FormData.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -45,6 +45,7 @@ * * @see FormLayout * @see FormAttachment + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> * * @since 2.0 */
--- a/dwt/layout/FormLayout.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/layout/FormLayout.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -92,9 +92,11 @@ * * @see FormData * @see FormAttachment + * @see <a href="http://www.eclipse.org/swt/snippets/#formlayout">FormLayout snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: LayoutExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> * * @since 2.0 - * */ public final class FormLayout : Layout {
--- a/dwt/layout/GridData.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/layout/GridData.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -48,6 +48,7 @@ * * @see GridLayout * @see Control#setLayoutData + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public final class GridData { /** @@ -425,8 +426,10 @@ /** * Constructs a new instance of GridData according to the parameters. * - * @param horizontalAlignment how control will be positioned horizontally within a cell - * @param verticalAlignment how control will be positioned vertically within a cell + * @param horizontalAlignment how control will be positioned horizontally within a cell, + * one of: DWT.BEGINNING (or DWT.LEFT), DWT.CENTER, DWT.END (or DWT.RIGHT), or DWT.FILL + * @param verticalAlignment how control will be positioned vertically within a cell, + * one of: DWT.BEGINNING (or DWT.TOP), DWT.CENTER, DWT.END (or DWT.BOTTOM), or DWT.FILL * @param grabExcessHorizontalSpace whether cell will be made wide enough to fit the remaining horizontal space * @param grabExcessVerticalSpace whether cell will be made high enough to fit the remaining vertical space * @@ -439,8 +442,10 @@ /** * Constructs a new instance of GridData according to the parameters. * - * @param horizontalAlignment how control will be positioned horizontally within a cell - * @param verticalAlignment how control will be positioned vertically within a cell + * @param horizontalAlignment how control will be positioned horizontally within a cell, + * one of: DWT.BEGINNING (or DWT.LEFT), DWT.CENTER, DWT.END (or DWT.RIGHT), or DWT.FILL + * @param verticalAlignment how control will be positioned vertically within a cell, + * one of: DWT.BEGINNING (or DWT.TOP), DWT.CENTER, DWT.END (or DWT.BOTTOM), or DWT.FILL * @param grabExcessHorizontalSpace whether cell will be made wide enough to fit the remaining horizontal space * @param grabExcessVerticalSpace whether cell will be made high enough to fit the remaining vertical space * @param horizontalSpan the number of column cells that the control will take up
--- a/dwt/layout/GridLayout.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/layout/GridLayout.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -54,6 +54,9 @@ * </p> * * @see GridData + * @see <a href="http://www.eclipse.org/swt/snippets/#gridlayout">GridLayout snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: LayoutExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public final class GridLayout : Layout {
--- a/dwt/layout/RowData.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/layout/RowData.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -37,6 +37,7 @@ * </p> * * @see RowLayout + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public final class RowData { /**
--- a/dwt/layout/RowLayout.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/layout/RowLayout.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -61,6 +61,9 @@ * </p> * * @see RowData + * @see <a href="http://www.eclipse.org/swt/snippets/#rowlayout">RowLayout snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: LayoutExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public final class RowLayout : Layout {
--- a/dwt/opengl/GLCanvas.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/opengl/GLCanvas.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -34,6 +34,10 @@ /** * GLCanvas is a widget capable of displaying OpenGL content. * + * @see GLData + * @see <a href="http://www.eclipse.org/swt/snippets/#opengl">OpenGL snippets</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> + * * @since 3.2 */
--- a/dwt/opengl/GLData.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/opengl/GLData.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2005, 2006 IBM Corporation and others. + * Copyright (c) 2005, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -23,6 +23,8 @@ * of the pixel format attributes of a GL drawable. * * @see GLCanvas + * @see <a href="http://www.eclipse.org/swt/snippets/#opengl">OpenGL snippets</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> * * @since 3.2 */
--- a/dwt/printing/PrintDialog.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/printing/PrintDialog.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -37,6 +37,10 @@ * IMPORTANT: This class is intended to be subclassed <em>only</em> * within the DWT implementation. * </p> + * + * @see <a href="http://www.eclipse.org/swt/snippets/#printing">Printing snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: ControlExample, Dialog tab</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class PrintDialog : Dialog { PrinterData printerData; @@ -159,11 +163,11 @@ * before pressing OK in the dialog. This will be one * of the following values: * <dl> - * <dt><code>ALL_PAGES</code></dt> + * <dt><code>PrinterData.ALL_PAGES</code></dt> * <dd>Print all pages in the current document</dd> - * <dt><code>PAGE_RANGE</code></dt> + * <dt><code>PrinterData.PAGE_RANGE</code></dt> * <dd>Print the range of pages specified by startPage and endPage</dd> - * <dt><code>SELECTION</code></dt> + * <dt><code>PrinterData.SELECTION</code></dt> * <dd>Print the current selection</dd> * </dl> * @@ -178,11 +182,11 @@ * setting when the dialog is opened. This can have one of * the following values: * <dl> - * <dt><code>ALL_PAGES</code></dt> + * <dt><code>PrinterData.ALL_PAGES</code></dt> * <dd>Print all pages in the current document</dd> - * <dt><code>PAGE_RANGE</code></dt> + * <dt><code>PrinterData.PAGE_RANGE</code></dt> * <dd>Print the range of pages specified by startPage and endPage</dd> - * <dt><code>SELECTION</code></dt> + * <dt><code>PrinterData.SELECTION</code></dt> * <dd>Print the current selection</dd> * </dl> * @@ -197,7 +201,7 @@ * before pressing OK in the dialog. * <p> * This value can be from 1 to the maximum number of pages for the platform. - * Note that it is only valid if the scope is <code>PAGE_RANGE</code>. + * Note that it is only valid if the scope is <code>PrinterData.PAGE_RANGE</code>. * </p> * * @return the start page setting that the user selected @@ -211,7 +215,7 @@ * is opened. * <p> * This value can be from 1 to the maximum number of pages for the platform. - * Note that it is only valid if the scope is <code>PAGE_RANGE</code>. + * Note that it is only valid if the scope is <code>PrinterData.PAGE_RANGE</code>. * </p> * * @param startPage the startPage setting when the dialog is opened @@ -225,7 +229,7 @@ * before pressing OK in the dialog. * <p> * This value can be from 1 to the maximum number of pages for the platform. - * Note that it is only valid if the scope is <code>PAGE_RANGE</code>. + * Note that it is only valid if the scope is <code>PrinterData.PAGE_RANGE</code>. * </p> * * @return the end page setting that the user selected @@ -239,7 +243,7 @@ * is opened. * <p> * This value can be from 1 to the maximum number of pages for the platform. - * Note that it is only valid if the scope is <code>PAGE_RANGE</code>. + * Note that it is only valid if the scope is <code>PrinterData.PAGE_RANGE</code>. * </p> * * @param endPage the end page setting when the dialog is opened
--- a/dwt/printing/Printer.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/printing/Printer.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -51,6 +51,8 @@ * * @see PrinterData * @see PrintDialog + * @see <a href="http://www.eclipse.org/swt/snippets/#printing">Printing snippets</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public final class Printer : Device { static PrinterData [] printerList; @@ -611,7 +613,9 @@ /** * Returns a rectangle describing the receiver's size and location. - * For a printer, this is the size of a physical page, in pixels. + * <p> + * For a printer, this is the size of the physical page, in pixels. + * </p> * * @return the bounding rectangle * @@ -633,8 +637,10 @@ /** * Returns a rectangle which describes the area of the * receiver which is capable of displaying data. + * <p> * For a printer, this is the size of the printable area - * of a page, in pixels. + * of the page, in pixels. + * </p> * * @return the client area * @@ -654,28 +660,32 @@ } /** - * Given a desired <em>client area</em> for the receiver - * (as described by the arguments), returns the bounding - * rectangle which would be required to produce that client - * area. + * Given a <em>client area</em> (as described by the arguments), + * returns a rectangle, relative to the client area's coordinates, + * that is the client area expanded by the printer's trim (or minimum margins). * <p> - * In other words, it returns a rectangle such that, if the - * receiver's bounds were set to that rectangle, the area - * of the receiver which is capable of displaying data - * (that is, not covered by the "trimmings") would be the - * rectangle described by the arguments (relative to the - * receiver's parent). - * </p><p> - * Note that there is no setBounds for a printer. This method - * is usually used by passing in the client area (the 'printable - * area') of the printer. It can also be useful to pass in 0, 0, 0, 0. + * Most printers have a minimum margin on each edge of the paper where the + * printer device is unable to print. This margin is known as the "trim." + * This method can be used to calculate the printer's minimum margins + * by passing in a client area of 0, 0, 0, 0 and then using the resulting + * x and y coordinates (which will be <= 0) to determine the minimum margins + * for the top and left edges of the paper, and the resulting width and height + * (offset by the resulting x and y) to determine the minimum margins for the + * bottom and right edges of the paper, as follows: + * <ul> + * <li>The left trim width is -x pixels</li> + * <li>The top trim height is -y pixels</li> + * <li>The right trim width is (x + width) pixels</li> + * <li>The bottom trim height is (y + height) pixels</li> + * </ul> * </p> * - * @param x the desired x coordinate of the client area - * @param y the desired y coordinate of the client area - * @param width the desired width of the client area - * @param height the desired height of the client area - * @return the required bounds to produce the given client area + * @param x the x coordinate of the client area + * @param y the y coordinate of the client area + * @param width the width of the client area + * @param height the height of the client area + * @return a rectangle, relative to the client area's coordinates, that is + * the client area expanded by the printer's trim (or minimum margins) * * @exception DWTException <ul> * <li>ERROR_DEVICE_DISPOSED - if the receiver has been disposed</li>
--- a/dwt/printing/PrinterData.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/printing/PrinterData.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -35,6 +35,8 @@ * @see Printer * @see Printer#getPrinterList * @see PrintDialog#open + * @see <a href="http://www.eclipse.org/swt/snippets/#printing">Printing snippets</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public final class PrinterData : DeviceData {
--- a/dwt/program/Program.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/program/Program.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -174,6 +174,9 @@ * Instances of this class represent programs and * their associated file extensions in the operating * system. + * + * @see <a href="http://www.eclipse.org/swt/snippets/#program">Program snippets</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public final class Program { String name; @@ -833,13 +836,12 @@ } /** - * Launches the executable associated with the file in - * the operating system. If the file is an executable, - * then the executable is launched. Note that a <code>Display</code> - * must already exist to guarantee that this method returns - * an appropriate result. + * Launches the operating system executable associated with the file or + * URL (http:// or https://). If the file is an executable then the + * executable is launched. Note that a <code>Display</code> must already + * exist to guarantee that this method returns an appropriate result. * - * @param fileName the file or program name + * @param fileName the file or program name or URL (http:// or https://) * @return <code>true</code> if the file is launched, otherwise <code>false</code> * * @exception IllegalArgumentException <ul>
--- a/dwt/widgets/Button.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/Button.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -50,6 +50,10 @@ * IMPORTANT: This class is intended to be subclassed <em>only</em> * within the DWT implementation. * </p> + * + * @see <a href="http://www.eclipse.org/swt/snippets/#button">Button snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: ControlExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class Button : Control { @@ -311,6 +315,20 @@ return DWT.LEFT; } +/** + * Returns <code>true</code> if the receiver is grayed, + * and false otherwise. When the widget does not have + * the <code>CHECK</code> style, return false. + * + * @return the grayed state of the checkbox + * + * @exception DWTException <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.4 + */ public bool getGrayed () { checkWidget(); if ((style & DWT.CHECK) is 0) return false; @@ -658,6 +676,20 @@ if (imageHandle !is null) setForegroundColor (imageHandle, color); } +/** + * Sets the grayed state of the receiver. This state change + * only applies if the control was created with the DWT.CHECK + * style. + * + * @param grayed the new grayed state + * + * @exception DWTException <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.4 + */ public void setGrayed (bool grayed) { checkWidget(); if ((style & DWT.CHECK) is 0) return;
--- a/dwt/widgets/Canvas.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/Canvas.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -42,6 +42,9 @@ * </p> * * @see Composite + * @see <a href="http://www.eclipse.org/swt/snippets/#canvas">Canvas snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: ControlExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class Canvas : Composite { @@ -122,7 +125,7 @@ * drawing in the window any other time. * </p> * - * @return the caret + * @return the caret for the receiver, may be null * * @exception DWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> @@ -139,6 +142,18 @@ return new Point (caret.x, caret.y); } +/** + * Returns the IME. + * + * @return the IME + * + * @exception DWTException <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.4 + */ public IME getIME () { checkWidget (); return ime; @@ -369,6 +384,21 @@ super.setFont (font); } +/** + * Sets the receiver's IME. + * + * @param ime the new IME for the receiver, may be null + * + * @exception IllegalArgumentException <ul> + * <li>ERROR_INVALID_ARGUMENT - if the IME has been disposed</li> + * </ul> + * @exception DWTException <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.4 + */ public void setIME (IME ime) { checkWidget (); if (ime !is null && ime.isDisposed()) error(DWT.ERROR_INVALID_ARGUMENT);
--- a/dwt/widgets/Caret.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/Caret.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2005 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -34,6 +34,10 @@ * IMPORTANT: This class is intended to be subclassed <em>only</em> * within the DWT implementation. * </p> + * + * @see <a href="http://www.eclipse.org/swt/snippets/#caret">Caret snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: ControlExample, Canvas tab</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class Caret : Widget { Canvas parent;
--- a/dwt/widgets/ColorDialog.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/ColorDialog.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -36,6 +36,9 @@ * IMPORTANT: This class is intended to be subclassed <em>only</em> * within the DWT implementation. * </p> + * + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: ControlExample, Dialog tab</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class ColorDialog : Dialog { RGB rgb;
--- a/dwt/widgets/Combo.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/Combo.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -62,6 +62,9 @@ * </p> * * @see List + * @see <a href="http://www.eclipse.org/swt/snippets/#combo">Combo snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: ControlExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class Combo : Composite { @@ -905,6 +908,25 @@ return result; } +/** + * Returns <code>true</code> if the receiver's list is visible, + * and <code>false</code> otherwise. + * <p> + * If one of the receiver's ancestors is not visible or some + * other condition makes the receiver not visible, this method + * may still indicate that it is considered visible even though + * it may not actually be showing. + * </p> + * + * @return the receiver's list's visibility state + * + * @exception DWTException <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.4 + */ public bool getListVisible () { checkWidget (); if (OS.GTK_VERSION >= OS.buildVERSION (2, 4, 0)) { @@ -1929,6 +1951,24 @@ } } +/** + * Marks the receiver's list as visible if the argument is <code>true</code>, + * and marks it invisible otherwise. + * <p> + * If one of the receiver's ancestors is not visible or some + * other condition makes the receiver not visible, marking + * it visible may not actually cause it to be displayed. + * </p> + * + * @param visible the new visibility state + * + * @exception DWTException <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.4 + */ public void setListVisible (bool visible) { checkWidget (); if (OS.GTK_VERSION >= OS.buildVERSION (2, 4, 0)) {
--- a/dwt/widgets/Composite.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/Composite.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -63,6 +63,8 @@ * </p> * * @see Canvas + * @see <a href="http://www.eclipse.org/swt/snippets/#composite">Composite snippets</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class Composite : Scrollable {
--- a/dwt/widgets/Control.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/Control.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -78,6 +78,10 @@ * IMPORTANT: This class is intended to be subclassed <em>only</em> * within the DWT implementation. * </p> + * + * @see <a href="http://www.eclipse.org/swt/snippets/#control">Control snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: ControlExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public abstract class Control : Widget, Drawable { @@ -331,6 +335,23 @@ return OS.GTK_WIDGET_WINDOW (paintHandle); } +/** + * Prints the receiver and all children. + * + * @param gc the gc where the drawing occurs + * @return <code>true</code> if the operation was successful and <code>false</code> otherwise + * + * @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 DWTException <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.4 + */ public bool print (GC gc) { checkWidget (); if (gc is null) error (DWT.ERROR_NULL_ARGUMENT); @@ -970,9 +991,25 @@ setBounds (0, 0, Math.max (0, size.x), Math.max (0, size.y), false, true); } +/** + * Sets the shape of the control to the region specified + * by the argument. When the argument is null, the + * default shape of the control is restored. + * + * @param region the region that defines the shape of the control (or null) + * + * @exception IllegalArgumentException <ul> + * <li>ERROR_INVALID_ARGUMENT - if the region has been disposed</li> + * </ul> + * @exception DWTException <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.4 + */ public void setRegion (Region region) { checkWidget (); - if ((style & DWT.NO_TRIM) is 0) return; if (region !is null && region.isDisposed()) error (DWT.ERROR_INVALID_ARGUMENT); auto window = OS.GTK_WIDGET_WINDOW (topHandle ()); auto shape_region = (region is null) ? null : region.handle; @@ -2210,7 +2247,9 @@ * When the mouse pointer passes over a control its appearance * is changed to match the control's cursor. * </p> - * </ul> + * + * @return the receiver's cursor or <code>null</code> + * * @exception DWTException <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> @@ -2430,6 +2469,19 @@ return result; } +/** + * Returns the region that defines the shape of the control, + * or null if the control has the default shape. + * + * @return the region that defines the shape of the shell (or null) + * + * @exception DWTException <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.4 + */ public Region getRegion () { checkWidget (); return region; @@ -3440,7 +3492,8 @@ /** * If the argument is <code>true</code>, causes the receiver to have * all mouse events delivered to it until the method is called with - * <code>false</code> as the argument. + * <code>false</code> as the argument. Note that on some platforms, + * a mouse button must currently be down for capture to be assigned. * * @param capture <code>true</code> to capture the mouse, and <code>false</code> to release it * @@ -3563,18 +3616,17 @@ OS.gtk_widget_realize (handle); auto parentHandle = parent.eventHandle (); auto window = parent.eventWindow(); - Rectangle rect = getBounds (); + auto topHandle_ = topHandle (); GdkWindowAttr attributes; - attributes.x = rect.x; - attributes.y = rect.y; - attributes.width = rect.width; - attributes.height = rect.height; + attributes.x = OS.GTK_WIDGET_X (topHandle_); + attributes.y = OS.GTK_WIDGET_Y (topHandle_); + attributes.width = (state & ZERO_WIDTH) !is 0 ? 0 : OS.GTK_WIDGET_WIDTH (topHandle_); + attributes.height = (state & ZERO_HEIGHT) !is 0 ? 0 : OS.GTK_WIDGET_HEIGHT (topHandle_); attributes.event_mask = (0xFFFFFFFF & ~OS.ExposureMask); attributes.wclass = OS.GDK_INPUT_ONLY; attributes.window_type = OS.GDK_WINDOW_CHILD; enableWindow = OS.gdk_window_new (window, &attributes, OS.GDK_WA_X | OS.GDK_WA_Y); if (enableWindow !is null) { - auto topHandle_ = topHandle (); OS.gdk_window_set_user_data (enableWindow, parentHandle); if (!OS.GDK_WINDOWING_X11 ()) { OS.gdk_window_raise (enableWindow);
--- a/dwt/widgets/CoolBar.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/CoolBar.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -49,6 +49,10 @@ * </p><p> * IMPORTANT: This class is <em>not</em> intended to be subclassed. * </p> + * + * @see <a href="http://www.eclipse.org/swt/snippets/#coolbar">CoolBar snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: ControlExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class CoolBar : Composite {
--- a/dwt/widgets/CoolItem.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/CoolItem.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -47,6 +47,8 @@ * <p> * IMPORTANT: This class is <em>not</em> intended to be subclassed. * </p> + * + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class CoolItem : Item { Control control;
--- a/dwt/widgets/DateTime.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/DateTime.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -371,6 +371,10 @@ * </p><p> * IMPORTANT: This class is <em>not</em> intended to be subclassed. * </p> + * + * @see <a href="http://www.eclipse.org/swt/snippets/#datetime">DateTime snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: ControlExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> * * @since 3.3 */
--- a/dwt/widgets/Decorations.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/Decorations.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -104,6 +104,7 @@ * @see #getMaximized * @see Shell * @see DWT + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class Decorations : Canvas {
--- a/dwt/widgets/Dialog.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/Dialog.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2005 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -79,6 +79,8 @@ * </p> * * @see Shell + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: ControlExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public abstract class Dialog {
--- a/dwt/widgets/DirectoryDialog.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/DirectoryDialog.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -39,6 +39,10 @@ * IMPORTANT: This class is intended to be subclassed <em>only</em> * within the DWT implementation. * </p> + * + * @see <a href="http://www.eclipse.org/swt/snippets/#directorydialog">DirectoryDialog snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: ControlExample, Dialog tab</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class DirectoryDialog : Dialog { String message = "", filterPath = "";
--- a/dwt/widgets/Display.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/Display.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -124,6 +124,8 @@ * @see #readAndDispatch * @see #sleep * @see Device#dispose + * @see <a href="http://www.eclipse.org/swt/snippets/#display">Display snippets</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class Display : Device { @@ -1399,7 +1401,8 @@ } /** - * Returns a rectangle describing the receiver's size and location. + * Returns a rectangle describing the receiver's size and location. Note that + * on multi-monitor systems the origin can be negative. * * @return the bounding rectangle * @@ -1483,7 +1486,7 @@ if ((xWindow = buffer) !is 0) { xParent = xWindow; auto gdkWindow = OS.gdk_window_lookup (xWindow); - if (gdkWindow !is null) { + if (gdkWindow !is null) { OS.gdk_window_get_user_data (gdkWindow, cast(void**)&user_data); if (user_data !is null) handle = user_data; } @@ -3318,7 +3321,7 @@ * is one of the event constants defined in class <code>DWT</code>. * * @param eventType the type of event to listen for - * @param listener the listener which should no longer be notified when the event occurs + * @param listener the listener which should no longer be notified * * @exception IllegalArgumentException <ul> * <li>ERROR_NULL_ARGUMENT - if the listener is null</li>
--- a/dwt/widgets/Event.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/Event.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -35,6 +35,8 @@ * * @see Listener * @see dwt.events.TypedEvent + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: ControlExample, Listeners</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class Event { @@ -173,7 +175,8 @@ /** * depending on the event, the range of text being modified. - * Setting these fields has no effect. + * Setting these fields only has effect during ImeComposition + * events. */ public int start, end;
--- a/dwt/widgets/EventTable.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/EventTable.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at
--- a/dwt/widgets/ExpandBar.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/ExpandBar.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -52,6 +52,9 @@ * @see ExpandEvent * @see ExpandListener * @see ExpandAdapter + * @see <a href="http://www.eclipse.org/swt/snippets/#expandbar">ExpandBar snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: ControlExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> * * @since 3.2 */ @@ -672,6 +675,8 @@ /** * Sets the receiver's spacing. Spacing specifies the number of pixels allocated around * each item. + * + * @param spacing the spacing around each item * * @exception DWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
--- a/dwt/widgets/ExpandItem.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/ExpandItem.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -47,6 +47,7 @@ * </p> * * @see ExpandBar + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> * * @since 3.2 */
--- a/dwt/widgets/FileDialog.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/FileDialog.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -41,6 +41,10 @@ * IMPORTANT: This class is intended to be subclassed <em>only</em> * within the DWT implementation. * </p> + * + * @see <a href="http://www.eclipse.org/swt/snippets/#filedialog">FileDialog snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: ControlExample, Dialog tab</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class FileDialog : Dialog { String [] filterNames; @@ -593,8 +597,10 @@ * which may be null. * <p> * The strings are platform specific. For example, on - * Windows, an extension filter string is typically of - * the form "*.extension", where "*.*" matches all files. + * some platforms, an extension filter string is typically + * of the form "*.extension", where "*.*" matches all files. + * For filters with multiple extensions, use semicolon as + * a separator, e.g. "*.jpg;*.png". * </p> * * @param extensions the file extension filter @@ -625,7 +631,7 @@ filterIndex = index; } /** - * Sets the the names that describe the filter extensions + * Sets the names that describe the filter extensions * which the dialog will use to filter the files it shows * to the argument, which may be null. * <p>
--- a/dwt/widgets/FontDialog.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/FontDialog.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -38,6 +38,9 @@ * IMPORTANT: This class is intended to be subclassed <em>only</em> * within the DWT implementation. * </p> + * + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: ControlExample, Dialog tab</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class FontDialog : Dialog { FontData fontData;
--- a/dwt/widgets/Group.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/Group.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -42,6 +42,9 @@ * </p><p> * IMPORTANT: This class is <em>not</em> intended to be subclassed. * </p> + * + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: ControlExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class Group : Composite {
--- a/dwt/widgets/IME.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/IME.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2007 IBM Corporation and others. + * Copyright (c) 2007, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -12,6 +12,7 @@ import dwt.DWT; +import dwt.DWTException; import dwt.graphics.Color; import dwt.graphics.TextStyle; import dwt.internal.Converter; @@ -21,8 +22,26 @@ import dwt.widgets.Canvas; import dwt.widgets.Event; -import dwt.dwthelper.utils; - +/** + * Instances of this class represent input method editors. + * These are typically in-line pre-edit text areas that allow + * the user to compose characters from Far Eastern languages + * such as Japanese, Chinese or Korean. + * + * <dl> + * <dt><b>Styles:</b></dt> + * <dd>(none)</dd> + * <dt><b>Events:</b></dt> + * <dd>ImeComposition</dd> + * </dl> + * <p> + * IMPORTANT: This class is <em>not</em> intended to be subclassed. + * </p> + * + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> + * + * @since 3.4 + */ public class IME : Widget { Canvas parent; int caretOffset; @@ -40,8 +59,31 @@ } /** + * Constructs a new instance of this class given its parent + * and a style value describing its behavior and appearance. + * <p> + * The style value is either one of the style constants defined in + * class <code>DWT</code> which is applicable to instances of this + * class, 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>DWT</code> style constants. The class description + * lists the style constants that are applicable to the class. + * Style bits are also inherited from superclasses. + * </p> * - * @see DWT + * @param parent a canvas control which will be the parent of the new instance (cannot be null) + * @param style the style of control to construct + * + * @exception IllegalArgumentException <ul> + * <li>ERROR_NULL_ARGUMENT - if the parent is null</li> + * </ul> + * @exception DWTException <ul> + * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the parent</li> + * <li>ERROR_INVALID_SUBCLASS - if this class is not an allowed subclass</li> + * </ul> + * + * @see Widget#checkSubclass + * @see Widget#getStyle */ public this (Canvas parent, int style) { super (parent, style); @@ -57,21 +99,78 @@ } } +/** + * Returns the offset of the caret from the start of the document. + * The caret is within the current composition. + * + * @return the caret offset + * + * @exception DWTException <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> + */ public int getCaretOffset () { checkWidget (); return startOffset + caretOffset; } +/** + * Returns the commit count of the composition. This is the + * number of characters that have been composed. When the + * commit count is equal to the length of the composition + * text, then the in-line edit operation is complete. + * + * @return the commit count + * + * @exception DWTException <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 IME#getText + */ public int getCommitCount () { checkWidget (); return commitCount; } +/** + * Returns the offset of the composition from the start of the document. + * This is the start offset of the composition within the document and + * in not changed by the input method editor itself during the in-line edit + * session. + * + * @return the offset of the composition + * + * @exception DWTException <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> + */ public int getCompositionOffset () { checkWidget (); return startOffset; } +/** + * Returns the ranges for the style that should be applied during the + * in-line edit session. + * <p> + * The ranges array contains start and end pairs. Each pair refers to + * the corresponding style in the styles array. For example, the pair + * that starts at ranges[n] and ends at ranges[n+1] uses the style + * at styles[n/2] returned by <code>getStyles()</code>. + * </p> + * @return the ranges for the styles + * + * @exception DWTException <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 IME#getStyles + */ public int [] getRanges () { checkWidget (); if (ranges is null) return new int [0]; @@ -82,6 +181,24 @@ return result; } +/** + * Returns the styles for the ranges. + * <p> + * The ranges array contains start and end pairs. Each pair refers to + * the corresponding style in the styles array. For example, the pair + * that starts at ranges[n] and ends at ranges[n+1] uses the style + * at styles[n/2]. + * </p> + * + * @return the ranges for the styles + * + * @exception DWTException <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 IME#getRanges + */ public TextStyle [] getStyles () { checkWidget (); if (styles is null) return new TextStyle [0]; @@ -90,11 +207,40 @@ return result; } +/** + * Returns the composition text. + * <p> + * The text for an IME is the characters in the widget that + * are in the current composition. When the commit count is + * equal to the length of the composition text, then the + * in-line edit operation is complete. + * </p> + * + * @return the widget text + * + * @exception DWTException <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> + */ public String getText () { checkWidget (); return text; } +/** + * Returns <code>true</code> if the caret should be wide, and + * <code>false</code> otherwise. In some languages, for example + * Korean, the caret is typically widened to the width of the + * current character in the in-line edit session. + * + * @return the wide caret state + * + * @exception DWTException <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> + */ public bool getWideCaret () { checkWidget (); return false; @@ -258,6 +404,22 @@ ranges = null; } +/** + * Sets the offset of the composition from the start of the document. + * This is the start offset of the composition within the document and + * in not changed by the input method editor itself during the in-line edit + * session but may need to be changed by clients of the IME. For example, + * if during an in-line edit operation, a text editor inserts characters + * above the IME, then the IME must be informed that the composition + * offset has changed. + * + * @return the offset of the composition + * + * @exception DWTException <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> + */ public void setCompositionOffset (int offset) { checkWidget (); if (offset < 0) return;
--- a/dwt/widgets/Item.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/Item.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -29,6 +29,8 @@ * <dt><b>Events:</b></dt> * <dd>(none)</dd> * </dl> + * + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public abstract class Item : Widget {
--- a/dwt/widgets/Label.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/Label.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -28,6 +28,12 @@ * user interface object that displays a string or image. * When SEPARATOR is specified, displays a single * vertical or horizontal line. + * <p> + * Shadow styles are hints and may not be honoured + * by the platform. To create a separator label + * with the default shadow style for the platform, + * do not specify a shadow style. + * </p> * <dl> * <dt><b>Styles:</b></dt> * <dd>SEPARATOR, HORIZONTAL, VERTICAL</dd> @@ -44,6 +50,10 @@ * IMPORTANT: This class is intended to be subclassed <em>only</em> * within the DWT implementation. * </p> + * + * @see <a href="http://www.eclipse.org/swt/snippets/#label">Label snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: ControlExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class Label : Control { @@ -220,24 +230,7 @@ OS.gtk_label_set_line_wrap_mode (labelHandle, OS.PANGO_WRAP_WORD_CHAR); } } - if ((style & DWT.LEFT) !is 0) { - OS.gtk_misc_set_alignment (cast(GtkMisc*)labelHandle, 0.0f, 0.0f); - OS.gtk_label_set_justify (cast(GtkLabel*)labelHandle, OS.GTK_JUSTIFY_LEFT); - OS.gtk_misc_set_alignment (cast(GtkMisc*)imageHandle, 0.0f, 0.5f); - return; - } - if ((style & DWT.CENTER) !is 0) { - OS.gtk_misc_set_alignment (cast(GtkMisc*)labelHandle, 0.5f, 0.0f); - OS.gtk_label_set_justify (cast(GtkLabel*)labelHandle, OS.GTK_JUSTIFY_CENTER); - OS.gtk_misc_set_alignment (cast(GtkMisc*)imageHandle, 0.5f, 0.5f); - return; - } - if ((style & DWT.RIGHT) !is 0) { - OS.gtk_misc_set_alignment (cast(GtkMisc*)labelHandle, 1.0f, 0.0f); - OS.gtk_label_set_justify (cast(GtkLabel*)labelHandle, OS.GTK_JUSTIFY_RIGHT); - OS.gtk_misc_set_alignment (cast(GtkMisc*)imageHandle, 1.0f, 0.5f); - return; - } + setAlignment (); } override void createWidget (int index) { @@ -407,7 +400,21 @@ if ((alignment & (DWT.LEFT | DWT.RIGHT | DWT.CENTER)) is 0) return; style &= ~(DWT.LEFT | DWT.RIGHT | DWT.CENTER); style |= alignment & (DWT.LEFT | DWT.RIGHT | DWT.CENTER); + setAlignment (); +} + +void setAlignment () { bool isRTL = (style & DWT.RIGHT_TO_LEFT) !is 0; + if (text !is null && text.length () !is 0) { + if (OS.GTK_VERSION >= OS.VERSION(2, 4, 0)) { + auto layout = OS.gtk_label_get_layout (labelHandle); + auto linePtr = OS.pango_layout_get_line (layout, 0); + int resolved_dir = OS.pango_layout_line_get_resolved_dir (linePtr); + if (resolved_dir is OS.PANGO_DIRECTION_RTL) { + isRTL = !isRTL; + } + } + } if ((style & DWT.LEFT) !is 0) { OS.gtk_misc_set_alignment (cast(GtkMisc*)labelHandle, 0.0f, 0.0f); OS.gtk_label_set_justify (cast(GtkLabel*)labelHandle, isRTL ? OS.GTK_JUSTIFY_RIGHT : OS.GTK_JUSTIFY_LEFT); @@ -500,12 +507,6 @@ if ((style & DWT.RIGHT_TO_LEFT) !is 0) { if (labelHandle !is null) OS.gtk_widget_set_direction (labelHandle, OS.GTK_TEXT_DIR_RTL); if (imageHandle !is null) OS.gtk_widget_set_direction (imageHandle, OS.GTK_TEXT_DIR_RTL); - if ((style & DWT.LEAD) !is 0) { - if (labelHandle !is null) OS.gtk_label_set_justify (cast(GtkLabel*)labelHandle, OS.GTK_JUSTIFY_RIGHT); - } - if ((style & DWT.TRAIL) !is 0) { - if (labelHandle !is null) OS.gtk_label_set_justify (cast(GtkLabel*)labelHandle, OS.GTK_JUSTIFY_LEFT); - } } } @@ -577,6 +578,7 @@ OS.gtk_label_set_text_with_mnemonic (cast(GtkLabel*)labelHandle, chars.toStringzValidPtr()); OS.gtk_widget_hide (imageHandle); OS.gtk_widget_show (labelHandle); + setAlignment (); } override void showWidget () {
--- a/dwt/widgets/Layout.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/Layout.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2005 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -23,7 +23,8 @@ * This class is the abstract base class for * layouts. * - * @see Composite#setLayout(Layout) + * @see Composite#setLayout(Layout) + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public abstract class Layout {
--- a/dwt/widgets/Link.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/Link.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -61,6 +61,10 @@ * IMPORTANT: This class is <em>not</em> intended to be subclassed. * </p> * + * @see <a href="http://www.eclipse.org/swt/snippets/#link">Link snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: ControlExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> + * * @since 3.1 */ public class Link : Control { @@ -302,6 +306,10 @@ return rects; } +int getClientWidth () { + return (state & ZERO_WIDTH) !is 0 ? 0 : OS.GTK_WIDGET_WIDTH (handle); +} + /** * Returns the receiver's text, which will be an empty * string if it has never been set. @@ -325,6 +333,7 @@ if (focusIndex !is -1) setFocus (); int x = cast(int) gdkEvent.x; int y = cast(int) gdkEvent.y; + if ((style & DWT.MIRRORED) !is 0) x = getClientWidth () - x; int offset = layout.getOffset (x, y, null); int oldSelectionX = selection.x; int oldSelectionY = selection.y; @@ -361,6 +370,7 @@ if (gdkEvent.button is 1) { int x = cast(int) gdkEvent.x; int y = cast(int) gdkEvent.y; + if ((style & DWT.MIRRORED) !is 0) x = getClientWidth () - x; Rectangle [] rects = getRectangles (focusIndex); for (int i = 0; i < rects.length; i++) { Rectangle rect = rects [i]; @@ -459,6 +469,7 @@ if (result !is 0) return result; int x = cast(int) gdkEvent.x; int y = cast(int) gdkEvent.y; + if ((style & DWT.MIRRORED) !is 0) x = getClientWidth () - x; if ((gdkEvent.state & OS.GDK_BUTTON1_MASK) !is 0) { int oldSelection = selection.y; selection.y = layout.getOffset (x, y, null); @@ -490,9 +501,9 @@ override void releaseWidget () { super.releaseWidget (); - if (layout !is null) layout.dispose (); + if (layout !is null) layout.dispose (); layout = null; - if (linkColor !is null) linkColor.dispose (); + if (linkColor !is null) linkColor.dispose (); linkColor = null; if (disabledColor !is null) disabledColor.dispose (); disabledColor = null;
--- a/dwt/widgets/List.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/List.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -44,6 +44,10 @@ * </p><p> * IMPORTANT: This class is <em>not</em> intended to be subclassed. * </p> + * + * @see <a href="http://www.eclipse.org/swt/snippets/#list">List snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: ControlExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class List : Scrollable {
--- a/dwt/widgets/Menu.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/Menu.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -44,6 +44,10 @@ * </p><p> * IMPORTANT: This class is <em>not</em> intended to be subclassed. * </p> + * + * @see <a href="http://www.eclipse.org/swt/snippets/#menu">Menu snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: ControlExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class Menu : Widget { int x, y; @@ -59,6 +63,11 @@ * Constructs a new instance of this class given its parent, * and sets the style for the instance so that the instance * will be a popup menu on the given parent's shell. + * <p> + * After constructing a menu, it can be set into its parent + * using <code>parent.setMenu(menu)</code>. In this case, the parent may + * be any control in the same widget tree as the parent. + * </p> * * @param parent a control which will be the parent of the new instance (cannot be null) * @@ -90,6 +99,9 @@ * of those <code>DWT</code> style constants. The class description * lists the style constants that are applicable to the class. * Style bits are also inherited from superclasses. + * </p><p> + * After constructing a menu or menuBar, it can be set into its parent + * using <code>parent.setMenu(menu)</code> or <code>parent.setMenuBar(menuBar)</code>. * </p> * * @param parent a decorations control which will be the parent of the new instance (cannot be null) @@ -120,6 +132,10 @@ * (which must be a <code>Menu</code>) and sets the style * for the instance so that the instance will be a drop-down * menu on the given parent's parent. + * <p> + * After constructing a drop-down menu, it can be set into its parentMenu + * using <code>parentMenu.setMenu(menu)</code>. + * </p> * * @param parentMenu a menu which will be the parent of the new instance (cannot be null) * @@ -144,6 +160,10 @@ * (which must be a <code>MenuItem</code>) and sets the style * for the instance so that the instance will be a drop-down * menu on the given parent's parent menu. + * <p> + * After constructing a drop-down menu, it can be set into its parentItem + * using <code>parentItem.setMenu(menu)</code>. + * </p> * * @param parentItem a menu item which will be the parent of the new instance (cannot be null) *
--- a/dwt/widgets/MenuItem.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/MenuItem.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -46,6 +46,8 @@ * </p><p> * IMPORTANT: This class is <em>not</em> intended to be subclassed. * </p> + * + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class MenuItem : Item { Menu parent, menu;
--- a/dwt/widgets/MessageBox.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/MessageBox.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -43,6 +43,9 @@ * IMPORTANT: This class is intended to be subclassed <em>only</em> * within the DWT implementation. * </p> + * + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: ControlExample, Dialog tab</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class MessageBox : Dialog {
--- a/dwt/widgets/Monitor.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/Monitor.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2005 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -18,6 +18,8 @@ * Instances of this class are descriptions of monitors. * * @see Display + * @see <a href="http://www.eclipse.org/swt/snippets/#monitor">Monitor snippets</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> * * @since 3.0 */
--- a/dwt/widgets/ProgressBar.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/ProgressBar.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -41,6 +41,10 @@ * IMPORTANT: This class is intended to be subclassed <em>only</em> * within the DWT implementation. * </p> + * + * @see <a href="http://www.eclipse.org/swt/snippets/#progressbar">ProgressBar snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: ControlExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class ProgressBar : Control { CallbackData callbackData; @@ -146,6 +150,23 @@ return selection; } +/** + * Returns the state of the receiver. The value will be one of: + * <ul> + * <li>{@link DWT#NORMAL}</li> + * <li>{@link DWT#ERROR}</li> + * <li>{@link DWT#PAUSED}</li> + * </ul> + * + * @return the state + * + * @exception DWTException <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.4 + */ public int getState () { checkWidget (); return DWT.NORMAL; @@ -239,6 +260,23 @@ updateBar (selection, minimum, maximum); } +/** + * Sets the state of the receiver. The state must be one of these values: + * <ul> + * <li>{@link DWT#NORMAL}</li> + * <li>{@link DWT#ERROR}</li> + * <li>{@link DWT#PAUSED}</li> + * </ul> + * + * @param state the new state + * + * @exception DWTException <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.4 + */ public void setState (int state) { checkWidget (); //NOT IMPLEMENTED
--- a/dwt/widgets/Sash.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/Sash.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -45,6 +45,10 @@ * IMPORTANT: This class is intended to be subclassed <em>only</em> * within the DWT implementation. * </p> + * + * @see <a href="http://www.eclipse.org/swt/snippets/#sash">Sash snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: ControlExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class Sash : Control {
--- a/dwt/widgets/Scale.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/Scale.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -38,6 +38,10 @@ * IMPORTANT: This class is intended to be subclassed <em>only</em> * within the DWT implementation. * </p> + * + * @see <a href="http://www.eclipse.org/swt/snippets/#scale">Scale snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: ControlExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class Scale : Control {
--- a/dwt/widgets/ScrollBar.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/ScrollBar.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -88,6 +88,8 @@ * @see Scrollable * @see Scrollable#getHorizontalBar * @see Scrollable#getVerticalBar + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: ControlExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class ScrollBar : Widget { Scrollable parent;
--- a/dwt/widgets/Scrollable.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/Scrollable.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -37,6 +37,8 @@ * IMPORTANT: This class is intended to be subclassed <em>only</em> * within the DWT implementation. * </p> + * + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public abstract class Scrollable : Control { GtkWidget* scrolledHandle;
--- a/dwt/widgets/Shell.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/Shell.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -139,6 +139,9 @@ * * @see Decorations * @see DWT + * @see <a href="http://www.eclipse.org/swt/snippets/#shell">Shell snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: ControlExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class Shell : Decorations { @@ -387,6 +390,23 @@ return new Shell (display, null, DWT.NO_TRIM, handle, true); } +/** + * Invokes platform specific functionality to allocate a new shell + * that is not embedded. + * <p> + * <b>IMPORTANT:</b> This method is <em>not</em> part of the public + * API for <code>Shell</code>. It is marked public only so that it + * can be shared within the packages provided by DWT. It is not + * available on all platforms, and should never be called from + * application code. + * </p> + * + * @param display the display for the shell + * @param handle the handle for the shell + * @return a new shell object containing the specified display and handle + * + * @since 3.3 + */ public static Shell internal_new (Display display, GtkWidget* handle) { return new Shell (display, null, DWT.NO_TRIM, handle, false); } @@ -826,6 +846,19 @@ OS.gtk_widget_size_allocate (cast(GtkWidget*)vboxHandle, &allocation); } +/** + * Returns the receiver's alpha value. The alpha value + * is between 0 (transparent) and 255 (opaque). + * + * @return the alpha value + * + * @exception DWTException <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.4 + */ public int getAlpha () { checkWidget (); if (OS.GTK_VERSION >= OS.buildVERSION (2, 12, 0)) { @@ -836,6 +869,20 @@ return 255; } +/** + * Returns <code>true</code> if the receiver is currently + * in fullscreen state, and false otherwise. + * <p> + * + * @return the fullscreen state + * + * @exception DWTException <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.4 + */ public bool getFullScreen () { checkWidget(); return fullScreen; @@ -1242,6 +1289,23 @@ } } +/** + * Sets the receiver's alpha value which must be + * between 0 (transparent) and 255 (opaque). + * <p> + * This operation requires the operating system's advanced + * widgets subsystem which may not be available on some + * platforms. + * </p> + * @param alpha the alpha value + * + * @exception DWTException <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.4 + */ public void setAlpha (int alpha) { checkWidget (); if (OS.GTK_VERSION >= OS.buildVERSION (2, 12, 0)) { @@ -1390,6 +1454,29 @@ } } +/** + * Sets the full screen state of the receiver. + * If the argument is <code>true</code> causes the receiver + * to switch to the full screen state, and if the argument is + * <code>false</code> and the receiver was previously switched + * into full screen state, causes the receiver to switch back + * to either the maximmized or normal states. + * <p> + * Note: The result of intermixing calls to <code>setFullScreen(true)</code>, + * <code>setMaximized(true)</code> and <code>setMinimized(true)</code> will + * vary by platform. Typically, the behavior will match the platform user's + * expectations, but not always. This should be avoided if possible. + * </p> + * + * @param fullScreen the new fullscreen state + * + * @exception DWTException <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.4 + */ public void setFullScreen (bool fullScreen) { checkWidget(); if (fullScreen) {
--- a/dwt/widgets/Slider.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/Slider.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -69,6 +69,9 @@ * </p> * * @see ScrollBar + * @see <a href="http://www.eclipse.org/swt/snippets/#slider">Slider snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: ControlExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class Slider : Control {
--- a/dwt/widgets/Spinner.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/Spinner.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -47,6 +47,10 @@ * IMPORTANT: This class is <em>not</em> intended to be subclassed. * </p> * + * @see <a href="http://www.eclipse.org/swt/snippets/#spinner">Spinner snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: ControlExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> + * * @since 3.1 */ public class Spinner : Composite { @@ -64,13 +68,11 @@ int fixStart = -1, fixEnd = -1; /** - * The maximum number of characters that can be entered - * into a text widget. - * <p> - * Note that this value is platform dependent, based upon - * the native widget implementation. - * </p> - */ + * the operating system limit for the number of characters + * that the text field in an instance of this class can hold + * + * @since 3.4 + */ public const static int LIMIT = 0x7FFFFFFF; /** @@ -479,12 +481,43 @@ return cast(int) (value > 0 ? value + 0.5 : value - 0.5); } +/** + * Returns a string containing a copy of the contents of the + * receiver's text field, or an empty string if there are no + * contents. + * + * @return the receiver's text + * + * @exception DWTException <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.4 + */ public String getText () { checkWidget (); auto str = OS.gtk_entry_get_text (handle); return fromStringz(str).dup; } +/** + * Returns the maximum number of characters that the receiver's + * text field is capable of holding. If this has not been changed + * by <code>setTextLimit()</code>, it will be the constant + * <code>Spinner.LIMIT</code>. + * + * @return the text limit + * + * @exception DWTException <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 #LIMIT + * + * @since 3.4 + */ public int getTextLimit () { checkWidget (); int limit = OS.gtk_entry_get_max_length (handle); @@ -877,11 +910,11 @@ /** * Sets the minimum value that the receiver will allow. This new - * value will be ignored if it is negative or is not less than the receiver's + * value will be ignored if it is not less than the receiver's * current maximum value. If the new minimum is applied then the receiver's * selection value will be adjusted if necessary to fall within its new range. * - * @param value the new minimum, which must be nonnegative and less than the current maximum + * @param value the new minimum, which must be less than the current maximum * * @exception DWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> @@ -947,6 +980,28 @@ OS.g_signal_handlers_unblock_matched (handle, OS.G_SIGNAL_MATCH_DATA, 0, 0, null, null, udVALUE_CHANGED); } +/** + * Sets the maximum number of characters that the receiver's + * text field is capable of holding to be the argument. + * <p> + * To reset this value to the default, use <code>setTextLimit(Spinner.LIMIT)</code>. + * Specifying a limit value larger than <code>Spinner.LIMIT</code> sets the + * receiver's limit to <code>Spinner.LIMIT</code>. + * </p> + * @param limit new text limit + * + * @exception IllegalArgumentException <ul> + * <li>ERROR_CANNOT_BE_ZERO - if the limit is zero</li> + * </ul> + * @exception DWTException <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 #LIMIT + * + * @since 3.4 + */ public void setTextLimit (int limit) { checkWidget (); if (limit is 0) error (DWT.ERROR_CANNOT_BE_ZERO);
--- a/dwt/widgets/Synchronizer.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/Synchronizer.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -39,6 +39,7 @@ * </p> * * @see Display#setSynchronizer + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class Synchronizer { Display display;
--- a/dwt/widgets/TabFolder.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/TabFolder.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -53,6 +53,10 @@ * </p><p> * IMPORTANT: This class is <em>not</em> intended to be subclassed. * </p> + * + * @see <a href="http://www.eclipse.org/swt/snippets/#tabfolder">TabFolder, TabItem snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: ControlExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class TabFolder : Composite { @@ -327,6 +331,24 @@ return items [index]; } +/** + * Returns the tab item at the given point in the receiver + * or null if no such item exists. The point is in the + * coordinate system of the receiver. + * + * @param point the point used to locate the item + * @return the tab item at the given point, or null if the point is not in a tab item + * + * @exception IllegalArgumentException <ul> + * <li>ERROR_NULL_ARGUMENT - if the point is null</li> + * </ul> + * @exception DWTException <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.4 + */ public TabItem getItem(Point point) { checkWidget(); if (point is null) error (DWT.ERROR_NULL_ARGUMENT);
--- a/dwt/widgets/TabItem.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/TabItem.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -38,6 +38,9 @@ * <p> * IMPORTANT: This class is <em>not</em> intended to be subclassed. * </p> + * + * @see <a href="http://www.eclipse.org/swt/snippets/#tabfolder">TabFolder, TabItem snippets</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class TabItem : Item { @@ -144,6 +147,19 @@ releaseHandle (); } +/** + * Returns a rectangle describing the receiver's size and location + * relative to its parent. + * + * @return the receiver's bounding rectangle + * + * @exception DWTException <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.4 + */ public Rectangle getBounds () { checkWidget(); int x = OS.GTK_WIDGET_X (handle);
--- a/dwt/widgets/Table.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/Table.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -71,12 +71,13 @@ * </pre></code> * </p><p> * Note that although this class is a subclass of <code>Composite</code>, - * it does not make sense to add <code>Control</code> children to it, - * or set a layout on it. + * it does not normally make sense to add <code>Control</code> children to + * it, or set a layout on it, unless implementing something like a cell + * editor. * </p><p> * <dl> * <dt><b>Styles:</b></dt> - * <dd>SINGLE, MULTI, CHECK, FULL_SELECTION, HIDE_SELECTION, VIRTUAL</dd> + * <dd>SINGLE, MULTI, CHECK, FULL_SELECTION, HIDE_SELECTION, VIRTUAL, NO_SCROLL</dd> * <dt><b>Events:</b></dt> * <dd>Selection, DefaultSelection, SetData, MeasureItem, EraseItem, PaintItem</dd> * </dl> @@ -85,6 +86,10 @@ * </p><p> * IMPORTANT: This class is <em>not</em> intended to be subclassed. * </p> + * + * @see <a href="http://www.eclipse.org/swt/snippets/#table">Table, TableItem, TableColumn snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: ControlExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class Table : Composite { @@ -153,6 +158,7 @@ * @see DWT#FULL_SELECTION * @see DWT#HIDE_SELECTION * @see DWT#VIRTUAL + * @see DWT#NO_SCROLL * @see Widget#checkSubclass * @see Widget#getStyle */ @@ -1488,7 +1494,7 @@ /** * Returns the height of the area which would be used to - * display <em>one</em> of the items in the receiver's. + * display <em>one</em> of the items in the receiver. * * @return the height of one item *
--- a/dwt/widgets/TableColumn.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/TableColumn.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -45,6 +45,9 @@ * </p><p> * IMPORTANT: This class is <em>not</em> intended to be subclassed. * </p> + * + * @see <a href="http://www.eclipse.org/swt/snippets/#table">Table, TableItem, TableColumn snippets</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class TableColumn : Item { GtkWidget* labelHandle, imageHandle, buttonHandle; @@ -105,7 +108,10 @@ * lists the style constants that are applicable to the class. * Style bits are also inherited from superclasses. * </p> - * + * <p> + * Note that due to a restriction on some platforms, the first column + * is always left aligned. + * </p> * @param parent a composite control which will be the parent of the new instance (cannot be null) * @param style the style of control to construct * @param index the zero-relative index to store the receiver in its parent @@ -512,7 +518,10 @@ * Controls how text and images will be displayed in the receiver. * The argument should be one of <code>LEFT</code>, <code>RIGHT</code> * or <code>CENTER</code>. - * + * <p> + * Note that due to a restriction on some platforms, the first column + * is always left aligned. + * </p> * @param alignment the new alignment * * @exception DWTException <ul>
--- a/dwt/widgets/TableItem.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/TableItem.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -42,6 +42,9 @@ * <p> * IMPORTANT: This class is <em>not</em> intended to be subclassed. * </p> + * + * @see <a href="http://www.eclipse.org/swt/snippets/#table">Table, TableItem, TableColumn snippets</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class TableItem : Item { Table parent;
--- a/dwt/widgets/Text.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/Text.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -33,6 +33,13 @@ /** * Instances of this class are selectable user interface * objects that allow the user to enter and modify text. + * Text controls can be either single or multi-line. + * When a text control is created with a border, the + * operating system includes a platform specific inset + * around the contents of the control. When created + * without a border, an effort is made to remove the + * inset such that the preferred size of the control + * is the same size as the contents. * <p> * <dl> * <dt><b>Styles:</b></dt> @@ -46,6 +53,10 @@ * </p><p> * IMPORTANT: This class is <em>not</em> intended to be subclassed. * </p> + * + * @see <a href="http://www.eclipse.org/swt/snippets/#text">Text snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: ControlExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class Text : Scrollable {
--- a/dwt/widgets/ToolBar.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/ToolBar.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -52,6 +52,10 @@ * </p><p> * IMPORTANT: This class is <em>not</em> intended to be subclassed. * </p> + * + * @see <a href="http://www.eclipse.org/swt/snippets/#toolbar">ToolBar, ToolItem snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: ControlExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class ToolBar : Composite {
--- a/dwt/widgets/ToolItem.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/ToolItem.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -46,6 +46,9 @@ * </p><p> * IMPORTANT: This class is <em>not</em> intended to be subclassed. * </p> + * + * @see <a href="http://www.eclipse.org/swt/snippets/#toolbar">ToolBar, ToolItem snippets</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class ToolItem : Item {
--- a/dwt/widgets/ToolTip.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/ToolTip.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -46,6 +46,10 @@ * within the DWT implementation. * </p> * + * @see <a href="http://www.eclipse.org/swt/snippets/#tooltips">Tool Tips snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: ControlExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> + * * @since 3.2 */ public class ToolTip : Widget {
--- a/dwt/widgets/Tracker.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/Tracker.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2006 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -49,6 +49,9 @@ * </p><p> * IMPORTANT: This class is <em>not</em> intended to be subclassed. * </p> + * + * @see <a href="http://www.eclipse.org/swt/snippets/#tracker">Tracker snippets</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class Tracker : Widget { Composite parent;
--- a/dwt/widgets/Tray.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/Tray.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2005 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -33,6 +33,8 @@ * </p> * * @see Display#getSystemTray + * @see <a href="http://www.eclipse.org/swt/snippets/#tray">Tray, TrayItem snippets</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> * * @since 3.0 */
--- a/dwt/widgets/TrayItem.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/TrayItem.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -45,6 +45,9 @@ * IMPORTANT: This class is <em>not</em> intended to be subclassed. * </p> * + * @see <a href="http://www.eclipse.org/swt/snippets/#tray">Tray, TrayItem snippets</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> + * * @since 3.0 */ public class TrayItem : Item {
--- a/dwt/widgets/Tree.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/Tree.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -77,12 +77,13 @@ * </pre></code> * </p><p> * Note that although this class is a subclass of <code>Composite</code>, - * it does not make sense to add <code>Control</code> children to it, - * or set a layout on it. + * it does not normally make sense to add <code>Control</code> children to + * it, or set a layout on it, unless implementing something like a cell + * editor. * </p><p> * <dl> * <dt><b>Styles:</b></dt> - * <dd>SINGLE, MULTI, CHECK, FULL_SELECTION, VIRTUAL</dd> + * <dd>SINGLE, MULTI, CHECK, FULL_SELECTION, VIRTUAL, NO_SCROLL</dd> * <dt><b>Events:</b></dt> * <dd>Selection, DefaultSelection, Collapse, Expand, SetData, MeasureItem, EraseItem, PaintItem</dd> * </dl> @@ -91,6 +92,10 @@ * </p><p> * IMPORTANT: This class is <em>not</em> intended to be subclassed. * </p> + * + * @see <a href="http://www.eclipse.org/swt/snippets/#tree">Tree, TreeItem, TreeColumn snippets</a> + * @see <a href="http://www.eclipse.org/swt/examples.php">DWT Example: ControlExample</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class Tree : Composite { @@ -160,6 +165,9 @@ * @see DWT#SINGLE * @see DWT#MULTI * @see DWT#CHECK + * @see DWT#FULL_SELECTION + * @see DWT#VIRTUAL + * @see DWT#NO_SCROLL * @see Widget#checkSubclass * @see Widget#getStyle */ @@ -969,6 +977,23 @@ if (checkRenderer !is null) display.removeWidget (cast(GtkWidget*)checkRenderer); } +/** + * Deselects an item in the receiver. If the item was already + * deselected, it remains deselected. + * + * @param item the item to be deselected + * + * @exception IllegalArgumentException <ul> + * <li>ERROR_NULL_ARGUMENT - if the item is null</li> + * <li>ERROR_INVALID_ARGUMENT - if the item has been disposed</li> + * </ul> + * @exception DWTException <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.4 + */ public void deselect (TreeItem item) { checkWidget (); if (item is null) error (DWT.ERROR_NULL_ARGUMENT); @@ -2740,6 +2765,23 @@ setItemCount (null, count); } +/** + * Selects an item in the receiver. If the item was already + * selected, it remains selected. + * + * @param item the item to be selected + * + * @exception IllegalArgumentException <ul> + * <li>ERROR_NULL_ARGUMENT - if the item is null</li> + * <li>ERROR_INVALID_ARGUMENT - if the item has been disposed</li> + * </ul> + * @exception DWTException <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.4 + */ public void select (TreeItem item) { checkWidget (); if (item is null) error (DWT.ERROR_NULL_ARGUMENT);
--- a/dwt/widgets/TreeColumn.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/TreeColumn.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -45,6 +45,9 @@ * IMPORTANT: This class is <em>not</em> intended to be subclassed. * </p> * + * @see <a href="http://www.eclipse.org/swt/snippets/#tree">Tree, TreeItem, TreeColumn snippets</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> + * * @since 3.1 */ public class TreeColumn : Item { @@ -106,7 +109,10 @@ * lists the style constants that are applicable to the class. * Style bits are also inherited from superclasses. * </p> - * + * <p> + * Note that due to a restriction on some platforms, the first column + * is always left aligned. + * </p> * @param parent a composite control which will be the parent of the new instance (cannot be null) * @param style the style of control to construct * @param index the zero-relative index to store the receiver in its parent @@ -508,7 +514,10 @@ * Controls how text and images will be displayed in the receiver. * The argument should be one of <code>LEFT</code>, <code>RIGHT</code> * or <code>CENTER</code>. - * + * <p> + * Note that due to a restriction on some platforms, the first column + * is always left aligned. + * </p> * @param alignment the new alignment * * @exception DWTException <ul>
--- a/dwt/widgets/TreeItem.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/TreeItem.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -42,6 +42,9 @@ * <p> * IMPORTANT: This class is <em>not</em> intended to be subclassed. * </p> + * + * @see <a href="http://www.eclipse.org/swt/snippets/#tree">Tree, TreeItem, TreeColumn snippets</a> + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class TreeItem : Item { Tree parent;
--- a/dwt/widgets/TypedListener.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/TypedListener.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -71,6 +71,7 @@ * </p> * * @see Listener + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public class TypedListener : Listener {
--- a/dwt/widgets/Widget.d Tue Jun 24 22:12:18 2008 +0200 +++ b/dwt/widgets/Widget.d Sun Jun 29 14:33:38 2008 +0200 @@ -1,5 +1,5 @@ /******************************************************************************* - * Copyright (c) 2000, 2007 IBM Corporation and others. + * Copyright (c) 2000, 2008 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at @@ -58,6 +58,7 @@ * </p> * * @see #checkSubclass + * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a> */ public abstract class Widget { /** @@ -313,6 +314,7 @@ * * @see Listener * @see DWT + * @see #getListeners(int) * @see #removeListener(int, Listener) * @see #notifyListeners */ @@ -1087,6 +1089,7 @@ * * @see DWT * @see #addListener + * @see #getListeners(int) * @see #removeListener(int, Listener) */ public void notifyListeners (int eventType, Event event) { @@ -1154,7 +1157,7 @@ * type is one of the event constants defined in class <code>DWT</code>. * * @param eventType the type of event to listen for - * @param listener the listener which should no longer be notified when the event occurs + * @param listener the listener which should no longer be notified * * @exception IllegalArgumentException <ul> * <li>ERROR_NULL_ARGUMENT - if the listener is null</li> @@ -1167,6 +1170,7 @@ * @see Listener * @see DWT * @see #addListener + * @see #getListeners(int) * @see #notifyListeners */ public void removeListener (int eventType, Listener handler) { @@ -1187,7 +1191,7 @@ * </p> * * @param eventType the type of event to listen for - * @param listener the listener which should no longer be notified when the event occurs + * @param listener the listener which should no longer be notified * * @exception IllegalArgumentException <ul> * <li>ERROR_NULL_ARGUMENT - if the listener is null</li> @@ -1233,7 +1237,7 @@ * Removes the listener from the collection of listeners who will * be notified when the widget is disposed. * - * @param listener the listener which should no longer be notified when the receiver is disposed + * @param listener the listener which should no longer be notified * * @exception IllegalArgumentException <ul> * <li>ERROR_NULL_ARGUMENT - if the listener is null</li>