1 /******************************************************************************* 2 * Copyright (c) 2000, 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.search.ui; 12 /** 13 * Listener interface for changes to an <code>ISearchResult</code>. 14 * Implementers of <code>ISearchResult</code> should define subclasses of 15 * <code>SearchResultEvent</code> and send those to registered listeners. Implementers of 16 * <code>ISearchResultListener</code> will in general know the concrete class of search 17 * result they are listening to, and therefore the kind of events they 18 * have to handle. 19 * <p> 20 * Clients may implement this interface. 21 * </p> 22 * @since 3.0 23 */ 24 public interface ISearchResultListener { 25 /** 26 * Called to notify listeners of changes in a <code>ISearchResult</code>. 27 * The event object <code>e</code> is only guaranteed to be valid for 28 * the duration of the call. 29 * 30 * @param e the event object describing the change. Note that implementers 31 * of <code>ISearchResult</code> will be sending subclasses of 32 * <code>SearchResultEvent</code> 33 */ 34 void searchResultChanged(SearchResultEvent e); 35 } 36