org.eclipse.team.svn.ui.discovery.wizards.OverviewToolTip.java Source code

Java tutorial

Introduction

Here is the source code for org.eclipse.team.svn.ui.discovery.wizards.OverviewToolTip.java

Source

/*******************************************************************************
 * Copyright (c) 2009 Tasktop Technologies, Polarion Software 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:
 *     Tasktop Technologies - initial API and implementation
 *******************************************************************************/

package org.eclipse.team.svn.ui.discovery.wizards;

import java.net.URL;

import org.eclipse.jface.layout.GridDataFactory;
import org.eclipse.jface.layout.GridLayoutFactory;
import org.eclipse.jface.resource.ColorRegistry;
import org.eclipse.jface.resource.ImageDescriptor;
import org.eclipse.jface.resource.JFaceResources;
import org.eclipse.jface.window.ToolTip;
import org.eclipse.swt.SWT;
import org.eclipse.swt.events.DisposeEvent;
import org.eclipse.swt.events.DisposeListener;
import org.eclipse.swt.events.SelectionEvent;
import org.eclipse.swt.events.SelectionListener;
import org.eclipse.swt.graphics.Color;
import org.eclipse.swt.graphics.Image;
import org.eclipse.swt.graphics.Point;
import org.eclipse.swt.graphics.RGB;
import org.eclipse.swt.layout.GridData;
import org.eclipse.swt.widgets.Composite;
import org.eclipse.swt.widgets.Control;
import org.eclipse.swt.widgets.Display;
import org.eclipse.swt.widgets.Event;
import org.eclipse.swt.widgets.Label;
import org.eclipse.swt.widgets.Link;
import org.eclipse.team.svn.core.discovery.model.AbstractDiscoverySource;
import org.eclipse.team.svn.core.discovery.model.Overview;
import org.eclipse.team.svn.ui.SVNUIMessages;
import org.eclipse.team.svn.ui.discovery.GradientToolTip;
import org.eclipse.team.svn.ui.discovery.WorkbenchUtil;
import org.eclipse.ui.browser.IWorkbenchBrowserSupport;

/**
 * @author David Green
 * @author Igor Burilo
 */
class OverviewToolTip extends GradientToolTip {

    private static final String COLOR_BLACK = "black"; //$NON-NLS-1$

    private final Overview overview;

    private final AbstractDiscoverySource source;

    private Color colorBlack;

    public OverviewToolTip(Control control, AbstractDiscoverySource source, Overview overview) {
        super(control, ToolTip.RECREATE, true);
        if (source == null) {
            throw new IllegalArgumentException();
        }
        if (overview == null) {
            throw new IllegalArgumentException();
        }
        this.source = source;
        this.overview = overview;
        setHideOnMouseDown(false); // required for links to work
    }

    @Override
    protected Composite createToolTipArea(Event event, final Composite parent) {
        if (colorBlack == null) {
            ColorRegistry colorRegistry = JFaceResources.getColorRegistry();
            if (!colorRegistry.hasValueFor(COLOR_BLACK)) {
                colorRegistry.put(COLOR_BLACK, new RGB(0, 0, 0));
            }
            colorBlack = colorRegistry.get(COLOR_BLACK);
        }

        GridLayoutFactory.fillDefaults().applyTo(parent);

        Composite container = new Composite(parent, SWT.NULL);
        container.setBackground(null);

        Image image = null;
        if (overview.getScreenshot() != null) {
            image = computeImage(source, overview.getScreenshot());
            if (image != null) {
                final Image fimage = image;
                container.addDisposeListener(new DisposeListener() {
                    public void widgetDisposed(DisposeEvent e) {
                        fimage.dispose();
                    }
                });
            }
        }
        final boolean hasLearnMoreLink = overview.getUrl() != null && overview.getUrl().length() > 0;

        final int borderWidth = 1;
        final int fixedImageHeight = 240;
        final int fixedImageWidth = 320;
        final int heightHint = fixedImageHeight + (borderWidth * 2);
        final int widthHint = fixedImageWidth;

        final int containerWidthHintWithImage = 650;
        final int containerWidthHintWithoutImage = 500;

        GridDataFactory.fillDefaults().grab(true, true)
                .hint(image == null ? containerWidthHintWithoutImage : containerWidthHintWithImage, SWT.DEFAULT)
                .applyTo(container);

        GridLayoutFactory.fillDefaults().numColumns(2).margins(5, 5).spacing(3, 0).applyTo(container);

        String summary = overview.getSummary();

        Composite summaryContainer = new Composite(container, SWT.NULL);
        summaryContainer.setBackground(null);
        GridLayoutFactory.fillDefaults().applyTo(summaryContainer);

        GridDataFactory gridDataFactory = GridDataFactory.fillDefaults().grab(true, true)
                .span(image == null ? 2 : 1, 1);
        if (image != null) {
            gridDataFactory.hint(widthHint, heightHint);
        }
        gridDataFactory.applyTo(summaryContainer);

        Label summaryLabel = new Label(summaryContainer, SWT.WRAP);
        summaryLabel.setText(summary);
        summaryLabel.setBackground(null);

        GridDataFactory.fillDefaults().grab(true, true).align(SWT.BEGINNING, SWT.BEGINNING).applyTo(summaryLabel);

        if (image != null) {
            final Composite imageContainer = new Composite(container, SWT.BORDER);
            GridLayoutFactory.fillDefaults().applyTo(imageContainer);

            GridDataFactory.fillDefaults().grab(false, false).align(SWT.CENTER, SWT.BEGINNING)
                    .hint(widthHint + (borderWidth * 2), heightHint).applyTo(imageContainer);

            Label imageLabel = new Label(imageContainer, SWT.NULL);
            GridDataFactory.fillDefaults().hint(widthHint, fixedImageHeight).indent(borderWidth, borderWidth)
                    .applyTo(imageLabel);
            imageLabel.setImage(image);
            imageLabel.setBackground(null);
            imageLabel.setSize(widthHint, fixedImageHeight);

            // creates a border
            imageContainer.setBackground(colorBlack);
        }

        if (hasLearnMoreLink) {
            Link link = new Link(summaryContainer, SWT.NULL);
            GridDataFactory.fillDefaults().grab(false, false).align(SWT.BEGINNING, SWT.CENTER).applyTo(link);
            link.setText(SVNUIMessages.ConnectorDescriptorToolTip_detailsLink);
            link.setBackground(null);
            link.setToolTipText(SVNUIMessages.format(SVNUIMessages.ConnectorDescriptorToolTip_detailsLink_tooltip,
                    overview.getUrl()));
            link.addSelectionListener(new SelectionListener() {
                public void widgetSelected(SelectionEvent e) {
                    WorkbenchUtil.openUrl(overview.getUrl(), IWorkbenchBrowserSupport.AS_EXTERNAL);
                }

                public void widgetDefaultSelected(SelectionEvent e) {
                    widgetSelected(e);
                }
            });
        }

        if (image == null) {
            // prevent overviews with no image from providing unlimited text.
            Point optimalSize = summaryContainer.computeSize(SWT.DEFAULT, SWT.DEFAULT, true);
            if (optimalSize.y > (heightHint + 10)) {
                ((GridData) summaryContainer.getLayoutData()).heightHint = heightHint;
                container.layout(true);
            }
        }
        // hack: cause the tooltip to gain focus so that we can capture the escape key
        //       this must be done async since the tooltip is not yet visible.
        Display.getCurrent().asyncExec(new Runnable() {
            public void run() {
                if (!parent.isDisposed()) {
                    parent.setFocus();
                }
            }
        });
        return container;
    }

    private Image computeImage(AbstractDiscoverySource discoverySource, String imagePath) {
        URL resource = discoverySource.getResource(imagePath);
        if (resource != null) {
            ImageDescriptor descriptor = ImageDescriptor.createFromURL(resource);
            Image image = descriptor.createImage();
            return image;
        }
        return null;
    }
}