bundles/org.eclipse.ui.views/src/org/eclipse/ui/views/framelist/ForwardAction.java

/************************************************************************
Copyright (c) 2000, 2003 IBM Corporation and others.
All rights reserved.   This program and the accompanying materials
are made available under the terms of the Common Public License v1.0
which accompanies this distribution, and is available at
http://www.eclipse.org/legal/cpl-v10.html

Contributors:
	IBM - Initial implementation
************************************************************************/
package org.eclipse.ui.views.framelist;

import org.eclipse.ui.ISharedImages;
import org.eclipse.ui.PlatformUI;
import org.eclipse.ui.help.WorkbenchHelp;

/**
 * Generic "Forward" action which goes forward one frame.
 */
public class ForwardAction extends FrameAction {

	/**
	 * Constructs a new action for the specified frame list.
	 * 
	 * @param frameList the frame list
	 */
	public ForwardAction(FrameList frameList) {
		super(frameList);
		setText(FrameListMessages.getString("Forward.text")); //$NON-NLS-1$
		ISharedImages images = PlatformUI.getWorkbench().getSharedImages();
		setHoverImageDescriptor(images.getImageDescriptor(ISharedImages.IMG_TOOL_FORWARD_HOVER));
		setImageDescriptor(images.getImageDescriptor(ISharedImages.IMG_TOOL_FORWARD));
		setDisabledImageDescriptor(images.getImageDescriptor(ISharedImages.IMG_TOOL_FORWARD_DISABLED));
		WorkbenchHelp.setHelp(this, IFrameListHelpContextIds.FORWARD_ACTION);
		update();
	}

	private Frame getNextFrame() {
		FrameList list = getFrameList();
		return list.getFrame(list.getCurrentIndex() + 1);
	}

	private String getToolTipText(Frame nextFrame) {
		if (nextFrame != null) {
			String text = nextFrame.getToolTipText();
			if (text != null && text.length() > 0) {
				return FrameListMessages.format("Forward.toolTipOneArg", new Object[] { text }); //$NON-NLS-1$
			}
		}
		return FrameListMessages.getString("Forward.toolTip"); //$NON-NLS-1$
	}

	/**
	 * Calls <code>forward()</code> on the frame list.
	 */
	public void run() {
		getFrameList().forward();
	}

	/**
	 * Updates this action's enabled state and tool tip text.
	 * This action is enabled only when there is a next frame in the frame list.
	 * The tool tip text is "Forward to " plus the tool tip text for the next
	 * frame.
	 */
	public void update() {
		super.update();
		Frame nextFrame = getNextFrame();
		setEnabled(nextFrame != null);
		setToolTipText(getToolTipText(nextFrame));
	}

}