plugins/org.eclipse.amalgam.explorer.activity.ui/src/org/eclipse/amalgam/explorer/activity/ui/api/editor/pages/ActivityExplorerPage.java - amalgam/org.eclipse.amalgam - Git at Google

 /*******************************************************************************
  * Copyright (c)  2006, 2015 THALES GLOBAL SERVICES.
  * 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:
  *    Thales - initial API and implementation
  *******************************************************************************/
 package org.eclipse.amalgam.explorer.activity.ui.api.editor.pages;

 import java.util.ArrayList;
 import java.util.List;
 import java.util.Set;
 import java.util.TreeSet;

 import org.eclipse.amalgam.explorer.activity.ui.ActivityExplorerActivator;
 import org.eclipse.amalgam.explorer.activity.ui.api.actions.AbstractDescriptionAction;
 import org.eclipse.amalgam.explorer.activity.ui.api.actions.DescriptionAction;
 import org.eclipse.amalgam.explorer.activity.ui.api.editor.ActivityExplorerEditor;
 import org.eclipse.amalgam.explorer.activity.ui.api.editor.input.ActivityExplorerEditorInput;
 import org.eclipse.amalgam.explorer.activity.ui.api.editor.pages.helper.HTMLHelper;
 import org.eclipse.amalgam.explorer.activity.ui.api.editor.pages.helper.FormHelper.LayoutType;
 import org.eclipse.amalgam.explorer.activity.ui.api.editor.predicates.IPredicate;
 import org.eclipse.amalgam.explorer.activity.ui.api.editor.sections.ActivityExplorerSection;
 import org.eclipse.amalgam.explorer.activity.ui.api.manager.ActivityExplorerManager;
 import org.eclipse.amalgam.explorer.activity.ui.internal.actions.util.FormTextPageLinkAdapter;
 import org.eclipse.amalgam.explorer.activity.ui.internal.actions.util.MDSashForm;
 import org.eclipse.amalgam.explorer.activity.ui.internal.extension.point.manager.ActivityExplorerExtensionManager;
 import org.eclipse.core.runtime.IConfigurationElement;
 import org.eclipse.jface.action.IAction;
 import org.eclipse.jface.util.IPropertyChangeListener;
 import org.eclipse.jface.util.PropertyChangeEvent;
 import org.eclipse.swt.SWT;
 import org.eclipse.swt.graphics.Image;
 import org.eclipse.swt.layout.GridData;
 import org.eclipse.swt.layout.GridLayout;
 import org.eclipse.swt.widgets.Composite;
 import org.eclipse.swt.widgets.Control;
 import org.eclipse.swt.widgets.Listener;
 import org.eclipse.swt.widgets.Sash;
 import org.eclipse.ui.IActionBars;
 import org.eclipse.ui.forms.IManagedForm;
 import org.eclipse.ui.forms.editor.IFormPage;
 import org.eclipse.ui.forms.widgets.Form;
 import org.eclipse.ui.forms.widgets.FormText;
 import org.eclipse.ui.forms.widgets.ScrolledForm;
 import org.eclipse.ui.forms.widgets.TableWrapLayout;

 /**
  * Base class to implement architecture Activity Explorer page.
  *
  */
 public class ActivityExplorerPage extends AbstractActivityExplorerPage implements IPropertyChangeListener {

 	/**
 	 * Sash that layouts activities in one column and diagrams in another one.
 	 */
 	private MDSashForm _sashForm;

 	/**
 	 * Container that hosts all sections.
 	 */
 	private Composite _sectionContainer;

 	/**
 	 * Header title of the page
 	 */
 	private String title;
 	private Image headerImageOff, headerImageOn;
 	private String description;

 	/**
 	 * Constructor.
 	 *
 	 * @param editor_p
 	 * @param id_p
 	 * @param title_p
 	 */

 	private TreeSet<ActivityExplorerSection> sections;

 	public ActivityExplorerPage() {
 		super(); /* Page title is computed afterward */
 		sections = new TreeSet<ActivityExplorerSection>();
 		createContributedSections();
 	}

 	/**
 	 * Adjust image href.
 	 *
 	 * @param richText_p
 	 * @param used
 	 *            to collect image.
 	 */
 	protected void adjustImageHRef(FormText richText_p, ActivityExplorerActivator activator_p) {
 		if (headerImageOff != null)
 			adjustImageHRef(richText_p, headerImageOff, getId());
 	}

 	protected void adjustImageHRef(FormText richText_p, Image image, String id) {
 		if (image != null)
 			richText_p.setImage(id, image);
 	}

 	/**
 	 * Create contributed sections but not initialize it
 	 *
 	 * @param sectionContainer_p
 	 * @param managedForm_p
 	 */
 	private void createContributedSections() {
 		// Loop over pages contributors.
 		List<IConfigurationElement> sections = ActivityExplorerExtensionManager.getSectionsFromPageId(getId());

 		if (sections != null) {

 			for (IConfigurationElement contributor : sections) {
 				handleContributedSectionsFor(contributor);
 			}

 		}
 	}

 	private void initContributedSections(Composite sectionContainer_p, IManagedForm managedForm_p) {
 		// init and display the sessions in the page
 		for (ActivityExplorerSection s : getVisibleSections()) {
 			initializeSection(s, sectionContainer_p, managedForm_p);
 		}
 	}

 	protected List<ActivityExplorerSection> getVisibleSections() {
 		List<ActivityExplorerSection> visibleSections = new ArrayList<ActivityExplorerSection>();
 		for (ActivityExplorerSection s : getSections()) {
 			if (s.isVisible())
 				visibleSections.add(s);
 		}
 		return visibleSections;
 	}

 	/**
 	 * Initialize the sections
 	 *
 	 * @param section
 	 * @param sectionContainer_p
 	 * @param managedForm_p
 	 */
 	protected void initializeSection(ActivityExplorerSection section, Composite sectionContainer, IManagedForm managedForm) {
 		section.initialize(sectionContainer, this, managedForm);
 	}

 	@Override
 	protected void createFormContent(IManagedForm managedForm_p) {
 		super.createFormContent(managedForm_p);
 		// Set the header title.
 		ScrolledForm form = managedForm_p.getForm();
 		form.setText(getHeaderTitle());
 		// Install a default layout.
 		GridLayout layout = new GridLayout();
 		Composite body = form.getBody();
 		body.setLayout(layout);
 		_sashForm = new MDSashForm(body, SWT.NULL);
 		_sashForm.setData("form", managedForm_p); //$NON-NLS-1$
 		managedForm_p.getToolkit().adapt(_sashForm, false, false);
 		_sashForm.setMenu(form.getBody().getMenu());
 		// Install a default layout based on two columns.
 		_sashForm.setLayout(new GridLayout(2, false));
 		_sashForm.setLayoutData(new GridData(GridData.FILL_BOTH));
 		// The left one contains sections.
 		_sectionContainer = createSectionContainer(_sashForm, managedForm_p);

 		// Create header sections.
 		createHeaderSections(_sectionContainer, managedForm_p);

 		// init contributes sections.
 		initContributedSections(_sectionContainer, managedForm_p);

 		// Hook resize listener for the sash behavior.
 		hookResizeListener();
 		// Register as property listener, to live refresh check / unckeck
 		// sections.
 		ActivityExplorerActivator.getDefault().getPreferenceStore().addPropertyChangeListener(this);
 		// Force a layout to make sure, page is well refreshed.
 		managedForm_p.reflow(true);
 	}

 	/**
 	 * Rebuild the page.
 	 */
 	public void updatePageForm() {
 		if (!_sectionContainer.isDisposed()) {
 			for (Control c : _sectionContainer.getChildren()) {
 				c.dispose();
 			}
 			createHeaderSections(_sectionContainer, getManagedForm());
 			initContributedSections(_sectionContainer, getManagedForm());
 		}
 	}

 	/**
 	 * Create the overview section.
 	 *
 	 * @param sectionContainer_p
 	 * @param managedForm_p
 	 * @return
 	 */
 	protected void createOverviewSection(Composite sectionContainer_p, IManagedForm managedForm_p) {

 		final IFormPage previousPage = getEditor().getPreviousPage(this);
 		final IFormPage nextPage = getEditor().getNextPage(this);

 		// create rich text
 		String body = HTMLHelper.breadcrumbForm(previousPage, this, nextPage);

 		FormText richText = org.eclipse.amalgam.explorer.activity.ui.api.editor.pages.helper.FormHelper.createRichText(
 				managedForm_p.getToolkit(), sectionContainer_p, body, new FormTextPageLinkAdapter(getEditor()));

 		// attach image to link
 		adjustImageHRef(richText, getHeaderImageOn(), getId());

 		if (previousPage != null && previousPage instanceof ActivityExplorerPage)
 			adjustImageHRef(richText, ((ActivityExplorerPage) previousPage).getHeaderImageOff(), previousPage.getId());
 		if (nextPage != null && nextPage instanceof ActivityExplorerPage)
 			adjustImageHRef(richText, ((ActivityExplorerPage) nextPage).getHeaderImageOff(), nextPage.getId());

 		richText.marginHeight = 0;
 		richText.marginWidth = 0;

 	}

 	/**
 	 * Create the container that hosts sections.<br>
 	 * This one layouts its content using a {@link TableWrapLayout} to allow
 	 * sections to have wrapped hyper controls.
 	 *
 	 * @param parent_p
 	 * @param managedForm_p
 	 */
 	protected Composite createSectionContainer(Composite parent_p, IManagedForm managedForm_p) {
 		Composite container = org.eclipse.amalgam.explorer.activity.ui.api.editor.pages.helper.FormHelper
 				.createCompositeWithLayoutType(managedForm_p.getToolkit(), parent_p, LayoutType.TABLEWRAP_LAYOUT, 1,
 						true);
 		container.setLayoutData(new GridData(SWT.FILL, SWT.FILL, false, true));
 		return container;
 	}

 	/**
 	 * Create section displayed in this page.<br>
 	 * Default implementation return <code>null</code>.
 	 *
 	 * @param sectionContainer_p
 	 * @return First created section. This one is used to enable UI alignment
 	 *         with Diagram viewer section.
 	 */
 	protected void createHeaderSections(final Composite sectionContainer_p, IManagedForm managedForm_p) {

 		// Create Overview section.
 		AbstractDescriptionAction displayDescription = new DescriptionAction(sectionContainer_p.getShell(),
 				getPageDescription());
 		Form formWidget = managedForm_p.getForm().getForm();
 		formWidget.getMenuManager().add(displayDescription);
 		formWidget.getToolBarManager().add(displayDescription);
 		formWidget.getToolBarManager().update(true);

 		createOverviewSection(sectionContainer_p, managedForm_p);
 	}

 	/**
 	 * Create viewer container that hosts the viewer.<br>
 	 * This one layouts its content using a {@link GridLayout}.
 	 *
 	 * @param parent_p
 	 * @param managedForm_p
 	 * @return
 	 */
 	/*
 	 * protected Composite createViewerContainer(Composite parent_p,
 	 * IManagedForm managedForm_p) { return
 	 * FormHelper.createCompositeWithLayoutType(managedForm_p.getToolkit(),
 	 * parent_p, LayoutType.GRID_LAYOUT, 1, true); }
 	 */

 	/**
 	 * Declare viewer actions.<br>
 	 * This methods is called eache time the menu is pop-up.
 	 *
 	 * @param contextMenuManager_p
 	 * @param treeViewer_p
 	 */

 	/**
 	 * @see org.eclipse.ui.forms.editor.FormPage#dispose()
 	 */
 	@Override
 	public void dispose() {
 		// Unregister as property listener.
 		ActivityExplorerActivator.getDefault().getPreferenceStore().removePropertyChangeListener(this);

 		super.dispose();
 	}

 	/**
 	 * Handle property change.<br>
 	 *
 	 * @param event_p
 	 * @param value_p
 	 * @param property_p
 	 * @return boolean
 	 */

 	protected boolean doPropertyChange(PropertyChangeEvent event_p, boolean value_p, String property_p) {
 		boolean result = false;

 		if (isSection(property_p)) {
 			updatePageForm();
 			result = true;
 		}

 		return result;
 	}

 	/**
 	 * Test if the id is a Activity Explorer page.
 	 *
 	 * @param id
 	 * @return boolean
 	 */
 	private boolean isSection(String id) {
 		return ActivityExplorerExtensionManager.isSection(getId(), id);
 	}

 	/**
 	 * Get a ActivityExplorerSection in the page from its id.
 	 *
 	 * @param id
 	 */
 	protected ActivityExplorerSection getSectionById(final String id) {
 		ActivityExplorerSection result = null;
 		for (ActivityExplorerSection section : getSections()) {
 			if (section.getId().equals(id)) {
 				result = section;
 			}
 		}
 		return result;
 	}

 	/**
 	 * {@inheritDoc}
 	 */
 	@Override
 	public ActivityExplorerEditor getEditor() {
 		return (ActivityExplorerEditor) super.getEditor();
 	}

 	/**
 	 * @see org.eclipse.ui.part.EditorPart#getEditorInput()
 	 */
 	@Override
 	public ActivityExplorerEditorInput getEditorInput() {
 		return (ActivityExplorerEditorInput) super.getEditorInput();
 	}

 	/**
 	 * Get the header page title.
 	 *
 	 * @return
 	 */
 	protected String getHeaderTitle() {
 		return title;
 	}

 	/**
 	 * Set the header page title.
 	 *
 	 * @param title_p
 	 */
 	protected void setHeaderTitle(String title_p) {
 		title = title_p;
 	}

 	/**
 	 * Get the XML file that defines the form text content for the description
 	 * of the page.<br>
 	 * Returned path must be relative to
 	 * <code>org.eclipse.amalgam.explorer.activity.ui/xml</code> folder.<br>
 	 *
 	 * @return
 	 */
 	public String getPageDescription() {
 		return description;
 	}

 	/**
 	 * Get the section container.
 	 *
 	 * @return the sectionContainer
 	 */
 	protected Composite getSectionContainer() {
 		return _sectionContainer;
 	}

 	public Set<ActivityExplorerSection> getSections() {
 		return sections;
 	}

 	/**
 	 * Handle contributed sections for specified Activity Explorer page provider.
 	 *
 	 *
 	 * @param contributor_p
 	 * @param sectionContainer_p
 	 * @param managedForm_p
 	 */
 	protected void handleContributedSectionsFor(IConfigurationElement contributor_p) {

 		// create a Activity Explorer section
 		ActivityExplorerSection section = new ActivityExplorerSection(contributor_p) {
 			@Override
 			protected IAction[] getToolBarActions() {
 				IAction[] toolbarActions = new IAction[] { new DescriptionAction(ActivityExplorerPage.this.getSite()
 						.getShell(), description)

 				};

 				return toolbarActions;
 			}
 		};

 		// sort
 		sections.add(section);

 	}

 	/**
 	 * Hook resize listener for sash form.
 	 */
 	protected void hookResizeListener() {
 		Listener listener = _sashForm.getListener();
 		Control[] children = _sashForm.getChildren();
 		for (Control element : children) {
 			if (element instanceof Sash) {
 				continue;
 			}
 			element.addListener(SWT.Resize, listener);
 		}
 	}

 	/**
 	 * @see org.eclipse.jface.util.IPropertyChangeListener#propertyChange(org.eclipse.jface.util.PropertyChangeEvent)
 	 */
 	public void propertyChange(PropertyChangeEvent event_p) {
 		String property = event_p.getProperty();
 		boolean value = ((Boolean) event_p.getNewValue()).booleanValue();

 		if (doPropertyChange(event_p, value, property)) {
 			if (ActivityExplorerManager.INSTANCE.getEditor() != null)
 				ActivityExplorerManager.INSTANCE.getEditor().getActivePageInstance().getManagedForm().reflow(true);
 		}
 	}

 	/**
 	 * @see org.eclipse.ui.forms.editor.FormPage#setActive(boolean)
 	 */
 	@Override
 	public void setActive(boolean active_p) {
 		super.setActive(active_p);
 		if (active_p) {
 			// Set a new selection to the property sheet page on Activity Explorer page
 			// activation.
 			// setCurrentPageSelectionToPropertySheetPage();
 			updateActionBars();
 		}
 	}

 	/**
 	 * Refresh the property sheet page according to the current viewer
 	 * selection.<br>
 	 * {@link #getViewer()}.
 	 */
 	/*
 	 * protected void setCurrentPageSelectionToPropertySheetPage() { // Call the
 	 * property sheet page without loading it. // Indeed, we won't load it if
 	 * the view is not displayed. TabbedPropertySheetPage propertySheetPage =
 	 * getEditor().getPropertySheetPage(); if (null != propertySheetPage) {
 	 * propertySheetPage.selectionChanged(getEditor(),
 	 * getViewer().getSelection()); } }
 	 */

 	/**
 	 * Update action bars (handlers).
 	 *
 	 * @param editorActionBars
 	 */
 	public void updateActionBars() {
 		IActionBars editorActionBars = getEditorSite().getActionBars();
 		// Update action bars to make sure global ActionHandler are updated
 		// accordingly.
 		editorActionBars.updateActionBars();
 	}

 	/**
 	 * Initialize the Page with parameters.
 	 */
 	public void setInitializationData(IConfigurationElement cfig, String propertyName, Object data) {
 		super.setInitializationData(cfig, propertyName, data);

 		String title = ActivityExplorerExtensionManager.getTitle(cfig);
 		setHeaderTitle(title);

 		Image image = ActivityExplorerExtensionManager.getImageOff(cfig);
 		if (image != null) {
 			setHeaderImageOff(image);

 		}

 		image = ActivityExplorerExtensionManager.getImageOn(cfig);
 		if (image != null) {
 			setHeaderImageOn(image);

 		}

 		String description = ActivityExplorerExtensionManager.getDescription(cfig);
 		if (null != description)
 			setPageDescription(HTMLHelper.formWrapper(description));

 		String indice = ActivityExplorerExtensionManager.getIndex(cfig);
 		setIndex(Integer.parseInt(indice));
 	}

 	/**
 	 * Set the page description.
 	 *
 	 * @param description_p
 	 */

 	private void setPageDescription(String description_p) {
 		description = description_p;
 	}

 	/**
 	 * Set Header Image Off.
 	 *
 	 * @param image_p
 	 */
 	protected void setHeaderImageOff(Image image_p) {
 		headerImageOff = image_p;

 	}

 	/**
 	 * Set Header Image On.
 	 *
 	 * @param image_p
 	 */
 	protected void setHeaderImageOn(Image image_p) {
 		headerImageOn = image_p;

 	}

 	/**
 	 * Get Image Off.
 	 *
 	 * @return Image
 	 */
 	public Image getHeaderImageOff() {
 		return headerImageOff;
 	}

 	/**
 	 * Get header image On.
 	 *
 	 * @return Image
 	 */
 	public Image getHeaderImageOn() {
 		return headerImageOn;
 	}

 	/**
 	 * Return true this page is visible.
 	 */
 	@Override
 	public boolean isVisible() {
 		boolean result = ActivityExplorerActivator.getDefault().getPreferenceStore().getBoolean(getId());
 		if (predicate != null) {
 			result &= predicate.isOk();
 		}
 		return result;
 	}

 	/**
 	 * Get the applied Predicate.
 	 *
 	 * @return {@link IPredicate}
 	 */
 	public IPredicate getPredicate() {
 		return predicate;
 	}
 }
	/*******************************************************************************
	* Copyright (c) 2006, 2015 THALES GLOBAL SERVICES.
	* 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:
	* Thales - initial API and implementation
	*******************************************************************************/
	package org.eclipse.amalgam.explorer.activity.ui.api.editor.pages;

	import java.util.ArrayList;
	import java.util.List;
	import java.util.Set;
	import java.util.TreeSet;

	import org.eclipse.amalgam.explorer.activity.ui.ActivityExplorerActivator;
	import org.eclipse.amalgam.explorer.activity.ui.api.actions.AbstractDescriptionAction;
	import org.eclipse.amalgam.explorer.activity.ui.api.actions.DescriptionAction;
	import org.eclipse.amalgam.explorer.activity.ui.api.editor.ActivityExplorerEditor;
	import org.eclipse.amalgam.explorer.activity.ui.api.editor.input.ActivityExplorerEditorInput;
	import org.eclipse.amalgam.explorer.activity.ui.api.editor.pages.helper.HTMLHelper;
	import org.eclipse.amalgam.explorer.activity.ui.api.editor.pages.helper.FormHelper.LayoutType;
	import org.eclipse.amalgam.explorer.activity.ui.api.editor.predicates.IPredicate;
	import org.eclipse.amalgam.explorer.activity.ui.api.editor.sections.ActivityExplorerSection;
	import org.eclipse.amalgam.explorer.activity.ui.api.manager.ActivityExplorerManager;
	import org.eclipse.amalgam.explorer.activity.ui.internal.actions.util.FormTextPageLinkAdapter;
	import org.eclipse.amalgam.explorer.activity.ui.internal.actions.util.MDSashForm;
	import org.eclipse.amalgam.explorer.activity.ui.internal.extension.point.manager.ActivityExplorerExtensionManager;
	import org.eclipse.core.runtime.IConfigurationElement;
	import org.eclipse.jface.action.IAction;
	import org.eclipse.jface.util.IPropertyChangeListener;
	import org.eclipse.jface.util.PropertyChangeEvent;
	import org.eclipse.swt.SWT;
	import org.eclipse.swt.graphics.Image;
	import org.eclipse.swt.layout.GridData;
	import org.eclipse.swt.layout.GridLayout;
	import org.eclipse.swt.widgets.Composite;
	import org.eclipse.swt.widgets.Control;
	import org.eclipse.swt.widgets.Listener;
	import org.eclipse.swt.widgets.Sash;
	import org.eclipse.ui.IActionBars;
	import org.eclipse.ui.forms.IManagedForm;
	import org.eclipse.ui.forms.editor.IFormPage;
	import org.eclipse.ui.forms.widgets.Form;
	import org.eclipse.ui.forms.widgets.FormText;
	import org.eclipse.ui.forms.widgets.ScrolledForm;
	import org.eclipse.ui.forms.widgets.TableWrapLayout;

	/**
	* Base class to implement architecture Activity Explorer page.
	*
	*/
	public class ActivityExplorerPage extends AbstractActivityExplorerPage implements IPropertyChangeListener {

	/**
	* Sash that layouts activities in one column and diagrams in another one.
	*/
	private MDSashForm _sashForm;

	/**
	* Container that hosts all sections.
	*/
	private Composite _sectionContainer;

	/**
	* Header title of the page
	*/
	private String title;
	private Image headerImageOff, headerImageOn;
	private String description;

	/**
	* Constructor.
	*
	* @param editor_p
	* @param id_p
	* @param title_p
	*/

	private TreeSet<ActivityExplorerSection> sections;

	public ActivityExplorerPage() {
	super(); /* Page title is computed afterward */
	sections = new TreeSet<ActivityExplorerSection>();
	createContributedSections();
	}

	/**
	* Adjust image href.
	*
	* @param richText_p
	* @param used
	* to collect image.
	*/
	protected void adjustImageHRef(FormText richText_p, ActivityExplorerActivator activator_p) {
	if (headerImageOff != null)
	adjustImageHRef(richText_p, headerImageOff, getId());
	}

	protected void adjustImageHRef(FormText richText_p, Image image, String id) {
	if (image != null)
	richText_p.setImage(id, image);
	}

	/**
	* Create contributed sections but not initialize it
	*
	* @param sectionContainer_p
	* @param managedForm_p
	*/
	private void createContributedSections() {
	// Loop over pages contributors.
	List<IConfigurationElement> sections = ActivityExplorerExtensionManager.getSectionsFromPageId(getId());

	if (sections != null) {

	for (IConfigurationElement contributor : sections) {
	handleContributedSectionsFor(contributor);
	}

	}
	}

	private void initContributedSections(Composite sectionContainer_p, IManagedForm managedForm_p) {
	// init and display the sessions in the page
	for (ActivityExplorerSection s : getVisibleSections()) {
	initializeSection(s, sectionContainer_p, managedForm_p);
	}
	}

	protected List<ActivityExplorerSection> getVisibleSections() {
	List<ActivityExplorerSection> visibleSections = new ArrayList<ActivityExplorerSection>();
	for (ActivityExplorerSection s : getSections()) {
	if (s.isVisible())
	visibleSections.add(s);
	}
	return visibleSections;
	}

	/**
	* Initialize the sections
	*
	* @param section
	* @param sectionContainer_p
	* @param managedForm_p
	*/
	protected void initializeSection(ActivityExplorerSection section, Composite sectionContainer, IManagedForm managedForm) {
	section.initialize(sectionContainer, this, managedForm);
	}

	@Override
	protected void createFormContent(IManagedForm managedForm_p) {
	super.createFormContent(managedForm_p);
	// Set the header title.
	ScrolledForm form = managedForm_p.getForm();
	form.setText(getHeaderTitle());
	// Install a default layout.
	GridLayout layout = new GridLayout();
	Composite body = form.getBody();
	body.setLayout(layout);
	_sashForm = new MDSashForm(body, SWT.NULL);
	_sashForm.setData("form", managedForm_p); //$NON-NLS-1$
	managedForm_p.getToolkit().adapt(_sashForm, false, false);
	_sashForm.setMenu(form.getBody().getMenu());
	// Install a default layout based on two columns.
	_sashForm.setLayout(new GridLayout(2, false));
	_sashForm.setLayoutData(new GridData(GridData.FILL_BOTH));
	// The left one contains sections.
	_sectionContainer = createSectionContainer(_sashForm, managedForm_p);

	// Create header sections.
	createHeaderSections(_sectionContainer, managedForm_p);

	// init contributes sections.
	initContributedSections(_sectionContainer, managedForm_p);

	// Hook resize listener for the sash behavior.
	hookResizeListener();
	// Register as property listener, to live refresh check / unckeck
	// sections.
	ActivityExplorerActivator.getDefault().getPreferenceStore().addPropertyChangeListener(this);
	// Force a layout to make sure, page is well refreshed.
	managedForm_p.reflow(true);
	}

	/**
	* Rebuild the page.
	*/
	public void updatePageForm() {
	if (!_sectionContainer.isDisposed()) {
	for (Control c : _sectionContainer.getChildren()) {
	c.dispose();
	}
	createHeaderSections(_sectionContainer, getManagedForm());
	initContributedSections(_sectionContainer, getManagedForm());
	}
	}

	/**
	* Create the overview section.
	*
	* @param sectionContainer_p
	* @param managedForm_p
	* @return
	*/
	protected void createOverviewSection(Composite sectionContainer_p, IManagedForm managedForm_p) {

	final IFormPage previousPage = getEditor().getPreviousPage(this);
	final IFormPage nextPage = getEditor().getNextPage(this);

	// create rich text
	String body = HTMLHelper.breadcrumbForm(previousPage, this, nextPage);

	FormText richText = org.eclipse.amalgam.explorer.activity.ui.api.editor.pages.helper.FormHelper.createRichText(
	managedForm_p.getToolkit(), sectionContainer_p, body, new FormTextPageLinkAdapter(getEditor()));

	// attach image to link
	adjustImageHRef(richText, getHeaderImageOn(), getId());

	if (previousPage != null && previousPage instanceof ActivityExplorerPage)
	adjustImageHRef(richText, ((ActivityExplorerPage) previousPage).getHeaderImageOff(), previousPage.getId());
	if (nextPage != null && nextPage instanceof ActivityExplorerPage)
	adjustImageHRef(richText, ((ActivityExplorerPage) nextPage).getHeaderImageOff(), nextPage.getId());

	richText.marginHeight = 0;
	richText.marginWidth = 0;

	}

	/**
	* Create the container that hosts sections.<br>
	* This one layouts its content using a {@link TableWrapLayout} to allow
	* sections to have wrapped hyper controls.
	*
	* @param parent_p
	* @param managedForm_p
	*/
	protected Composite createSectionContainer(Composite parent_p, IManagedForm managedForm_p) {
	Composite container = org.eclipse.amalgam.explorer.activity.ui.api.editor.pages.helper.FormHelper
	.createCompositeWithLayoutType(managedForm_p.getToolkit(), parent_p, LayoutType.TABLEWRAP_LAYOUT, 1,
	true);
	container.setLayoutData(new GridData(SWT.FILL, SWT.FILL, false, true));
	return container;
	}

	/**
	* Create section displayed in this page.<br>
	* Default implementation return <code>null</code>.
	*
	* @param sectionContainer_p
	* @return First created section. This one is used to enable UI alignment
	* with Diagram viewer section.
	*/
	protected void createHeaderSections(final Composite sectionContainer_p, IManagedForm managedForm_p) {

	// Create Overview section.
	AbstractDescriptionAction displayDescription = new DescriptionAction(sectionContainer_p.getShell(),
	getPageDescription());
	Form formWidget = managedForm_p.getForm().getForm();
	formWidget.getMenuManager().add(displayDescription);
	formWidget.getToolBarManager().add(displayDescription);
	formWidget.getToolBarManager().update(true);

	createOverviewSection(sectionContainer_p, managedForm_p);
	}

	/**
	* Create viewer container that hosts the viewer.<br>
	* This one layouts its content using a {@link GridLayout}.
	*
	* @param parent_p
	* @param managedForm_p
	* @return
	*/
	/*
	* protected Composite createViewerContainer(Composite parent_p,
	* IManagedForm managedForm_p) { return
	* FormHelper.createCompositeWithLayoutType(managedForm_p.getToolkit(),
	* parent_p, LayoutType.GRID_LAYOUT, 1, true); }
	*/

	/**
	* Declare viewer actions.<br>
	* This methods is called eache time the menu is pop-up.
	*
	* @param contextMenuManager_p
	* @param treeViewer_p
	*/

	/**
	* @see org.eclipse.ui.forms.editor.FormPage#dispose()
	*/
	@Override
	public void dispose() {
	// Unregister as property listener.
	ActivityExplorerActivator.getDefault().getPreferenceStore().removePropertyChangeListener(this);

	super.dispose();
	}

	/**
	* Handle property change.<br>
	*
	* @param event_p
	* @param value_p
	* @param property_p
	* @return boolean
	*/

	protected boolean doPropertyChange(PropertyChangeEvent event_p, boolean value_p, String property_p) {
	boolean result = false;

	if (isSection(property_p)) {
	updatePageForm();
	result = true;
	}

	return result;
	}

	/**
	* Test if the id is a Activity Explorer page.
	*
	* @param id
	* @return boolean
	*/
	private boolean isSection(String id) {
	return ActivityExplorerExtensionManager.isSection(getId(), id);
	}

	/**
	* Get a ActivityExplorerSection in the page from its id.
	*
	* @param id
	*/
	protected ActivityExplorerSection getSectionById(final String id) {
	ActivityExplorerSection result = null;
	for (ActivityExplorerSection section : getSections()) {
	if (section.getId().equals(id)) {
	result = section;
	}
	}
	return result;
	}

	/**
	* {@inheritDoc}
	*/
	@Override
	public ActivityExplorerEditor getEditor() {
	return (ActivityExplorerEditor) super.getEditor();
	}

	/**
	* @see org.eclipse.ui.part.EditorPart#getEditorInput()
	*/
	@Override
	public ActivityExplorerEditorInput getEditorInput() {
	return (ActivityExplorerEditorInput) super.getEditorInput();
	}

	/**
	* Get the header page title.
	*
	* @return
	*/
	protected String getHeaderTitle() {
	return title;
	}

	/**
	* Set the header page title.
	*
	* @param title_p
	*/
	protected void setHeaderTitle(String title_p) {
	title = title_p;
	}

	/**
	* Get the XML file that defines the form text content for the description
	* of the page.<br>
	* Returned path must be relative to
	* <code>org.eclipse.amalgam.explorer.activity.ui/xml</code> folder.<br>
	*
	* @return
	*/
	public String getPageDescription() {
	return description;
	}

	/**
	* Get the section container.
	*
	* @return the sectionContainer
	*/
	protected Composite getSectionContainer() {
	return _sectionContainer;
	}

	public Set<ActivityExplorerSection> getSections() {
	return sections;
	}

	/**
	* Handle contributed sections for specified Activity Explorer page provider.
	*
	*
	* @param contributor_p
	* @param sectionContainer_p
	* @param managedForm_p
	*/
	protected void handleContributedSectionsFor(IConfigurationElement contributor_p) {

	// create a Activity Explorer section
	ActivityExplorerSection section = new ActivityExplorerSection(contributor_p) {
	@Override
	protected IAction[] getToolBarActions() {
	IAction[] toolbarActions = new IAction[] { new DescriptionAction(ActivityExplorerPage.this.getSite()
	.getShell(), description)

	};

	return toolbarActions;
	}
	};

	// sort
	sections.add(section);

	}

	/**
	* Hook resize listener for sash form.
	*/
	protected void hookResizeListener() {
	Listener listener = _sashForm.getListener();
	Control[] children = _sashForm.getChildren();
	for (Control element : children) {
	if (element instanceof Sash) {
	continue;
	}
	element.addListener(SWT.Resize, listener);
	}
	}

	/**
	* @see org.eclipse.jface.util.IPropertyChangeListener#propertyChange(org.eclipse.jface.util.PropertyChangeEvent)
	*/
	public void propertyChange(PropertyChangeEvent event_p) {
	String property = event_p.getProperty();
	boolean value = ((Boolean) event_p.getNewValue()).booleanValue();

	if (doPropertyChange(event_p, value, property)) {
	if (ActivityExplorerManager.INSTANCE.getEditor() != null)
	ActivityExplorerManager.INSTANCE.getEditor().getActivePageInstance().getManagedForm().reflow(true);
	}
	}

	/**
	* @see org.eclipse.ui.forms.editor.FormPage#setActive(boolean)
	*/
	@Override
	public void setActive(boolean active_p) {
	super.setActive(active_p);
	if (active_p) {
	// Set a new selection to the property sheet page on Activity Explorer page
	// activation.
	// setCurrentPageSelectionToPropertySheetPage();
	updateActionBars();
	}
	}

	/**
	* Refresh the property sheet page according to the current viewer
	* selection.<br>
	* {@link #getViewer()}.
	*/
	/*
	* protected void setCurrentPageSelectionToPropertySheetPage() { // Call the
	* property sheet page without loading it. // Indeed, we won't load it if
	* the view is not displayed. TabbedPropertySheetPage propertySheetPage =
	* getEditor().getPropertySheetPage(); if (null != propertySheetPage) {
	* propertySheetPage.selectionChanged(getEditor(),
	* getViewer().getSelection()); } }
	*/

	/**
	* Update action bars (handlers).
	*
	* @param editorActionBars
	*/
	public void updateActionBars() {
	IActionBars editorActionBars = getEditorSite().getActionBars();
	// Update action bars to make sure global ActionHandler are updated
	// accordingly.
	editorActionBars.updateActionBars();
	}

	/**
	* Initialize the Page with parameters.
	*/
	public void setInitializationData(IConfigurationElement cfig, String propertyName, Object data) {
	super.setInitializationData(cfig, propertyName, data);

	String title = ActivityExplorerExtensionManager.getTitle(cfig);
	setHeaderTitle(title);

	Image image = ActivityExplorerExtensionManager.getImageOff(cfig);
	if (image != null) {
	setHeaderImageOff(image);

	}

	image = ActivityExplorerExtensionManager.getImageOn(cfig);
	if (image != null) {
	setHeaderImageOn(image);

	}

	String description = ActivityExplorerExtensionManager.getDescription(cfig);
	if (null != description)
	setPageDescription(HTMLHelper.formWrapper(description));

	String indice = ActivityExplorerExtensionManager.getIndex(cfig);
	setIndex(Integer.parseInt(indice));
	}

	/**
	* Set the page description.
	*
	* @param description_p
	*/

	private void setPageDescription(String description_p) {
	description = description_p;
	}

	/**
	* Set Header Image Off.
	*
	* @param image_p
	*/
	protected void setHeaderImageOff(Image image_p) {
	headerImageOff = image_p;

	}

	/**
	* Set Header Image On.
	*
	* @param image_p
	*/
	protected void setHeaderImageOn(Image image_p) {
	headerImageOn = image_p;

	}

	/**
	* Get Image Off.
	*
	* @return Image
	*/
	public Image getHeaderImageOff() {
	return headerImageOff;
	}

	/**
	* Get header image On.
	*
	* @return Image
	*/
	public Image getHeaderImageOn() {
	return headerImageOn;
	}

	/**
	* Return true this page is visible.
	*/
	@Override
	public boolean isVisible() {
	boolean result = ActivityExplorerActivator.getDefault().getPreferenceStore().getBoolean(getId());
	if (predicate != null) {
	result &= predicate.isOk();
	}
	return result;
	}

	/**
	* Get the applied Predicate.
	*
	* @return {@link IPredicate}
	*/
	public IPredicate getPredicate() {
	return predicate;
	}
	}