plugins/org.eclipse.eef.ide.ui/src/org/eclipse/eef/ide/ui/api/widgets/IEEFLifecycleManager.java

/*******************************************************************************
 * Copyright (c) 2015, 2018 Obeo.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v2.0
 * which accompanies this distribution, and is available at
 * https://www.eclipse.org/legal/epl-2.0
 *
 * SPDX-License-Identifier: EPL-2.0
 *
 * Contributors: Obeo - initial API and implementation
 *******************************************************************************/
package org.eclipse.eef.ide.ui.api.widgets;

import org.eclipse.eef.common.ui.api.IEEFFormContainer;
import org.eclipse.swt.widgets.Composite;

/**
 * Implementations of this interface will be used to handle the lifecycle of the widgets and controllers created for a
 * description.
 *
 * @author sbegaudeau
 */
public interface IEEFLifecycleManager {
	/**
	 * Creates the controls for the description.
	 *
	 * @param parent
	 *            The composite parent
	 * @param formContainer
	 *            The form container
	 */
	void createControl(Composite parent, IEEFFormContainer formContainer);

	/**
	 * Prepares for the widgets to be shown.
	 */
	void aboutToBeShown();

	/**
	 * Refresh the widgets.
	 */
	void refresh();

	/**
	 * Prepares for the widgets to be hidden.
	 */
	void aboutToBeHidden();

	/**
	 * Disposes the content created. The widgets created under the composite will be disposed by SWT already.
	 */
	void dispose();
}