org.eclipse.swt.dnd.DropTargetAdapter.java Source code

Introduction

Here is the source code for org.eclipse.swt.dnd.DropTargetAdapter.java

Source

/*******************************************************************************
 * 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 <code>DropTargetListener</code> interface.
 * <p>
 * Classes that wish to deal with <code>DropTargetEvent</code>s can
 * extend this class and override only the methods which they are
 * interested in.
 * </p>
 *
 *<p>
 * 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.
 * </p>
 *
 *
 * @see DropTargetListener
 * @see DropTargetEvent
 * @see <a href="http://www.eclipse.org/swt/">Sample code and further information</a>
 * @see <a href="https://eclipse.org/articles/Article-SWT-DND/DND-in-SWT.html"> Eclipse corner article on DND </a>
 */
public class DropTargetAdapter implements DropTargetListener {

    /**
     * This implementation of <code>dragEnter</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.dragEnter</code>.
     *
     * @param event the information associated with the drag enter event
     */
    @Override
    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
     */
    @Override
    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
     */
    @Override
    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
     */
    @Override
    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
     */
    @Override
    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
     */
    @Override
    public void dropAccept(DropTargetEvent event) {
    }

}