| /******************************************************************************* |
| * Copyright (c) 2004, 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.intro.config; |
| |
| /** |
| * An interface between a content provider and its parent container. A content |
| * provider is responsible for creating dynamic intro content, while the content |
| * provider site is responsible for reflowing the new content in the intro part. |
| * An intro content provider site may have more than one content provider. The |
| * id of the content provider can be used to distinguish the source of the |
| * reflow. |
| * <p> |
| * This interface is not intended to be implemented or extended by clients. |
| * |
| * @since 3.0.1 |
| * @noimplement This interface is not intended to be implemented by clients. |
| * @noextend This interface is not intended to be extended by clients. |
| */ |
| public interface IIntroContentProviderSite { |
| /** |
| * This method will be called when the IIntroContentProvider is notified |
| * that its content has become stale. For an HTML presentation, the whole |
| * page should be regenerated. An SWT presentation should cause the page's |
| * layout to be updated. |
| * |
| * @param provider |
| * the content provider that requests a reflow |
| * @param incremental |
| * if <code>true</code>, an attempt should be made to |
| * incrementally reflow the page. Otherwise, the page should be |
| * recreated from scratch. This is just a hint and the |
| * implementation of the interface can ignore it. |
| */ |
| public void reflow(IIntroContentProvider provider, boolean incremental); |
| } |