1 /******************************************************************************* 2 * Copyright (c) 2006 IBM Corporation and others. 3 * All rights reserved. This program and the accompanying materials 4 * are made available under the terms of the Eclipse Public License v1.0 5 * which accompanies this distribution, and is available at 6 * http://www.eclipse.org/legal/epl-v10.html 7 * 8 * Contributors: 9 * IBM Corporation - initial API and implementation 10 ******************************************************************************/ 11 package org.eclipse.ui.internal; 12 13 /** 14 * This iterface is used to identify and call back to trim elements that can be 15 * repositioned to edges other than the one that they're defined as being in by 16 * default. 17 * <p> 18 * NOTE: This class is a part of a 'work in progress' and should not be used 19 * without consulting the Platform UI group. No guarantees are made as to the 20 * stability of the API (except that the javadoc will get better...;-). 21 * </p> 22 * 23 * @since 3.2 24 * 25 */ 26 public interface ITrimAreaChangeListener { 27 /** 28 * If a control's TrimLayoutData has a listener defined then this method 29 * will be called whenever the trim changes the orientation (i.e. side) that 30 * it's on. 31 * <p> 32 * The implementation should perform any adjustments to its control 33 * necessary to support it in its 'newOrientation' (i.e. changing a ToolBar 34 * from horizontal to vertical if it's been redocked to an area on the left 35 * or right side) 36 * </p> 37 * 38 * @param oldOrientation 39 * The SWT side that the trim was previously on. 40 * @param newOrientation 41 * The SWT side that the trim has been repositioned to 42 */ 43 public void areaChanged(int oldOrientation, int newOrientation); 44 } 45