Mercurial > projects > dwt2
view org.eclipse.swt.gtk.linux.x86/src/org/eclipse/swt/dnd/DropTargetListener.d @ 120:536e43f63c81
Comprehensive update for Win32/Linux32 dmd-2.053/dmd-1.068+Tango-r5661
===D2===
* added [Try]Immutable/Const/Shared templates to work with differenses in D1/D2 instead of version statements
used these templates to work with strict type storage rules of dmd-2.053
* com.ibm.icu now also compilable with D2, but not tested yet
* small fixes
Snippet288 - shared data is in TLS
===Phobos===
* fixed critical bugs in Phobos implemention
completely incorrect segfault prone fromStringz (Linux's port ruthless killer)
terrible, incorrect StringBuffer realization (StyledText killer)
* fixed small bugs as well
Snippet72 - misprint in the snippet
* implemented missed functionality for Phobos
ByteArrayOutputStream implemented (image loading available)
formatting correctly works for all DWT's cases
As a result, folowing snippets now works with Phobos (Snippet### - what is fixed):
Snippet24, 42, 111, 115, 130, 235, 276 - bad string formatting
Snippet48, 282 - crash on image loading
Snippet163, 189, 211, 213, 217, 218, 222 - crash on copy/cut in StyledText
Snippet244 - hang-up
===Tango===
* few changes for the latest Tango trunc-r5661
* few small performance improvments
===General===
* implMissing-s for only one version changed to implMissingInTango/InPhobos
* incorrect calls to Format in toString-s fixed
* fixed loading \uXXXX characters in ResourceBundle
* added good UTF-8 support for StyledText, TextLayout (Win32) and friends
UTF functions revised and tested. It is now in java.nonstandard.*Utf modules
StyledText and TextLayout (Win32) modules revised for UTF-8 support
* removed small diferences in most identical files in *.swt.* folders
*.swt.internal.image, *.swt.events and *.swt.custom are identical in Win32/Linux32
now 179 of 576 (~31%) files in *.swt.* folders are fully identical
* Win32: snippets now have right subsystem, pretty icons and native system style controls
* small fixes in snippets
Snippet44 - it's not Snippet44
Snippet212 - functions work with different images and offsets arrays
Win32: Snippet282 - crash on close if the button has an image
Snippet293 - setGrayed is commented
and others
Win32: As a result, folowing snippets now works
Snippet68 - color doesn't change
Snippet163, 189, 211, 213, 217, 218, 222 - UTF-8 issues (see above)
Snippet193 - no tabel headers
author | Denis Shelomovskij <verylonglogin.reg@gmail.com> |
---|---|
date | Sat, 09 Jul 2011 15:50:20 +0300 |
parents | f713da8bc051 |
children |
line wrap: on
line source
/******************************************************************************* * Copyright (c) 2000, 2003 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at * http://www.eclipse.org/legal/epl-v10.html * * Contributors: * IBM Corporation - initial API and implementation * Port to the D programming language: * Frank Benoit <benoit@tionex.de> *******************************************************************************/ module org.eclipse.swt.dnd.DropTargetListener; import java.lang.all; import org.eclipse.swt.internal.SWTEventListener; import org.eclipse.swt.dnd.DropTargetEvent; /** * The <code>DropTargetListener</code> class provides event notification to the application * for DropTarget events. * * <p>As the user moves the cursor into, over and out of a Control that has been designated * as a DropTarget, events indicate what operation can be performed and what data can be * transferred if a drop where to occur at that point. * The application can respond to these events and change the type of data that will * be dropped by modifying event.currentDataType, or change the operation that will be performed * by modifying the event.detail field or stop any drop from happening on the current target * by setting the event.detail field to DND_DROP_NONE.</p> * * <p>When the user causes a drop to happen by releasing the mouse over a valid drop target, * the application has one last chance to change the data type of the drop through the * DropAccept event. If the drop is still allowed, the DropAccept event is immediately * followed by the Drop event. In the Drop event, the application can still change the * operation that is performed but the data type is fixed.</p> * * @see DropTargetEvent * */ public interface DropTargetListener : SWTEventListener { /** * The cursor has entered the drop target boundaries. * * <p>The following fields in the DropTargetEvent apply: * <ul> * <li>(in)widget * <li>(in)time * <li>(in)x * <li>(in)y * <li>(in)dataTypes * <li>(in,out)currentDataType * <li>(in)operations * <li>(in,out)detail * <li>(in,out)feedback * </ul></p> * * <p>The <code>operation</code> value is determined by the modifier keys pressed by the user. * If no keys are pressed the <code>event.detail</code> field is set to DND.DROP_DEFAULT. * If the application does not set the <code>event.detail</code> to something other * than <code>DND.DROP_DEFAULT</code> the operation will be set to the platform defined standard * default.</p> * * <p>The <code>currentDataType</code> is determined by the first transfer agent specified in * setTransfer() that matches a data type provided by the drag source.</p> * * <p>It is possible to get a DragEnter event when the drag source does not provide any matching data. * In this case, the default operation is DND.DROP_NONE and the currentDataType is null.</p> * * <p>The application can change the operation that will be performed by modifying the * <code>detail</code> field but the choice must be one of the values in the <code>operations</code> * field or DND.DROP_NONE.</p> * * <p>The application can also change the type of data being requested by * modifying the <code>currentDataTypes</code> field but the value must be one of the values * in the <code>dataTypes</code> list.</p> * * @param event the information associated with the drag enter event * * @see DropTargetEvent */ public void dragEnter(DropTargetEvent event); /** * The cursor has left the drop target boundaries OR the drop has been cancelled OR the data * is about to be dropped. * * <p>The following fields in the DropTargetEvent apply: * <ul> * <li>(in)widget * <li>(in)time * <li>(in)x * <li>(in)y * <li>(in)dataTypes * <li>(in)currentDataType * <li>(in)operations * <li>(in)detail * </ul></p> * * @param event the information associated with the drag leave event * * @see DropTargetEvent */ public void dragLeave(DropTargetEvent event); /** * The operation being performed has changed (usually due to the user changing the selected modifier key(s) * while dragging). * * <p>The following fields in the DropTargetEvent apply: * <ul> * <li>(in)widget * <li>(in)time * <li>(in)x * <li>(in)y * <li>(in)dataTypes * <li>(in,out)currentDataType * <li>(in)operations * <li>(in,out)detail * <li>(in,out)feedback * </ul></p> * * <p>The <code>operation</code> value is determined by the modifier keys pressed by the user. * If no keys are pressed the <code>event.detail</code> field is set to DND.DROP_DEFAULT. * If the application does not set the <code>event.detail</code> to something other than * <code>DND.DROP_DEFAULT</code> the operation will be set to the platform defined standard default.</p> * * <p>The <code>currentDataType</code> value is determined by the value assigned to * <code>currentDataType</code> in previous dragEnter and dragOver calls.</p> * * <p>The application can change the operation that will be performed by modifying the * <code>detail</code> field but the choice must be one of the values in the <code>operations</code> * field.</p> * * <p>The application can also change the type of data being requested by modifying * the <code>currentDataTypes</code> field but the value must be one of the values in the * <code>dataTypes</code> list.</p> * * @param event the information associated with the drag operation changed event * * @see DropTargetEvent */ public void dragOperationChanged(DropTargetEvent event); /** * The cursor is moving over the drop target. * * <p>The following fields in the DropTargetEvent apply: * <ul> * <li>(in)widget * <li>(in)time * <li>(in)x * <li>(in)y * <li>(in)dataTypes * <li>(in,out)currentDataType * <li>(in)operations * <li>(in,out)detail * <li>(in,out)feedback * </ul></p> * * <p>The <code>operation</code> value is determined by the value assigned to * <code>currentDataType</code> in previous dragEnter and dragOver calls.</p> * * <p>The <code>currentDataType</code> value is determined by the value assigned to * <code>currentDataType</code> in previous dragEnter and dragOver calls.</p> * * <p>The application can change the operation that will be performed by modifying the * <code>detail</code> field but the choice must be one of the values in the <code>operations</code> * field.</p> * * <p>The application can also change the type of data being requested by modifying the * <code>currentDataTypes</code> field but the value must be one of the values in the * <code>dataTypes</code> list.</p> * * <p>NOTE: At this point the <code>data</code> field is null. On some platforms, it is possible * to obtain the data being transferred before the transfer occurs but in most platforms this is * not possible. On those platforms where the data is available, the application can access the * data as follows:</p> * * <pre><code> * public void dragOver(DropTargetEvent event) { * TextTransfer textTransfer = TextTransfer.getInstance(); * String data = (String)textTransfer.nativeToJava(event.currentDataType); * if (data !is null) { * System.out.println("Data to be dropped is (Text)"+data); * } * }; * </code></pre> * * @param event the information associated with the drag over event * * @see DropTargetEvent */ public void dragOver(DropTargetEvent event); /** * The data is being dropped. The data field contains java format of the data being dropped. * To determine the type of the data object, refer to the documentation for the Transfer subclass * specified in event.currentDataType. * * <p>The following fields in DropTargetEvent apply: * <ul> * <li>(in)widget * <li>(in)time * <li>(in)x * <li>(in)y * <li>(in,out)detail * <li>(in)currentDataType * <li>(in)data * </ul></p> * * <p>The application can refuse to perform the drop operation by setting the detail * field to DND.DROP_NONE.</p> * * @param event the information associated with the drop event * * @see DropTargetEvent */ public void drop(DropTargetEvent event); /** * The drop is about to be performed. * The drop target is given a last chance to change the nature of the drop. * * <p>The following fields in the DropTargetEvent apply: * <ul> * <li>(in)widget * <li>(in)time * <li>(in)x * <li>(in)y * <li>(in)dataTypes * <li>(in,out)currentDataType * <li>(in)operations * <li>(in,out)detail * </ul></p> * * <p>The application can veto the drop by setting the <code>event.detail</code> field to * <code>DND.DROP_NONE</code>.</p> * * <p>The application can change the operation that will be performed by modifying the * <code>detail</code> field but the choice must be one of the values in the * <code>operations</code> field.</p> * * <p>The application can also change the type of data being requested by modifying the * <code>currentDataTypes</code> field but the value must be one of the values in the < * code>dataTypes</code> list.</p> * * @param event the information associated with the drop accept event * * @see DropTargetEvent */ public void dropAccept(DropTargetEvent event); }