org.eclipse.swt.dnd.DropTargetEffect Maven / Gradle / Ivy
/*******************************************************************************
* 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
* http://www.eclipse.org/legal/epl-v10.html
*
* Contributors:
* IBM Corporation - initial API and implementation
*******************************************************************************/
package org.eclipse.swt.dnd;
import org.eclipse.swt.SWT;
import org.eclipse.swt.graphics.Point;
import org.eclipse.swt.graphics.Rectangle;
import org.eclipse.swt.widgets.Control;
import org.eclipse.swt.widgets.Table;
import org.eclipse.swt.widgets.TableItem;
import org.eclipse.swt.widgets.Tree;
import org.eclipse.swt.widgets.TreeItem;
import org.eclipse.swt.widgets.Widget;
/**
* This class provides a default drag under effect during a drag and drop.
* The current implementation does not provide any visual feedback.
*
* The drop target effect has the same API as the
* DropTargetAdapter so that it can provide custom visual
* feedback when a DropTargetEvent occurs.
*
*
* Classes that wish to provide their own drag under effect
* can extend the DropTargetEffect and override any applicable methods
* in DropTargetAdapter to display their own drag under effect.
*
* The feedback value is either one of the FEEDBACK constants defined in
* class DND which is applicable to instances of this class,
* or it must be built by bitwise OR'ing together
* (that is, using the int "|" operator) two or more
* of those DND effect constants.
*
*
*
* - Feedback:
* - FEEDBACK_EXPAND, FEEDBACK_INSERT_AFTER, FEEDBACK_INSERT_BEFORE,
* FEEDBACK_NONE, FEEDBACK_SELECT, FEEDBACK_SCROLL
*
*
*
* @see DropTargetAdapter
* @see DropTargetEvent
* @since 1.3
*/
public class DropTargetEffect extends DropTargetAdapter {
Control control;
/**
* Creates a new DropTargetEffect to handle the drag under effect on the specified
* Control.
*
* @param control the Control over which the user positions the cursor to drop the data
*
* @exception IllegalArgumentException
* - ERROR_NULL_ARGUMENT - if the control is null
*
*/
public DropTargetEffect(Control control) {
if (control == null) SWT.error(SWT.ERROR_NULL_ARGUMENT);
this.control = control;
}
/**
* Returns the Control which is registered for this DropTargetEffect. This is the control over which the
* user positions the cursor to drop the data.
*
* @return the Control which is registered for this DropTargetEffect
*/
public Control getControl() {
return control;
}
/**
* Returns the item at the given x-y coordinate in the receiver
* or null if no such item exists. The x-y coordinate is in the
* display relative coordinates.
*
* @param x the x coordinate used to locate the item
* @param y the y coordinate used to locate the item
* @return the item at the given x-y coordinate, or null if the coordinate is not in a selectable item
*/
public Widget getItem(int x, int y) {
if (control instanceof Table) {
return getItem((Table) control, x, y);
}
if (control instanceof Tree) {
return getItem((Tree) control, x, y);
}
return null;
}
Widget getItem(Table table, int x, int y) {
Point coordinates = new Point(x, y);
coordinates = table.toControl(coordinates);
TableItem item = table.getItem(coordinates);
if (item != null) return item;
Rectangle area = table.getClientArea();
int tableBottom = area.y + area.height;
int itemCount = table.getItemCount();
for (int i=table.getTopIndex(); i tableBottom) break;
}
return null;
}
Widget getItem(Tree tree, int x, int y) {
Point point = new Point(x, y);
point = tree.toControl(point);
TreeItem item = tree.getItem(point);
if (item == null) {
Rectangle area = tree.getClientArea();
if (area.contains(point)) {
int treeBottom = area.y + area.height;
item = tree.getTopItem();
while (item != null) {
Rectangle rect = item.getBounds();
int itemBottom = rect.y + rect.height;
if (rect.y <= point.y && point.y < itemBottom) return item;
if (itemBottom > treeBottom) break;
item = nextItem(tree, item);
}
return null;
}
}
return item;
}
TreeItem nextItem(Tree tree, TreeItem item) {
if (item == null) return null;
if (item.getExpanded() && item.getItemCount() > 0) return item.getItem(0);
TreeItem childItem = item;
TreeItem parentItem = childItem.getParentItem();
int index = parentItem == null ? tree.indexOf(childItem) : parentItem.indexOf(childItem);
int count = parentItem == null ? tree.getItemCount() : parentItem.getItemCount();
while (true) {
if (index + 1 < count) return parentItem == null ? tree.getItem(index + 1) : parentItem.getItem(index + 1);
if (parentItem == null) return null;
childItem = parentItem;
parentItem = childItem.getParentItem();
index = parentItem == null ? tree.indexOf(childItem) : parentItem.indexOf(childItem);
count = parentItem == null ? tree.getItemCount() : parentItem.getItemCount();
}
}
TreeItem previousItem(Tree tree, TreeItem item) {
if (item == null) return null;
TreeItem childItem = item;
TreeItem parentItem = childItem.getParentItem();
int index = parentItem == null ? tree.indexOf(childItem) : parentItem.indexOf(childItem);
if (index == 0) return parentItem;
TreeItem nextItem = parentItem == null ? tree.getItem(index-1) : parentItem.getItem(index-1);
int count = nextItem.getItemCount();
while (count > 0 && nextItem.getExpanded()) {
nextItem = nextItem.getItem(count - 1);
count = nextItem.getItemCount();
}
return nextItem;
}
}