bibliothek.gui.dock.station.toolbar.DefaultToolbarStrategy Maven / Gradle / Ivy

Go to download
/*
 * Bibliothek - DockingFrames
 * Library built on Java/Swing, allows the user to "drag and drop"
 * panels containing any Swing-Component the developer likes to add.
 * 
 * Copyright (C) 2012 Herve Guillaume, Benjamin Sigg
 * 
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
 * 
 * Herve Guillaume
 * [email protected]
 * FR - France
 *
 * Benjamin Sigg
 * [email protected]
 * CH - Switzerland
 */

package bibliothek.gui.dock.station.toolbar;

import bibliothek.gui.DockStation;
import bibliothek.gui.Dockable;
import bibliothek.gui.Orientation;
import bibliothek.gui.dock.AbstractToolbarDockStation;
import bibliothek.gui.dock.ScreenDockStation;
import bibliothek.gui.dock.ToolbarContainerDockStation;
import bibliothek.gui.dock.ToolbarDockStation;
import bibliothek.gui.dock.ToolbarGroupDockStation;
import bibliothek.gui.dock.ToolbarItemDockable;
import bibliothek.gui.dock.station.ToolbarTabDockStation;

/**
 * The default implementation of {@link ToolbarStrategy}.
 * 
 * Reminder: the toolbar API defines one dockable {@link ComponentDockable} and
 * three dockstation layers: {@link ToolbarDockStation},
 * {@link ToolbarGroupDockStation} and {@link ToolbarContainerDockStation}.
 * 

 * A ComponentDockable can be put in the three layers. A
 * ToolbarDockStation acts exactly the same. A
 * ToolbarGroupDockStation can be put only in a
 * ToolbarGroupDockStation (with some constraints, but this
 * constraints are handled by the station itself) or in
 * ToolbarContainerDockStation.
 * 

 * About the layers (and not about the question to know if a station accept a
 * particular dockable), in the layer hierarchy, a station can only contains the
 * immediate lower dockable:
 * 

 *  ToolbarContainerDockStation <=
 * ToolbarGroupDockStation
 * 
 ToolbarGroupDockStation <= ToolbarDockStation
 * 
 ToolbarDockStation <= ComponentDockable
 * 
 * 
 * @author Benjamin Sigg
 * @author Herve Guillaume
 */
public class DefaultToolbarStrategy implements ToolbarStrategy{

	@Override
	public Dockable ensureToolbarLayer( DockStation station, Dockable dockable ){
		if (station instanceof ToolbarDockStation){
			return dockable;
		}

		if (station instanceof ToolbarGroupDockStation){
			if (dockable instanceof ToolbarDockStation){
				return dockable;
			} else{
				ToolbarDockStation replacement = new ToolbarDockStation();
				replacement.setOrientation( getOrientation( dockable ) );
				return replacement;
			}
		}

		if ((station instanceof ToolbarContainerDockStation)
				|| (station instanceof ScreenDockStation)){
			if (dockable instanceof ToolbarGroupDockStation){
				return dockable;
			} else{
				ToolbarGroupDockStation replacement = new ToolbarGroupDockStation();
				replacement.setOrientation( getOrientation( dockable ) );
				return replacement;
			}
		}

		return null;
	}
	
	/**
	 * Tells what orientation should be applied to the parent of dockable.
	 * @param dockable some item that is dropped
	 * @return the preferred orientation of the parent
	 */
	protected Orientation getOrientation( Dockable dockable ){
		Orientation orientation = null;
		if( dockable instanceof ToolbarItemDockable ){
			orientation = ((ToolbarItemDockable)dockable).getOrientation();
		} else if( dockable instanceof AbstractToolbarDockStation ){
			orientation = ((AbstractToolbarDockStation)dockable).getOrientation();
		}
		if( orientation == null ){
			orientation = Orientation.HORIZONTAL;
		}
		return orientation;
	}

	@Override
	public boolean isToolbarGroupPartParent( DockStation parent,
			Dockable child, boolean strong ){
		if (strong){
			if (child instanceof ToolbarItemDockable){
				return (parent instanceof ToolbarDockStation);
			}

			if (child instanceof ToolbarDockStation){
				return parent instanceof ToolbarGroupDockStation;
			}

			if (child instanceof ToolbarGroupDockStation){
				return (parent instanceof ToolbarContainerDockStation)
						|| (parent instanceof ScreenDockStation || (parent instanceof ToolbarContainerDockStation));
			}

			return false;
		} else{
			// floating policy
			if (parent instanceof ScreenDockStation){
				return true;
			}

			// ?? policy
			if ((child instanceof ToolbarItemDockable)
					&& (parent instanceof ToolbarTabDockStation)){
				return true;
			}
			// docking and merging policy
			if (isToolbarParent(parent)){
				if ((child instanceof ToolbarItemDockable)
						|| (child instanceof ToolbarDockStation)){
					return true;
				} else if ((child instanceof ToolbarGroupDockStation)
						&& ((parent instanceof ToolbarGroupDockStation) || (parent instanceof ToolbarContainerDockStation))){
					return true;
				} else{
					return false;
				}
			} else{
				return false;
			}
		}
	}

	private boolean isToolbarParent( DockStation station ){
		return station instanceof AbstractToolbarDockStation
				|| station instanceof ToolbarContainerDockStation;
	}

	@Override
	public boolean isToolbarGroupPart( Dockable dockable ){
		return dockable instanceof ToolbarItemDockable
				|| (dockable instanceof ToolbarDockStation)
				|| (dockable instanceof ToolbarGroupDockStation);
	}

	@Override
	public boolean isToolbarPart( Dockable dockable ){
		return (dockable instanceof ToolbarGroupDockStation)
				|| isToolbarGroupPart(dockable);
	}
}