bibliothek.gui.dock.control.focus.DefaultFocusStrategy 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) 2010 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.control.focus;

import java.awt.Component;
import java.util.HashMap;
import java.util.Map;

import javax.swing.JComboBox;
import javax.swing.SwingUtilities;

import bibliothek.gui.DockController;
import bibliothek.gui.Dockable;
import bibliothek.gui.dock.FlapDockStation;
import bibliothek.gui.dock.control.DockRegister;
import bibliothek.gui.dock.event.DockRegisterAdapter;
import bibliothek.gui.dock.event.DockRegisterListener;

/**
 * The {@link DefaultFocusStrategy} keeps track of the last focused {@link Component} of any
 * {@link Dockable} that is registered at a {@link DockController}.
 * @author Benjamin Sigg
 */
public class DefaultFocusStrategy implements FocusStrategy{
	/** the controller to monitor for new {@link Dockable}s */
	private DockController controller;
	
	/** all the currently observed {@link Dockable}s */
	private Map trackers = new HashMap(); 
	
	/** is informed about new {@link Dockable}s */
	private DockRegisterListener listener = new DockRegisterAdapter(){
		public void dockableRegistered( DockController controller, Dockable dockable ){
			add( dockable );
		}
		
		public void dockableUnregistered( DockController controller, Dockable dockable ){
			remove( dockable );
		}
	};
	
	public DefaultFocusStrategy( DockController controller ){
		this.controller = controller;
	}
	
	public boolean shouldFocusAfterDrop( Dockable dockable ){
		return !(dockable.getDockParent() instanceof FlapDockStation);
	}
	
	/**
	 * Tells whether the non-focusable component in reality is focusable. This is true
	 * for example for any child of a {@link JComboBox}.
	 * @param component the component which seems to be not focusable, but in reality is focusable
	 * @param request information about the item that gains the focus
	 * @return true if component should be treated as if it would be focusable
	 */
	protected boolean focusable( Component component, FocusStrategyRequest request ){
		while( component != null ){
			if( component instanceof JComboBox ){
				return true;
			}
			component = component.getParent();
		}
		return false;
	}
	
	/**
	 * Tells whether the focusable {@link Component} component should be treated like a non-focusable
	 * Component.
	 * @param component some focusable component which may get the focus
	 * @param request information about the item that gains the focus
	 * @return true if component should be treated as if it were not focusable
	 */
	protected boolean excluded( Component component, FocusStrategyRequest request ){
		return request.excluded( component );
	}
	
	public Component getFocusComponent( FocusStrategyRequest request ){
		Component mouseClicked = request.getMouseClicked();
		Dockable dockable = request.getDockable();
		
		if( mouseClicked != null ){
			if( (mouseClicked.isFocusable() && !excluded( mouseClicked, request )) || focusable( mouseClicked, request )){
				return mouseClicked;
			}
		}
		
		Tracker tracker = trackers.get( dockable.getComponent() );
		if( tracker == null ){
			return null;
		}
		return tracker.getLastFocused();
	}
	
	public void bind(){
		DockRegister register = controller.getRegister();
		register.addDockRegisterListener( listener );
		for( int i = 0, n = register.getDockableCount(); i