| /******************************************************************************* |
| * Copyright (c) 2000, 2006 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.ui.internal.dialogs; |
| |
| import java.util.ArrayList; |
| import java.util.Iterator; |
| |
| import org.eclipse.jface.dialogs.Dialog; |
| import org.eclipse.jface.dialogs.IDialogConstants; |
| import org.eclipse.jface.dialogs.IDialogSettings; |
| 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.ITreeContentProvider; |
| 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.layout.GridData; |
| import org.eclipse.swt.widgets.Button; |
| import org.eclipse.swt.widgets.Composite; |
| import org.eclipse.swt.widgets.Control; |
| import org.eclipse.swt.widgets.Shell; |
| import org.eclipse.swt.widgets.Text; |
| import org.eclipse.ui.PlatformUI; |
| import org.eclipse.ui.dialogs.FilteredTree; |
| import org.eclipse.ui.dialogs.PatternFilter; |
| import org.eclipse.ui.internal.IWorkbenchHelpContextIds; |
| import org.eclipse.ui.internal.WorkbenchMessages; |
| import org.eclipse.ui.internal.WorkbenchPlugin; |
| import org.eclipse.ui.internal.registry.ViewRegistry; |
| import org.eclipse.ui.views.IViewCategory; |
| import org.eclipse.ui.views.IViewDescriptor; |
| import org.eclipse.ui.views.IViewRegistry; |
| |
| /** |
| * The Show View dialog. |
| */ |
| public class ShowViewDialog extends Dialog implements |
| ISelectionChangedListener, IDoubleClickListener { |
| |
| private static final String DIALOG_SETTING_SECTION_NAME = "ShowViewDialog"; //$NON-NLS-1$ |
| |
| private static final int LIST_HEIGHT = 300; |
| |
| private static final int LIST_WIDTH = 250; |
| |
| private static final String STORE_EXPANDED_CATEGORIES_ID = DIALOG_SETTING_SECTION_NAME |
| + ".STORE_EXPANDED_CATEGORIES_ID"; //$NON-NLS-1$ |
| |
| private static final String STORE_SELECTED_VIEW_ID = DIALOG_SETTING_SECTION_NAME |
| + ".STORE_SELECTED_VIEW_ID"; //$NON-NLS-1$ |
| |
| private FilteredTree filteredTree; |
| |
| private Button okButton; |
| |
| private IViewDescriptor[] viewDescs = new IViewDescriptor[0]; |
| |
| private IViewRegistry viewReg; |
| |
| /** |
| * Constructs a new ShowViewDialog. |
| * |
| * @param parentShell the parent shell |
| * @param viewReg the view registry |
| */ |
| public ShowViewDialog(Shell parentShell, IViewRegistry viewReg) { |
| super(parentShell); |
| this.viewReg = viewReg; |
| setShellStyle(getShellStyle() | SWT.RESIZE); |
| } |
| |
| /** |
| * This method is called if a button has been pressed. |
| */ |
| protected void buttonPressed(int buttonId) { |
| if (buttonId == IDialogConstants.OK_ID) { |
| saveWidgetValues(); |
| } |
| super.buttonPressed(buttonId); |
| } |
| |
| /** |
| * Notifies that the cancel button of this dialog has been pressed. |
| */ |
| protected void cancelPressed() { |
| viewDescs = new IViewDescriptor[0]; |
| super.cancelPressed(); |
| } |
| |
| /* |
| * (non-Javadoc) |
| * |
| * @see org.eclipse.jface.window.Window#configureShell(org.eclipse.swt.widgets.Shell) |
| */ |
| protected void configureShell(Shell shell) { |
| super.configureShell(shell); |
| shell.setText(WorkbenchMessages.ShowView_shellTitle); |
| PlatformUI.getWorkbench().getHelpSystem().setHelp(shell, |
| IWorkbenchHelpContextIds.SHOW_VIEW_DIALOG); |
| } |
| |
| /** |
| * Adds buttons to this dialog's button bar. |
| * <p> |
| * The default implementation of this framework method adds standard ok and |
| * cancel buttons using the <code>createButton</code> framework method. |
| * Subclasses may override. |
| * </p> |
| * |
| * @param parent the button bar composite |
| */ |
| protected void createButtonsForButtonBar(Composite parent) { |
| okButton = createButton(parent, IDialogConstants.OK_ID, |
| IDialogConstants.OK_LABEL, true); |
| createButton(parent, IDialogConstants.CANCEL_ID, |
| IDialogConstants.CANCEL_LABEL, false); |
| updateButtons(); |
| } |
| |
| /** |
| * Creates and returns the contents of the upper part of this dialog (above |
| * the button bar). |
| * |
| * @param parent the parent composite to contain the dialog area |
| * @return the dialog area control |
| */ |
| protected Control createDialogArea(Composite parent) { |
| // Run super. |
| Composite composite = (Composite) super.createDialogArea(parent); |
| composite.setFont(parent.getFont()); |
| |
| createFilteredTreeViewer(composite); |
| |
| layoutTopControl(filteredTree); |
| |
| // Restore the last state |
| restoreWidgetValues(); |
| |
| // Return results. |
| return composite; |
| } |
| |
| /** |
| * Create a new filtered tree viewer in the parent. |
| * |
| * @param parent the parent <code>Composite</code>. |
| */ |
| private void createFilteredTreeViewer(Composite parent) { |
| PatternFilter filter = new ViewPatternFilter(); |
| int styleBits = SWT.MULTI | SWT.H_SCROLL | SWT.V_SCROLL | SWT.BORDER; |
| filteredTree = new FilteredTree(parent, styleBits, filter); |
| TreeViewer treeViewer = filteredTree.getViewer(); |
| treeViewer.setLabelProvider(new ViewLabelProvider()); |
| treeViewer.setContentProvider(new ViewContentProvider()); |
| treeViewer.setSorter(new ViewSorter((ViewRegistry) viewReg)); |
| treeViewer.setInput(viewReg); |
| treeViewer.addSelectionChangedListener(this); |
| treeViewer.addDoubleClickListener(this); |
| treeViewer.addFilter(new CapabilityFilter()); |
| |
| filteredTree.setBackground(parent.getDisplay().getSystemColor( |
| SWT.COLOR_WIDGET_BACKGROUND)); |
| |
| // if the tree has only one or zero views, disable the filter text control |
| if (hasAtMostOneView(filteredTree.getViewer())) { |
| Text filterText = filteredTree.getFilterControl(); |
| if (filterText != null) { |
| filterText.setEnabled(false); |
| } |
| } |
| |
| applyDialogFont(filteredTree); |
| } |
| |
| /** |
| * Return whether or not there are less than two views in the list. |
| * |
| * @param tree |
| * @return <code>true</code> if there are less than two views in the list. |
| */ |
| private boolean hasAtMostOneView(TreeViewer tree) { |
| ITreeContentProvider contentProvider = (ITreeContentProvider) tree |
| .getContentProvider(); |
| Object[] children = contentProvider.getElements(tree.getInput()); |
| |
| if (children.length <= 1) { |
| if (children.length == 0) { |
| return true; |
| } |
| return !contentProvider.hasChildren(children[0]); |
| } |
| return false; |
| } |
| |
| /* |
| * (non-Javadoc) |
| * |
| * @see org.eclipse.jface.viewers.IDoubleClickListener#doubleClick(org.eclipse.jface.viewers.DoubleClickEvent) |
| */ |
| public void doubleClick(DoubleClickEvent event) { |
| IStructuredSelection s = (IStructuredSelection) event.getSelection(); |
| Object element = s.getFirstElement(); |
| if (filteredTree.getViewer().isExpandable(element)) { |
| filteredTree.getViewer().setExpandedState(element, !filteredTree.getViewer().getExpandedState(element)); |
| } else if (viewDescs.length > 0) { |
| saveWidgetValues(); |
| setReturnCode(OK); |
| close(); |
| } |
| } |
| |
| /** |
| * Return the dialog store to cache values into |
| */ |
| protected IDialogSettings getDialogSettings() { |
| IDialogSettings workbenchSettings = WorkbenchPlugin.getDefault() |
| .getDialogSettings(); |
| IDialogSettings section = workbenchSettings |
| .getSection(DIALOG_SETTING_SECTION_NAME); |
| if (section == null) { |
| section = workbenchSettings |
| .addNewSection(DIALOG_SETTING_SECTION_NAME); |
| } |
| return section; |
| } |
| |
| /** |
| * Returns the descriptors for the selected views. |
| * |
| * @return the descriptors for the selected views |
| */ |
| public IViewDescriptor[] getSelection() { |
| return viewDescs; |
| } |
| |
| /** |
| * Layout the top control. |
| * |
| * @param control the control. |
| */ |
| private void layoutTopControl(Control control) { |
| GridData spec = new GridData(GridData.FILL_BOTH); |
| spec.widthHint = LIST_WIDTH; |
| spec.heightHint = LIST_HEIGHT; |
| control.setLayoutData(spec); |
| } |
| |
| /** |
| * Use the dialog store to restore widget values to the values that they |
| * held last time this dialog was used to completion. |
| */ |
| protected void restoreWidgetValues() { |
| IDialogSettings settings = getDialogSettings(); |
| |
| String[] expandedCategoryIds = settings |
| .getArray(STORE_EXPANDED_CATEGORIES_ID); |
| if (expandedCategoryIds == null) { |
| return; |
| } |
| |
| ViewRegistry reg = (ViewRegistry) viewReg; |
| ArrayList categoriesToExpand = new ArrayList(expandedCategoryIds.length); |
| for (int i = 0; i < expandedCategoryIds.length; i++) { |
| IViewCategory category = reg.findCategory(expandedCategoryIds[i]); |
| if (category != null) { |
| categoriesToExpand.add(category); |
| } |
| } |
| |
| if (!categoriesToExpand.isEmpty()) { |
| filteredTree.getViewer().setExpandedElements(categoriesToExpand.toArray()); |
| } |
| |
| String selectedViewId = settings.get(STORE_SELECTED_VIEW_ID); |
| if (selectedViewId != null) { |
| IViewDescriptor viewDesc = reg.find(selectedViewId); |
| if (viewDesc != null) { |
| filteredTree.getViewer().setSelection(new StructuredSelection(viewDesc), true); |
| } |
| } |
| } |
| |
| /** |
| * Since OK was pressed, write widget values to the dialog store so that |
| * they will persist into the next invocation of this dialog |
| */ |
| protected void saveWidgetValues() { |
| IDialogSettings settings = getDialogSettings(); |
| |
| // Collect the ids of the all expanded categories |
| Object[] expandedElements = filteredTree.getViewer().getExpandedElements(); |
| String[] expandedCategoryIds = new String[expandedElements.length]; |
| for (int i = 0; i < expandedElements.length; ++i) { |
| expandedCategoryIds[i] = ((IViewCategory) expandedElements[i]).getId(); |
| } |
| |
| // Save them for next time. |
| settings.put(STORE_EXPANDED_CATEGORIES_ID, expandedCategoryIds); |
| |
| String selectedViewId = ""; //$NON-NLS-1$ |
| if (viewDescs.length > 0) { |
| // in the case of a multi-selection, it's probably less confusing |
| // to store just the first rather than the whole multi-selection |
| selectedViewId = viewDescs[0].getId(); |
| } |
| settings.put(STORE_SELECTED_VIEW_ID, selectedViewId); |
| } |
| |
| /** |
| * Notifies that the selection has changed. |
| * |
| * @param event event object describing the change |
| */ |
| public void selectionChanged(SelectionChangedEvent event) { |
| updateSelection(event); |
| updateButtons(); |
| } |
| |
| /** |
| * Update the button enablement state. |
| */ |
| protected void updateButtons() { |
| if (okButton != null) { |
| okButton.setEnabled(getSelection().length > 0); |
| } |
| } |
| |
| /** |
| * Update the selection object. |
| */ |
| protected void updateSelection(SelectionChangedEvent event) { |
| ArrayList descs = new ArrayList(); |
| IStructuredSelection sel = (IStructuredSelection) event.getSelection(); |
| for (Iterator i = sel.iterator(); i.hasNext();) { |
| Object o = i.next(); |
| if (o instanceof IViewDescriptor) { |
| descs.add(o); |
| } |
| } |
| viewDescs = new IViewDescriptor[descs.size()]; |
| descs.toArray(viewDescs); |
| } |
| } |