Java tutorial
/* * Copyright 2015 John Ahlroos * * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except * in compliance with the License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software distributed under the License * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express * or implied. See the License for the specific language governing permissions and limitations under * the License. */ package fi.jasoft.dragdroplayouts; import java.util.Map; import com.vaadin.event.Transferable; import com.vaadin.event.dd.DropHandler; import com.vaadin.event.dd.DropTarget; import com.vaadin.event.dd.TargetDetails; import com.vaadin.event.dd.TargetDetailsImpl; import com.vaadin.server.PaintException; import com.vaadin.server.PaintTarget; import com.vaadin.shared.MouseEventDetails; import com.vaadin.shared.ui.dd.VerticalDropLocation; import com.vaadin.ui.Component; import com.vaadin.ui.LegacyComponent; import com.vaadin.ui.VerticalSplitPanel; import fi.jasoft.dragdroplayouts.client.ui.Constants; import fi.jasoft.dragdroplayouts.client.ui.LayoutDragMode; import fi.jasoft.dragdroplayouts.client.ui.verticalsplitpanel.DDVerticalSplitPanelState; import fi.jasoft.dragdroplayouts.events.LayoutBoundTransferable; import fi.jasoft.dragdroplayouts.interfaces.DragFilter; import fi.jasoft.dragdroplayouts.interfaces.DragFilterSupport; import fi.jasoft.dragdroplayouts.interfaces.DragImageProvider; import fi.jasoft.dragdroplayouts.interfaces.DragImageReferenceSupport; import fi.jasoft.dragdroplayouts.interfaces.LayoutDragSource; import fi.jasoft.dragdroplayouts.interfaces.ShimSupport; /** * Vertical split panel with drag and drop support * * @author John Ahlroos / www.jasoft.fi * @since 0.4.0 */ @SuppressWarnings("serial") public class DDVerticalSplitPanel extends VerticalSplitPanel implements LayoutDragSource, DropTarget, ShimSupport, LegacyComponent, DragFilterSupport, DragImageReferenceSupport { /** * The drop handler which handles dropped components in the layout. */ private DropHandler dropHandler; // A filter for dragging components. private DragFilter dragFilter = DragFilter.ALL; private DragImageProvider dragImageProvider; /** * Contains the location and other information about the drop. */ public class VerticalSplitPanelTargetDetails extends TargetDetailsImpl { private Component over; protected VerticalSplitPanelTargetDetails(Map<String, Object> rawDropData) { super(rawDropData, DDVerticalSplitPanel.this); if (getDropLocation() == VerticalDropLocation.TOP) { over = getFirstComponent(); } else if (getDropLocation() == VerticalDropLocation.BOTTOM) { over = getSecondComponent(); } else { over = DDVerticalSplitPanel.this; } } /** * The component over which the drop was made. * * @return Null if the drop was not over a component, else the component */ public Component getOverComponent() { return over; } /** * Some details about the mouse event * * @return details about the actual event that caused the event details. * Practically mouse move or mouse up. */ public MouseEventDetails getMouseEvent() { return MouseEventDetails.deSerialize((String) getData(Constants.DROP_DETAIL_MOUSE_EVENT)); } /** * Get the horizontal position of the dropped component within the * underlying cell. * * @return The drop location */ public VerticalDropLocation getDropLocation() { return VerticalDropLocation.valueOf((String) getData(Constants.DROP_DETAIL_VERTICAL_DROP_LOCATION)); } } /** * Constructs a new vertical splitpanel */ public DDVerticalSplitPanel() { super(); } /** * Constructs a new vertical splitpanel with children * * @param firstChild * the first child component * @param secondChild * the second child component */ public DDVerticalSplitPanel(Component firstChild, Component secondChild) { super(firstChild, secondChild); } /* * (non-Javadoc) * * @see * com.vaadin.event.dd.DropTarget#translateDropTargetDetails(java.util.Map) */ public TargetDetails translateDropTargetDetails(Map<String, Object> clientVariables) { return new VerticalSplitPanelTargetDetails(clientVariables); } /** * Get the transferable created by a drag event. */ public Transferable getTransferable(Map<String, Object> rawVariables) { return new LayoutBoundTransferable(this, rawVariables); } /** * Returns the drop handler which handles drop events from dropping * components on the layout. Returns Null if dropping is disabled. */ public DropHandler getDropHandler() { return dropHandler; } /** * Sets the current handler which handles dropped components on the layout. * By setting a drop handler dropping components on the layout is enabled. * By setting the dropHandler to null dropping is disabled. * * @param dropHandler * The drop handler to handle drop events or null to disable * dropping */ public void setDropHandler(DropHandler dropHandler) { DDUtil.verifyHandlerType(this, dropHandler); if (this.dropHandler != dropHandler) { this.dropHandler = dropHandler; markAsDirty(); } } /** * Returns the mode of which dragging is visualized. * * @return */ public LayoutDragMode getDragMode() { return getState().ddState.dragMode; } /** * Enables dragging components from the layout. * * @param mode * The mode of which how the dragging should be visualized. */ public void setDragMode(LayoutDragMode mode) { getState().ddState.dragMode = mode; } /** * {@inheritDoc} * */ public void paintContent(PaintTarget target) throws PaintException { if (dropHandler != null && isEnabled()) { dropHandler.getAcceptCriterion().paint(target); } } /** * {@inheritDoc} */ public void setShim(boolean shim) { getState().ddState.iframeShims = shim; } /** * {@inheritDoc} */ public boolean isShimmed() { return getState().ddState.iframeShims; } /** * {@inheritDoc} */ public DragFilter getDragFilter() { return dragFilter; } /** * {@inheritDoc} */ public void setDragFilter(DragFilter dragFilter) { this.dragFilter = dragFilter; } @Override public DDVerticalSplitPanelState getState() { return (DDVerticalSplitPanelState) super.getState(); } @Override public void beforeClientResponse(boolean initial) { super.beforeClientResponse(initial); DDUtil.onBeforeClientResponse(this, getState()); } @Override public void changeVariables(Object source, Map<String, Object> variables) { // TODO Auto-generated method stub } @Override public void setDragImageProvider(DragImageProvider provider) { this.dragImageProvider = provider; markAsDirty(); } @Override public DragImageProvider getDragImageProvider() { return this.dragImageProvider; } }