bibliothek.gui.dock.common.event.CDockableLocationEvent Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of docking-frames-common Show documentation
DockingFrames is an open source Java Swing docking framework, licenced under LGPL 2.1. This is the same distribution as the original distribution (http://www.docking-frames.org/), only reinstalled in maven
There is a newer version: 1.1.2p20b.fix-1
Show newest version
/*
 * 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) 2011 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
 * 
 * Benjamin Sigg
 * [email protected]
 * CH - Switzerland
 */
package bibliothek.gui.dock.common.event;

import bibliothek.gui.dock.common.CLocation;
import bibliothek.gui.dock.common.intern.CDockable;
import bibliothek.util.Todo;
import bibliothek.util.Todo.Compatibility;
import bibliothek.util.Todo.Priority;
import bibliothek.util.Todo.Version;

/**
 * This event object is given to a {@link CDockableLocationListener} if the location or the visibility to the
 * user of a {@link CDockable} changed.

 * Please note that any location can be null.
 * @author Benjamin Sigg
 */
public class CDockableLocationEvent {
	private CDockable dockable;
	
	private boolean oldShowing;
	private boolean newShowing;
	
	private boolean locationChanged;
	private CLocation oldLocation;
	private CLocation newLocation;
	
	/**
	 * Creates a new event.
	 * @param dockable the source of the event
	 * @param oldShowing the old visibility state
	 * @param newShowing the new visibility state
	 * @param oldLocation the old location, may be null
	 * @param newLocation the new location, may be null
	 */
	public CDockableLocationEvent( CDockable dockable, boolean oldShowing, boolean newShowing, CLocation oldLocation, CLocation newLocation ){
		this.dockable = dockable;
		this.oldShowing = oldShowing;
		this.newShowing = newShowing;
		this.oldLocation = oldLocation;
		this.newLocation = newLocation;
		
		if( oldLocation == null && newLocation != null ){
			locationChanged = true;
		}
		else if( oldLocation != null && !oldLocation.equals( newLocation )){
			locationChanged = true;
		}
	}

	/**
	 * Gets the dockable whose state changed.
	 * @return the element whose state changed
	 */
	public CDockable getDockable(){
		return dockable;
	}
	
	/**
	 * Tells whether the location of the dockable changed.
	 * @return whether the location changed
	 */
	public boolean isLocationChanged(){
		return locationChanged;
	}
	
	/**
	 * Gets the location of the dockable before this event
	 * @return the old location, can be null
	 */
	public CLocation getOldLocation(){
		return oldLocation;
	}
	
	/**
	 * Gets the location of the dockable after this event
	 * @return the new location, can be null
	 */
	public CLocation getNewLocation(){
		return newLocation;
	}
	
	/**
	 * Tells whether the visibility state of the dockable changed
	 * @return whether the visibility state changed
	 * @deprecated this method gets replaced by {@link #isShowingChanged()}
	 */
	@Deprecated
	@Todo( compatibility=Compatibility.BREAK_MAJOR, priority=Priority.ENHANCEMENT, target=Version.VERSION_1_1_3, description="remove this method" )
	public boolean isVisibleChanged(){
		return oldShowing != newShowing;
	}
	
	/**
	 * Tells whether the showing state of the dockable changed
	 * @return whether the showing state changed
	 */
	public boolean isShowingChanged(){
		return oldShowing != newShowing;
	}
	
	/**
	 * Tells whether the user could see the dockable before this event
	 * @return the old visibility state
	 * @deprecated replaced by {@link #getOldShowing()}
	 */
	@Deprecated
	@Todo( compatibility=Compatibility.BREAK_MAJOR, priority=Priority.ENHANCEMENT, target=Version.VERSION_1_1_3, description="remove this method" )
	public boolean getOldVisible(){
		return oldShowing;
	}
	
	/**
	 * Tells whether the user could see the dockable before this event
	 * @return the old visibility state
	 */
	public boolean getOldShowing(){
		return oldShowing;
	}
	
	/**
	 * Tells whether the user can see the dockable after this event
	 * @return the new visibility state
	 * @deprecated replaced by {@link #getNewShowing()}
	 */
	@Todo( compatibility=Compatibility.BREAK_MAJOR, priority=Priority.ENHANCEMENT, target=Version.VERSION_1_1_3, description="remove this method" )
	@Deprecated
	public boolean getNewVisible(){
		return newShowing;
	}
	
	/**
	 * Tells whether the user can see the dockable after this event
	 * @return the new visibility state
	 */
	public boolean getNewShowing(){
		return newShowing;
	}
	
	@Override
	public String toString(){
		StringBuilder builder = new StringBuilder();
		builder.append( getClass().getSimpleName() ).append( "[" );
		if( isVisibleChanged() ){
			builder.append( "SHOWING: " ).append( oldShowing ).append( " -> " ).append( newShowing );
		}
		if( isLocationChanged() ){
			if( isVisibleChanged() ){
				builder.append( ", " );
			}
			builder.append( "LOCATION: " ).append( oldLocation ).append( " -> " ).append( newLocation );
		}
		builder.append( "]" );
		return builder.toString();
	}
}