melnorme.lang.ide.ui.editor.structure.AbstractContentOutlinePage.java Source code

Java tutorial

Introduction

Here is the source code for melnorme.lang.ide.ui.editor.structure.AbstractContentOutlinePage.java

Source

/*******************************************************************************
 * Copyright (c) 2015 Bruno Medeiros and other Contributors.
 * 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:
 *     Bruno Medeiros - initial API and implementation
 *******************************************************************************/
package melnorme.lang.ide.ui.editor.structure;

import org.eclipse.jface.action.IMenuListener;
import org.eclipse.jface.action.IMenuManager;
import org.eclipse.jface.action.MenuManager;
import org.eclipse.jface.action.Separator;
import org.eclipse.jface.layout.GridLayoutFactory;
import org.eclipse.jface.viewers.IPostSelectionProvider;
import org.eclipse.jface.viewers.ISelection;
import org.eclipse.jface.viewers.ISelectionChangedListener;
import org.eclipse.jface.viewers.SelectionChangedEvent;
import org.eclipse.jface.viewers.StructuredSelection;
import org.eclipse.jface.viewers.TreeViewer;
import org.eclipse.swt.SWT;
import org.eclipse.swt.widgets.Composite;
import org.eclipse.swt.widgets.Control;
import org.eclipse.swt.widgets.Menu;
import org.eclipse.swt.widgets.Tree;
import org.eclipse.ui.navigator.ICommonMenuConstants;
import org.eclipse.ui.part.IPageSite;
import org.eclipse.ui.part.Page;
import org.eclipse.ui.views.contentoutline.ContentOutlinePage;
import org.eclipse.ui.views.contentoutline.IContentOutlinePage;

import melnorme.lang.ide.ui.LangUIPlugin;
import melnorme.util.swt.SWTFactoryUtil;
import melnorme.util.swt.components.AbstractWidget;
import melnorme.util.swt.components.misc.StatusMessageWidget;
import melnorme.utilbox.fields.ListenerListHelper;

/**
 * Abstract helper class for an {@link IContentOutlinePage}, similar to {@link ContentOutlinePage},
 * but with a different implementation (with minor improvements.
 * 
 * @author Bruno
 *
 */
public abstract class AbstractContentOutlinePage extends Page
        implements IContentOutlinePage, IPostSelectionProvider {

    protected final ListenerListHelper<ISelectionChangedListener> selectionChangedListeners = new ListenerListHelper<>();
    protected final ListenerListHelper<ISelectionChangedListener> postSelectionChangedListeners = new ListenerListHelper<>();

    protected Composite topControl;
    protected TreeViewer treeViewer;
    protected StatusMessageWidget statusWidget;

    public AbstractContentOutlinePage() {
        super();
    }

    @Override
    public void init(IPageSite pageSite) {
        super.init(pageSite);
        getSite().setSelectionProvider(this);
    }

    @Override
    public void dispose() {
        selectionChangedListeners.clear();
        postSelectionChangedListeners.clear();

        super.dispose();
    }

    /* -----------------  ----------------- */

    @Override
    public void createControl(Composite parent) {
        topControl = SWTFactoryUtil.createGridComposite(parent, 1, null);
        topControl.setLayout(GridLayoutFactory.fillDefaults().numColumns(1).spacing(0, 0).create());

        statusWidget = new StatusMessageWidget() {
            @Override
            protected GridLayoutFactory createTopLevelLayout() {
                return GridLayoutFactory.fillDefaults().numColumns(getPreferredLayoutColumns()).margins(5, 5);
            }
        };
        statusWidget.createComponent(topControl, AbstractWidget.gdGrabHorizontal());

        createTreeViewer(topControl);
        treeViewer.getTree().setLayoutData(AbstractWidget.gdGrabAll());
    }

    @Override
    public Control getControl() {
        return topControl;
    }

    public TreeViewer getTreeViewer() {
        return treeViewer;
    }

    protected TreeViewer createTreeViewer(Composite parent) {
        treeViewer = new TreeViewer(parent, SWT.MULTI);

        treeViewer.setAutoExpandLevel(TreeViewer.ALL_LEVELS);
        // TODO: allow certain StructureElements to not be initially expanded
        treeViewer.setUseHashlookup(true);

        setupTreeViewerListeners();
        createTreeViewerMenu();

        return treeViewer;
    }

    /* -----------------  ----------------- */

    protected void createTreeViewerMenu() {
        Tree tree = treeViewer.getTree();

        String menuId = LangUIPlugin.PLUGIN_ID + ".OutlineContextMenu";

        MenuManager manager = new MenuManager("OutlineContextMenu", menuId);
        manager.setRemoveAllWhenShown(true);
        manager.addMenuListener(new IMenuListener() {
            @Override
            public void menuAboutToShow(IMenuManager m) {
                contextMenuAboutToShow(m);
            }
        });
        Menu treeContextMenu = manager.createContextMenu(tree);
        tree.setMenu(treeContextMenu);

        getSite().registerContextMenu(menuId, manager, treeViewer);
    }

    protected void contextMenuAboutToShow(IMenuManager menu) {
        if (menu.isEmpty()) {
            menu.add(new Separator(ICommonMenuConstants.GROUP_ADDITIONS));
        }
    }

    /* -----------------  ----------------- */

    @Override
    public void setFocus() {
        if (treeViewer != null) {
            treeViewer.getControl().setFocus();
        }
    }

    /* ----------------- ISelectionProvider ----------------- */

    @Override
    public void addSelectionChangedListener(ISelectionChangedListener listener) {
        selectionChangedListeners.addListener(listener);
    }

    @Override
    public void addPostSelectionChangedListener(ISelectionChangedListener listener) {
        postSelectionChangedListeners.addListener(listener);
    }

    @Override
    public void removeSelectionChangedListener(ISelectionChangedListener listener) {
        selectionChangedListeners.removeListener(listener);
    }

    @Override
    public void removePostSelectionChangedListener(ISelectionChangedListener listener) {
        postSelectionChangedListeners.removeListener(listener);
    }

    protected void setupTreeViewerListeners() {
        getTreeViewer().addSelectionChangedListener(new ISelectionChangedListener() {
            @Override
            public void selectionChanged(SelectionChangedEvent event) {
                for (ISelectionChangedListener listener : selectionChangedListeners.getListeners()) {
                    listener.selectionChanged(event);
                }
                treeViewerSelectionChanged(event);
            }
        });

        getTreeViewer().addPostSelectionChangedListener(new ISelectionChangedListener() {
            @Override
            public void selectionChanged(SelectionChangedEvent event) {
                for (ISelectionChangedListener listener : postSelectionChangedListeners.getListeners()) {
                    listener.selectionChanged(event);
                }
                treeViewerPostSelectionChanged(event);
            }
        });
    }

    @Override
    public ISelection getSelection() {
        if (treeViewer == null) {
            return StructuredSelection.EMPTY;
        }
        return treeViewer.getSelection();
    }

    @Override
    public void setSelection(ISelection selection) {
        if (treeViewer != null) {
            treeViewer.setSelection(selection);
        }
    }

    @SuppressWarnings("unused")
    protected void treeViewerSelectionChanged(SelectionChangedEvent event) {
    }

    @SuppressWarnings("unused")
    protected void treeViewerPostSelectionChanged(SelectionChangedEvent event) {
    }

}