/*******************************************************************************
* Copyright (c) 2000, 2008, 2012 IBM Corporation, Gerhardt Informatics Kft. 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
* Gerhardt Informatics Kft. - GEFGWT port
*******************************************************************************/
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.
*
* <p>
* The drop target effect has the same API as the <code>DropTargetAdapter</code>
* so that it can provide custom visual feedback when a
* <code>DropTargetEvent</code> occurs.
* </p>
*
* <p>
* Classes that wish to provide their own drag under effect can extend the
* <code>DropTargetEffect</code> and override any applicable methods in
* <code>DropTargetAdapter</code> to display their own drag under effect.
* </p>
*
* <p>
* The feedback value is either one of the FEEDBACK constants defined in class
* <code>DND</code> which is applicable to instances of this class, or it must
* be built by <em>bitwise OR</em>'ing together (that is, using the
* <code>int</code> "|" operator) two or more of those <code>DND</code> effect
* constants.
* </p>
* <p>
* <dl>
* <dt><b>Feedback:</b></dt>
* <dd>FEEDBACK_EXPAND, FEEDBACK_INSERT_AFTER, FEEDBACK_INSERT_BEFORE,
* FEEDBACK_NONE, FEEDBACK_SELECT, FEEDBACK_SCROLL</dd>
* </dl>
* </p>
*
* @see DropTargetAdapter
* @see DropTargetEvent
* @see <a href="http://www.eclipse.org/swt/">Sample code and further
* information</a>
*
* @since 3.3
*/
public class DropTargetEffect extends DropTargetAdapter {
Control control;
/**
* Creates a new <code>DropTargetEffect</code> to handle the drag under
* effect on the specified <code>Control</code>.
*
* @param control
* the <code>Control</code> over which the user positions the
* cursor to drop the data
*
* @exception IllegalArgumentException
* <ul>
* <li>ERROR_NULL_ARGUMENT - if the control is null</li>
* </ul>
*/
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 < itemCount; i++) {
item = table.getItem(i);
Rectangle rect = item.getBounds();
rect.x = area.x;
rect.width = area.width;
if (rect.contains(coordinates))
return item;
if (rect.y > 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;
}
}