1 /******************************************************************************* 2 * Copyright (c) 2006, 2007 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 * Chris Gross (schtoo@schtoo.com) - initial API and implementation for bug 16179 10 * IBM Corporation - revisions to initial contribution 11 *******************************************************************************/ 12 package org.eclipse.jface.dialogs; 13 14 /** 15 * A listener which is notified when the current page of a multi-page dialog is 16 * changing. Use this listener to perform long-running work that should only be 17 * executed once, when the page is in the process of changing, rather then 18 * during validation of page controls. 19 * 20 * @see PageChangingEvent 21 * @since 3.3 22 */ 23 public interface IPageChangingListener { 24 25 /** 26 * Handle the an <code>IDialogPage</code> changing. 27 * 28 * The <code>doit</code> field of the <code>PageChangingEvent</code> 29 * must be set to false to prevent the page from changing. 30 * 31 * @param event 32 * event object describing the change 33 */ 34 public void handlePageChanging(PageChangingEvent event); 35 36 } 37