// RAP [rh] Deprecated interface INestableKeyBindingService not implemented
///*******************************************************************************
// * Copyright (c) 2000, 2008 IBM Corporation 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
// *******************************************************************************/
//package org.eclipse.ui;
//
//import org.eclipse.ui.services.IServiceLocator;
//
///**
// * <p>
// * A service that is capable of nesting other services within itself.  This 
// * allows lower level components to query for a service provider in a 
// * hierarchical fashion, and for information to be resolved in a hierarchical
// * manner
// * </p>
// * <p>
// * This interface is not intended to be implemented or extended by clients.
// * </p>
// * 
// * @since 2.1.3
// * @deprecated This is now handled by {@link IServiceLocator} which can
// * be nested.
// * @noimplement This interface is not intended to be implemented by clients.
// */
//public interface INestableKeyBindingService extends IKeyBindingService {
//
//    /**
//     * Marks the service associated with <code>nestedSite</code> as active if
//     * one exists.  If there is no service associated, then nothing changes.
//     * Calling this method with <code>null</code> forces deactivation of the
//     * current service.
//     * 
//     * @param nestedSite The site whose service should be activated; 
//     * <code>null</code> if the current service should be deactivated.
//     * @return <code>true</code> if a service is activated (or deactivated, in
//     * the case of a <code>null</code> parameter); <code>false</code> if
//     * nothing changed.
//     */
//    public boolean activateKeyBindingService(IWorkbenchSite nestedSite);
//
//    /**
//     * An accessor for the nested key binding service associated with a
//     * particular site.  If the key binding service does not exist for this
//     * <code>nestedSite</code> already, then a new one should be constructed.
//     * 
//     * @param nestedSite The site for which the service should be found; 
//     * should not be <code>null</code>.
//     * @return The associated service, if any; or a new associated service, if
//     * none existed previously.
//     */
//    public IKeyBindingService getKeyBindingService(IWorkbenchSite nestedSite);
//
//    /**
//     * Removes a nested key binding service from this key binding service.  The
//     * service to remove is determined by the <code>nestedSite</code> with
//     * which it is associated.
//     * 
//     * @param nestedSite The site from which to remove the nested service.
//     * This site must not be <code>null</code>.
//     * @return <code>true</code> if the service existed and could be removed; 
//     * <code>false</code> otherwise.
//     */
//    public boolean removeKeyBindingService(IWorkbenchSite nestedSite);
//
//}