Java tutorial
/******************************************************************************* * Copyright (c) 2000, 2015 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.launchbar.ui.internal.target; import java.util.ArrayList; import java.util.Arrays; import java.util.HashMap; import java.util.Hashtable; import java.util.Iterator; import java.util.List; import java.util.Map; import org.eclipse.core.runtime.CoreException; import org.eclipse.jface.dialogs.Dialog; import org.eclipse.jface.dialogs.IDialogSettings; import org.eclipse.jface.resource.ImageDescriptor; import org.eclipse.jface.viewers.DoubleClickEvent; import org.eclipse.jface.viewers.IDoubleClickListener; import org.eclipse.jface.viewers.ISelectionChangedListener; import org.eclipse.jface.viewers.IStructuredSelection; import org.eclipse.jface.viewers.SelectionChangedEvent; import org.eclipse.jface.viewers.StructuredSelection; import org.eclipse.jface.viewers.TreeViewer; import org.eclipse.jface.wizard.IWizardContainer; import org.eclipse.jface.wizard.IWizardContainer2; import org.eclipse.swt.SWT; import org.eclipse.swt.custom.CLabel; import org.eclipse.swt.events.DisposeEvent; import org.eclipse.swt.events.DisposeListener; import org.eclipse.swt.events.SelectionAdapter; import org.eclipse.swt.events.SelectionEvent; import org.eclipse.swt.graphics.Font; import org.eclipse.swt.graphics.Image; import org.eclipse.swt.layout.GridData; import org.eclipse.swt.layout.GridLayout; import org.eclipse.swt.widgets.Button; import org.eclipse.swt.widgets.Composite; import org.eclipse.swt.widgets.Control; import org.eclipse.swt.widgets.Label; import org.eclipse.ui.IWorkbenchWizard; import org.eclipse.ui.activities.WorkbenchActivityHelper; import org.eclipse.ui.dialogs.FilteredTree; import org.eclipse.ui.internal.WorkbenchMessages; import org.eclipse.ui.internal.dialogs.DialogUtil; import org.eclipse.ui.internal.dialogs.WizardActivityFilter; import org.eclipse.ui.internal.dialogs.WizardContentProvider; import org.eclipse.ui.internal.dialogs.WizardPatternFilter; import org.eclipse.ui.internal.dialogs.WorkbenchWizardElement; import org.eclipse.ui.internal.dialogs.WorkbenchWizardNode; import org.eclipse.ui.model.AdaptableList; import org.eclipse.ui.model.WorkbenchLabelProvider; import org.eclipse.ui.wizards.IWizardCategory; import org.eclipse.ui.wizards.IWizardDescriptor; /** * New wizard selection tab that allows the user to select a registered 'New' * wizard to be launched. */ class NewLaunchTargetWizardNewPage implements ISelectionChangedListener { // id constants private static final String DIALOG_SETTING_SECTION_NAME = "NewWizardSelectionPage."; //$NON-NLS-1$ private final static int SIZING_LISTS_HEIGHT = 200; private final static int SIZING_VIEWER_WIDTH = 300; private final static String STORE_EXPANDED_CATEGORIES_ID = DIALOG_SETTING_SECTION_NAME + "STORE_EXPANDED_CATEGORIES_ID"; //$NON-NLS-1$ private final static String STORE_SELECTED_ID = DIALOG_SETTING_SECTION_NAME + "STORE_SELECTED_ID"; //$NON-NLS-1$ private NewLaunchTargetWizardSelectionPage page; private FilteredTree filteredTree; private WizardPatternFilter filteredTreeFilter; //Keep track of the wizards we have previously selected private Hashtable selectedWizards = new Hashtable(); private IDialogSettings settings; private Button showAllCheck; private IWizardDescriptor[] primaryWizards; private CLabel descImageCanvas; private Map imageTable = new HashMap(); private IWizardDescriptor selectedElement; private WizardActivityFilter filter = new WizardActivityFilter(); private boolean needShowAll; /** * Create an instance of this class * @param mainPage * @param wizardCategories * @param primaryWizards * @param projectsOnly */ public NewLaunchTargetWizardNewPage(NewLaunchTargetWizardSelectionPage mainPage, IWizardCategory wizardCategories, IWizardDescriptor[] primaryWizards) { this.page = mainPage; this.primaryWizards = primaryWizards; needShowAll = !allActivityEnabled(primaryWizards); } /** * @param category the wizard category * @return whether all of the wizards in the category are enabled via activity filtering */ private boolean allActivityEnabled(IWizardDescriptor[] wizards) { for (int i = 0; i < wizards.length; i++) { IWizardDescriptor wizard = wizards[i]; if (WorkbenchActivityHelper.filterItem(wizard)) { return false; } } return true; } /** * @since 3.0 */ public void activate() { page.setDescription(WorkbenchMessages.NewWizardNewPage_description); } /** * Create this tab's visual components * * @param parent Composite * @return Control */ protected Control createControl(Composite parent) { Font wizardFont = parent.getFont(); // top level group Composite outerContainer = new Composite(parent, SWT.NONE); GridLayout layout = new GridLayout(); outerContainer.setLayout(layout); Label wizardLabel = new Label(outerContainer, SWT.NONE); GridData data = new GridData(SWT.BEGINNING, SWT.FILL, false, true); outerContainer.setLayoutData(data); wizardLabel.setFont(wizardFont); wizardLabel.setText(WorkbenchMessages.NewWizardNewPage_wizardsLabel); Composite innerContainer = new Composite(outerContainer, SWT.NONE); layout = new GridLayout(2, false); layout.marginHeight = 0; layout.marginWidth = 0; innerContainer.setLayout(layout); innerContainer.setFont(wizardFont); data = new GridData(SWT.FILL, SWT.FILL, true, true); innerContainer.setLayoutData(data); filteredTree = createFilteredTree(innerContainer); createOptionsButtons(innerContainer); createImage(innerContainer); updateDescription(null); // wizard actions pane...create SWT table directly to // get single selection mode instead of multi selection. restoreWidgetValues(); return outerContainer; } /** * Create a new FilteredTree in the parent. * * @param parent the parent <code>Composite</code>. * @since 3.0 */ protected FilteredTree createFilteredTree(Composite parent) { Composite composite = new Composite(parent, SWT.NONE); GridLayout layout = new GridLayout(); layout.marginHeight = 0; layout.marginWidth = 0; composite.setLayout(layout); GridData data = new GridData(SWT.FILL, SWT.FILL, true, true); data.widthHint = SIZING_VIEWER_WIDTH; data.horizontalSpan = 2; data.grabExcessHorizontalSpace = true; data.grabExcessVerticalSpace = true; boolean needsHint = DialogUtil.inRegularFontMode(parent); //Only give a height hint if the dialog is going to be too small if (needsHint) { data.heightHint = SIZING_LISTS_HEIGHT; } composite.setLayoutData(data); filteredTreeFilter = new WizardPatternFilter(); FilteredTree filterTree = new FilteredTree(composite, SWT.SINGLE | SWT.H_SCROLL | SWT.V_SCROLL | SWT.BORDER, filteredTreeFilter, true); filterTree.setQuickSelectionMode(true); final TreeViewer treeViewer = filterTree.getViewer(); treeViewer.setContentProvider(new WizardContentProvider()); treeViewer.setLabelProvider(new WorkbenchLabelProvider()); //treeViewer.setComparator(NewWizardCollectionComparator.INSTANCE); treeViewer.addSelectionChangedListener(this); ArrayList inputArray = new ArrayList(); for (int i = 0; i < primaryWizards.length; i++) { inputArray.add(primaryWizards[i]); } boolean expandTop = false; // ensure the category is expanded. If there is a remembered expansion it will be set later. if (expandTop) { treeViewer.setAutoExpandLevel(2); } AdaptableList input = new AdaptableList(inputArray); treeViewer.setInput(input); filterTree.setBackground(parent.getDisplay().getSystemColor(SWT.COLOR_WIDGET_BACKGROUND)); treeViewer.getTree().setFont(parent.getFont()); treeViewer.addDoubleClickListener(new IDoubleClickListener() { @Override public void doubleClick(DoubleClickEvent event) { IStructuredSelection s = (IStructuredSelection) event.getSelection(); selectionChanged(new SelectionChangedEvent(event.getViewer(), s)); Object element = s.getFirstElement(); if (treeViewer.isExpandable(element)) { treeViewer.setExpandedState(element, !treeViewer.getExpandedState(element)); } else if (element instanceof WorkbenchWizardElement) { page.advanceToNextPageOrFinish(); } } }); treeViewer.addFilter(filter); Dialog.applyDialogFont(filterTree); return filterTree; } /** * Create the Show All and help buttons at the bottom of the page. * * @param parent the parent composite on which to create the widgets */ private void createOptionsButtons(Composite parent) { if (needShowAll) { showAllCheck = new Button(parent, SWT.CHECK); GridData data = new GridData(); showAllCheck.setLayoutData(data); showAllCheck.setFont(parent.getFont()); showAllCheck.setText(WorkbenchMessages.NewWizardNewPage_showAll); showAllCheck.setSelection(false); // flipping tabs updates the selected node showAllCheck.addSelectionListener(new SelectionAdapter() { // the delta of expanded elements between the last 'show all' // and the current 'no show all' private Object[] delta = new Object[0]; @Override public void widgetSelected(SelectionEvent e) { boolean showAll = showAllCheck.getSelection(); if (showAll) { filteredTree.getViewer().getControl().setRedraw(false); } else { // get the inital expanded elements when going from show // all-> no show all. // this isnt really the delta yet, we're just reusing // the variable. delta = filteredTree.getViewer().getExpandedElements(); } try { if (showAll) { filteredTree.getViewer().resetFilters(); filteredTree.getViewer().addFilter(filteredTreeFilter); // restore the expanded elements that were present // in the last show all state but not in the 'no // show all' state. Object[] currentExpanded = filteredTree.getViewer().getExpandedElements(); Object[] expanded = new Object[delta.length + currentExpanded.length]; System.arraycopy(currentExpanded, 0, expanded, 0, currentExpanded.length); System.arraycopy(delta, 0, expanded, currentExpanded.length, delta.length); filteredTree.getViewer().setExpandedElements(expanded); } else { filteredTree.getViewer().addFilter(filter); } filteredTree.getViewer().refresh(false); if (!showAll) { // if we're going from show all -> no show all // record the elements that were expanded in the // 'show all' state but not the 'no show all' state // (because they didnt exist). Object[] newExpanded = filteredTree.getViewer().getExpandedElements(); List deltaList = new ArrayList(Arrays.asList(delta)); deltaList.removeAll(Arrays.asList(newExpanded)); } } finally { if (showAll) { filteredTree.getViewer().getControl().setRedraw(true); } } } }); } } /** * Create the image controls. * * @param parent the parent <code>Composite</code>. * @since 3.0 */ private void createImage(Composite parent) { descImageCanvas = new CLabel(parent, SWT.NONE); GridData data = new GridData(GridData.HORIZONTAL_ALIGN_BEGINNING | GridData.VERTICAL_ALIGN_BEGINNING); data.widthHint = 0; data.heightHint = 0; descImageCanvas.setLayoutData(data); // hook a listener to get rid of cached images. descImageCanvas.addDisposeListener(new DisposeListener() { @Override public void widgetDisposed(DisposeEvent e) { for (Iterator i = imageTable.values().iterator(); i.hasNext();) { ((Image) i.next()).dispose(); } imageTable.clear(); } }); } /** * Returns the single selected object contained in the passed * selectionEvent, or <code>null</code> if the selectionEvent contains * either 0 or 2+ selected objects. */ protected Object getSingleSelection(IStructuredSelection selection) { return selection.size() == 1 ? selection.getFirstElement() : null; } /** * Set self's widgets to the values that they held last time this page was * open * */ protected void restoreWidgetValues() { //expandPreviouslyExpandedCategories(); selectPreviouslySelected(); } /** * Store the current values of self's widgets so that they can be restored * in the next instance of self * */ public void saveWidgetValues() { storeSelectedCategoryAndWizard(); } /** * The user selected either new wizard category(s) or wizard element(s). * Proceed accordingly. * * @param selectionEvent ISelection */ @Override public void selectionChanged(SelectionChangedEvent selectionEvent) { page.setErrorMessage(null); page.setMessage(null); Object selectedObject = getSingleSelection((IStructuredSelection) selectionEvent.getSelection()); if (selectedObject instanceof IWizardDescriptor) { if (selectedObject == selectedElement) { return; } updateWizardSelection((IWizardDescriptor) selectedObject); } else { selectedElement = null; page.setHasPages(false); page.setCanFinishEarly(false); page.selectWizardNode(null); updateDescription(null); } } /** * Selects the wizard category and wizard in this page that were selected * last time this page was used. If a category or wizard that was * previously selected no longer exists then it is ignored. */ protected void selectPreviouslySelected() { String selectedId = settings.get(STORE_SELECTED_ID); if (selectedId == null) { return; } Object selected = null; for (int i = 0; i < primaryWizards.length; i++) { IWizardDescriptor wizard = primaryWizards[i]; if (wizard.getId().equals(selectedId)) { selected = wizard; break; } } if (selected == null) { // if we cant find either a category or a wizard, abort. return; } //work around for 62039 final StructuredSelection selection = new StructuredSelection(selected); filteredTree.getViewer().getControl().getDisplay().asyncExec(new Runnable() { @Override public void run() { filteredTree.getViewer().setSelection(selection, true); } }); } /** * Set the dialog store to use for widget value storage and retrieval * * @param settings IDialogSettings */ public void setDialogSettings(IDialogSettings settings) { this.settings = settings; } /** * Stores the currently-selected element in this page's dialog store, in * order to recreate this page's state in the next instance of this page. */ protected void storeSelectedCategoryAndWizard() { Object selected = getSingleSelection((IStructuredSelection) filteredTree.getViewer().getSelection()); if (selected != null) { if (selected instanceof IWizardCategory) { settings.put(STORE_SELECTED_ID, ((IWizardCategory) selected).getPath().toString()); } else { // else its a wizard settings.put(STORE_SELECTED_ID, ((IWizardDescriptor) selected).getId()); } } } /** * Update the current description controls. * * @param selectedObject the new wizard * @since 3.0 */ private void updateDescription(IWizardDescriptor selectedObject) { String string = ""; //$NON-NLS-1$ if (selectedObject != null) { string = selectedObject.getDescription(); } page.setDescription(string); if (hasImage(selectedObject)) { ImageDescriptor descriptor = null; if (selectedObject != null) { descriptor = selectedObject.getDescriptionImage(); } if (descriptor != null) { GridData data = (GridData) descImageCanvas.getLayoutData(); data.widthHint = SWT.DEFAULT; data.heightHint = SWT.DEFAULT; Image image = (Image) imageTable.get(descriptor); if (image == null) { image = descriptor.createImage(false); imageTable.put(descriptor, image); } descImageCanvas.setImage(image); } } else { GridData data = (GridData) descImageCanvas.getLayoutData(); data.widthHint = 0; data.heightHint = 0; descImageCanvas.setImage(null); } descImageCanvas.getParent().layout(true); filteredTree.getViewer().getTree().showSelection(); IWizardContainer container = page.getWizard().getContainer(); if (container instanceof IWizardContainer2) { ((IWizardContainer2) container).updateSize(); } } /** * Tests whether the given wizard has an associated image. * * @param selectedObject the wizard to test * @return whether the given wizard has an associated image */ private boolean hasImage(IWizardDescriptor selectedObject) { if (selectedObject == null) { return false; } if (selectedObject.getDescriptionImage() != null) { return true; } return false; } /** * @param selectedObject */ private void updateWizardSelection(IWizardDescriptor selectedObject) { selectedElement = selectedObject; WorkbenchWizardNode selectedNode; if (selectedWizards.containsKey(selectedObject)) { selectedNode = (WorkbenchWizardNode) selectedWizards.get(selectedObject); } else { selectedNode = new WorkbenchWizardNode(page, selectedObject) { @Override public IWorkbenchWizard createWizard() throws CoreException { return wizardElement.createWizard(); } }; selectedWizards.put(selectedObject, selectedNode); } page.setCanFinishEarly(selectedObject.canFinishEarly()); page.setHasPages(selectedObject.hasPages()); page.selectWizardNode(selectedNode); updateDescription(selectedObject); } }