org.eclipse.swt.dnd.DropTargetAdapter Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of org.eclipse.swt.gtk.linux.ppc64le Show documentation
Standard Widget Toolkit for GTK on ppc64le
The newest version!
/*******************************************************************************
 * Copyright (c) 2000, 2016 IBM Corporation and others.
 *
 * This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License 2.0
 * which accompanies this distribution, and is available at
 * https://www.eclipse.org/legal/epl-2.0/
 *
 * SPDX-License-Identifier: EPL-2.0
 *
 * Contributors:
 *     IBM Corporation - initial API and implementation
 *******************************************************************************/
package org.eclipse.swt.dnd;


/**
 * This adapter class provides default implementations for the
 * methods described by the DropTargetListener interface.
 * 
 * Classes that wish to deal with DropTargetEvents can
 * extend this class and override only the methods which they are
 * interested in.
 * 
 *
 *
 * Please note, there are subtle difference in DND behavior on different OS's.
 * For example during a file transfer, Windows will put out the file path
 * as soon as the drag begins, where as Linux will make it available only
 * on a drop operation. For correct crossplatform behavior, it is recommended
 * to delay OS interaction until drop has occurred or verify the correctness of
 * the operation across platforms.
 * 
 *
 *
 * @see DropTargetListener
 * @see DropTargetEvent
 * @see Sample code and further information
 * @see  Eclipse corner article on DND 
 */
public class DropTargetAdapter implements DropTargetListener {

/**
 * This implementation of dragEnter permits the default
 * operation defined in event.detailto be performed on the current data type
 * defined in event.currentDataType.
 * For additional information see DropTargetListener.dragEnter.
 *
 * @param event the information associated with the drag enter event
 */
@Override
public void dragEnter(DropTargetEvent event){}

/**
 * This implementation of dragLeave does nothing.
 * For additional information see DropTargetListener.dragOperationChanged.
 *
 * @param event the information associated with the drag leave event
 */
@Override
public void dragLeave(DropTargetEvent event){}

/**
 * This implementation of dragOperationChanged permits the default
 * operation defined in event.detailto be performed on the current data type
 * defined in event.currentDataType.
 * For additional information see DropTargetListener.dragOperationChanged.
 *
 * @param event the information associated with the drag operation changed event
 */
@Override
public void dragOperationChanged(DropTargetEvent event){}

/**
 * This implementation of dragOver permits the default
 * operation defined in event.detailto be performed on the current data type
 * defined in event.currentDataType.
 * For additional information see DropTargetListener.dragOver.
 *
 * @param event the information associated with the drag over event
 */
@Override
public void dragOver(DropTargetEvent event){}

/**
 * This implementation of drop does nothing.
 * For additional information see DropTargetListener.drop.
 *
 * @param event the information associated with the drop event
 */
@Override
public void drop(DropTargetEvent event){}

/**
 * This implementation of dropAccept permits the default
 * operation defined in event.detailto be performed on the current data type
 * defined in event.currentDataType.
 * For additional information see DropTargetListener.dropAccept.
 *
 * @param event the information associated with the drop accept event
 */
@Override
public void dropAccept(DropTargetEvent event){}

}