/*******************************************************************************
* Copyright (c) 2010 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.wst.sse.ui.preferences;
import java.util.ArrayList;
import java.util.Collections;
import java.util.Comparator;
import java.util.HashMap;
import java.util.Iterator;
import java.util.List;
import java.util.Map;
import org.eclipse.core.commands.Command;
import org.eclipse.core.commands.CommandManager;
import org.eclipse.core.commands.ParameterizedCommand;
import org.eclipse.core.commands.common.NotDefinedException;
import org.eclipse.core.commands.contexts.ContextManager;
import org.eclipse.core.runtime.Assert;
import org.eclipse.jface.bindings.BindingManager;
import org.eclipse.jface.bindings.Scheme;
import org.eclipse.jface.bindings.TriggerSequence;
import org.eclipse.jface.layout.PixelConverter;
import org.eclipse.jface.resource.ImageDescriptor;
import org.eclipse.jface.resource.JFaceResources;
import org.eclipse.jface.viewers.ArrayContentProvider;
import org.eclipse.jface.viewers.CheckStateChangedEvent;
import org.eclipse.jface.viewers.CheckboxTableViewer;
import org.eclipse.jface.viewers.ICheckStateListener;
import org.eclipse.jface.viewers.IStructuredSelection;
import org.eclipse.jface.viewers.ITableLabelProvider;
import org.eclipse.jface.viewers.LabelProvider;
import org.eclipse.jface.viewers.Viewer;
import org.eclipse.jface.viewers.ViewerComparator;
import org.eclipse.osgi.util.NLS;
import org.eclipse.swt.SWT;
import org.eclipse.swt.events.SelectionAdapter;
import org.eclipse.swt.events.SelectionEvent;
import org.eclipse.swt.graphics.GC;
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.Group;
import org.eclipse.swt.widgets.Label;
import org.eclipse.swt.widgets.Table;
import org.eclipse.swt.widgets.TableColumn;
import org.eclipse.ui.PlatformUI;
import org.eclipse.ui.commands.ICommandService;
import org.eclipse.ui.keys.IBindingService;
import org.eclipse.ui.texteditor.ITextEditorActionDefinitionIds;
import org.eclipse.wst.sse.ui.internal.Logger;
import org.eclipse.wst.sse.ui.internal.SSEUIMessages;
import org.eclipse.wst.sse.ui.internal.contentassist.CompletionProposalCategory;
import org.eclipse.wst.sse.ui.internal.contentassist.CompletionProposalComputerRegistry;
import org.eclipse.wst.sse.ui.internal.util.SWTUtil;
/**
* <p>A helpful preference configuration block implementation for allowing a user to
* set their preferences for which content assist categories to show on the default
* content assist page as well as on their own separate page and page ordering for
* a specific content type</p>
*
* @base org.eclipse.jdt.internal.ui.preferences.CodeAssistAdvancedConfigurationBlock
*/
public final class CodeAssistCyclingConfigurationBlock {
/**
* <p>Used to compare categories based on their assigned page rank</p>
*/
private final Comparator fCategoryPageComparator = new Comparator() {
private int getRank(Object o) {
return ((ModelElement) o).getOwnPageRank();
}
public int compare(Object o1, Object o2) {
int result = getRank(o1) - getRank(o2);
if(result == 0) {
result = ((ModelElement) o1).getId().compareTo(((ModelElement) o2).getId());
}
return result;
}
};
/**
* <p>Used to compare categories based on their assigned default page rank</p>
*/
private final Comparator fCategoryDefaultPageComparator = new Comparator() {
private int getRank(Object o) {
return ((ModelElement) o).getDefaultPageRank();
}
public int compare(Object o1, Object o2) {
int result = getRank(o1) - getRank(o2);
if(result == 0) {
result = ((ModelElement) o1).getId().compareTo(((ModelElement) o2).getId());
}
return result;
}
};
/** the preference model for this block */
private final PreferenceModel fModel;
/**
* <code>{@link Map}<{@link ImageDescriptor}, {@link Image}></code>
*/
private final Map fImages= new HashMap();
/** table viewer to configure which categories are displayed on the default page */
private CheckboxTableViewer fDefaultPageViewer;
/**
* table viewer to configure which categories are displayed
* on their own page, as well as their ordering
*/
private CheckboxTableViewer fOwnPageViewer;
/** categories pages sort order up button */
private Button fPageOrderUpButton;
/** categories pages sort order down button */
private Button fPageOrderDownButton;
/** categories default page sort order up button */
private Button fDefaultPageOrderUpButton;
/** categories default page sort order down button */
private Button fDefaultPageOrderDownButton;
/** The content type ID this configuration block is for */
private String fContentTypeID;
/** The writable categories configuration */
private ICompletionProposalCategoriesConfigurationWriter fConfigurationWriter;
/**
* <p>Creates a new content assist preference block for the given content type
* using the given configuration writer</p>
*
* @param contentTypeID content type this content assist preference block is for
* @param configurationWriter {@link ICompletionProposalCategoriesConfigurationWriter} used
* to read and write the user preferences
*/
public CodeAssistCyclingConfigurationBlock(String contentTypeID, ICompletionProposalCategoriesConfigurationWriter configurationWriter) {
this.fContentTypeID = contentTypeID;
this.fConfigurationWriter = configurationWriter;
List categories = CompletionProposalComputerRegistry.getDefault().getProposalCategories(this.fContentTypeID);
this.fModel = new PreferenceModel(categories);
}
/**
* <p>Saves the user configuration</p>
* @return <code>true</code> if store was successful, <code>false</code> otherwise
*/
public boolean storeValues() {
return this.fConfigurationWriter.saveConfiguration();
}
/**
* <p>Loads the preference defaults</p>
*/
public void performDefaults() {
this.fConfigurationWriter.loadDefaults();
this.initializeValues();
this.fModel.performDefaults();
}
/**
* <p>Disposes of this preference block</p>
*/
public void dispose() {
for (Iterator it= fImages.values().iterator(); it.hasNext();) {
Image image= (Image) it.next();
image.dispose();
}
}
/**
* <p>Creates the contents of this configuration block using a {@link Group} if
* the given <code>groupTitle</code> is not <code>null</code> else creates it
* as a composite and in either case adds itself to the given parent</p>
*
* @param parent {@link Composite} parent to add this configuration block to
* @param groupTitle Title to use for the configuration block group, if
* <code>null</code> then a {@link Composite} will be used instead of a
* {@link Group}
*
* @return the created configuration block that has already been added to the parent
*/
public Control createContents(Composite parent, String groupTitle) {
Composite container;
if(groupTitle != null) {
container = new Group(parent, SWT.NULL);
((Group)container).setText(groupTitle);
} else {
container = new Composite(parent, SWT.NULL);
}
int columns= 2;
GridLayout layout= new GridLayout(columns, false);
container.setLayout(layout);
GridData data = new GridData(GridData.FILL);
data.horizontalIndent = 0;
data.verticalAlignment = GridData.FILL;
data.horizontalAlignment = GridData.FILL;
data.grabExcessHorizontalSpace = true;
container.setLayoutData(data);
createDefaultPageLabel(container, columns);
createDefaultPageSection(container);
createFiller(container, columns);
createOwnPageLabel(container, columns);
createOwnPageSection(container);
createFiller(container, columns);
if (fModel.pageElements.size() > 0) {
fDefaultPageViewer.getTable().select(0);
fOwnPageViewer.getTable().select(0);
handleOwnPageTableSelection();
handleDefaultPageTableSelection();
}
return container;
}
/**
* <p>Initialize the values of the configuration block</p>
*/
public void initializeValues() {
updateCheckedState();
fDefaultPageViewer.refresh();
fOwnPageViewer.refresh();
handleOwnPageTableSelection();
handleDefaultPageTableSelection();
}
private void createDefaultPageSection(Composite composite) {
createDefaultPageViewer(composite);
createDefaultPageButtonList(composite);
}
private void createDefaultPageLabel(Composite composite, int h_span) {
final ICommandService commandSvc= (ICommandService) PlatformUI.getWorkbench().getAdapter(ICommandService.class);
final Command command= commandSvc.getCommand(ITextEditorActionDefinitionIds.CONTENT_ASSIST_PROPOSALS);
ParameterizedCommand pCmd= new ParameterizedCommand(command, null);
String key= getKeyboardShortcut(pCmd);
if (key == null) {
key= SSEUIMessages.CodeAssistAdvancedConfigurationBlock_no_shortcut;
}
PixelConverter pixelConverter= new PixelConverter(composite);
int width= pixelConverter.convertWidthInCharsToPixels(40);
Label label= new Label(composite, SWT.NONE | SWT.WRAP);
label.setText(NLS.bind(SSEUIMessages.CodeAssistAdvancedConfigurationBlock_page_description, new Object[] { key }));
GridData gd= new GridData(GridData.FILL, GridData.FILL, true, false, h_span, 1);
gd.widthHint= width;
label.setLayoutData(gd);
createFiller(composite, h_span);
label= new Label(composite, SWT.NONE | SWT.WRAP);
label.setText(SSEUIMessages.CodeAssistAdvancedConfigurationBlock_default_table_description);
gd= new GridData(GridData.FILL, GridData.FILL, true, false, h_span, 1);
gd.widthHint= width;
label.setLayoutData(gd);
}
private void createDefaultPageViewer(Composite composite) {
fDefaultPageViewer= CheckboxTableViewer.newCheckList(composite, SWT.SINGLE | SWT.BORDER);
Table table= fDefaultPageViewer.getTable();
table.setHeaderVisible(true);
table.setLinesVisible(false);
table.setLayoutData(new GridData(GridData.FILL, GridData.BEGINNING, false, false, 1, 1));
TableColumn nameColumn= new TableColumn(table, SWT.NONE);
nameColumn.setText(SSEUIMessages.CodeAssistAdvancedConfigurationBlock_default_table_category_column_title);
nameColumn.setResizable(false);
fDefaultPageViewer.addCheckStateListener(new ICheckStateListener() {
public void checkStateChanged(CheckStateChangedEvent event) {
boolean checked= event.getChecked();
ModelElement element= (ModelElement) event.getElement();
element.setShouldDisplayOnDefaultPage(checked);
}
});
fDefaultPageViewer.setContentProvider(new ArrayContentProvider());
DefaultPageTableLabelProvider labelProvider= new DefaultPageTableLabelProvider();
fDefaultPageViewer.setLabelProvider(labelProvider);
fDefaultPageViewer.setInput(fModel.defaultPageElements);
fDefaultPageViewer.setComparator(new ModelViewerComparator(fCategoryDefaultPageComparator));
final int ICON_AND_CHECKBOX_WITH= 50;
final int HEADER_MARGIN= 20;
int minNameWidth= computeWidth(table, nameColumn.getText()) + HEADER_MARGIN;
for (int i= 0; i < fModel.defaultPageElements.size(); i++) {
minNameWidth= Math.max(minNameWidth, computeWidth(table, labelProvider.getColumnText(fModel.defaultPageElements.get(i), 0)) + ICON_AND_CHECKBOX_WITH);
}
nameColumn.setWidth(minNameWidth);
table.addSelectionListener(new SelectionAdapter() {
public void widgetSelected(SelectionEvent e) {
handleDefaultPageTableSelection();
}
});
}
/**
* <p>Create the Up and Down buttons for the default page viewer</p>
* @param parent {@link Composite} to add the button list to
*/
private void createDefaultPageButtonList(Composite parent) {
Composite composite= new Composite(parent, SWT.NONE);
composite.setLayoutData(new GridData(SWT.BEGINNING, SWT.BEGINNING, false, false));
GridLayout layout= new GridLayout();
layout.marginWidth= 0;
layout.marginHeight= 0;
composite.setLayout(layout);
fDefaultPageOrderUpButton= new Button(composite, SWT.PUSH | SWT.CENTER);
fDefaultPageOrderUpButton.setText(SSEUIMessages.CodeAssistAdvancedConfigurationBlock_Up);
fDefaultPageOrderUpButton.addSelectionListener(new SelectionAdapter() {
public void widgetSelected(SelectionEvent e) {
int index = fDefaultPageViewer.getTable().getSelectionIndex();
if (index != -1) {
fModel.moveDefaultPageCategoryUp(index);
fDefaultPageViewer.refresh();
handleDefaultPageTableSelection();
}
}
});
fDefaultPageOrderUpButton.setLayoutData(new GridData());
SWTUtil.setButtonDimensionHint(fDefaultPageOrderUpButton);
fDefaultPageOrderDownButton= new Button(composite, SWT.PUSH | SWT.CENTER);
fDefaultPageOrderDownButton.setText(SSEUIMessages.CodeAssistAdvancedConfigurationBlock_Down);
fDefaultPageOrderDownButton.addSelectionListener(new SelectionAdapter() {
public void widgetSelected(SelectionEvent e) {
int index= fDefaultPageViewer.getTable().getSelectionIndex();
if (index != -1) {
fModel.moveDefaultPageCategoryDown(index);
fDefaultPageViewer.refresh();
handleDefaultPageTableSelection();
}
}
});
fDefaultPageOrderDownButton.setLayoutData(new GridData());
SWTUtil.setButtonDimensionHint(fDefaultPageOrderDownButton);
}
private void createFiller(Composite composite, int h_span) {
Label filler= new Label(composite, SWT.NONE);
filler.setVisible(false);
filler.setLayoutData(new GridData(SWT.FILL, SWT.FILL, false, false, h_span, 1));
}
private void createOwnPageLabel(Composite composite, int h_span) {
PixelConverter pixelConverter= new PixelConverter(composite);
int width= pixelConverter.convertWidthInCharsToPixels(40);
Label label= new Label(composite, SWT.NONE | SWT.WRAP);
label.setText(SSEUIMessages.CodeAssistAdvancedConfigurationBlock_separate_table_description);
GridData gd= new GridData(GridData.FILL, GridData.FILL, false, false, h_span, 1);
gd.widthHint= width;
label.setLayoutData(gd);
}
private void createOwnPageSection(Composite composite) {
createOwnPageViewer(composite);
createOwnPageButtonList(composite);
}
private void createOwnPageViewer(Composite composite) {
fOwnPageViewer= CheckboxTableViewer.newCheckList(composite, SWT.SINGLE | SWT.BORDER);
Table table= fOwnPageViewer.getTable();
table.setHeaderVisible(true);
table.setLinesVisible(false);
table.setLayoutData(new GridData(GridData.FILL, GridData.BEGINNING, true, false, 1, 1));
TableColumn nameColumn= new TableColumn(table, SWT.NONE);
nameColumn.setText(SSEUIMessages.CodeAssistAdvancedConfigurationBlock_separate_table_category_column_title);
nameColumn.setResizable(false);
fOwnPageViewer.setContentProvider(new ArrayContentProvider());
ITableLabelProvider labelProvider= new OwnPageTableLabelProvider();
fOwnPageViewer.setLabelProvider(labelProvider);
fOwnPageViewer.setInput(fModel.pageElements);
fOwnPageViewer.setComparator(new ModelViewerComparator(fCategoryPageComparator));
final int ICON_AND_CHECKBOX_WITH= 50;
final int HEADER_MARGIN= 20;
int minNameWidth= computeWidth(table, nameColumn.getText()) + HEADER_MARGIN;
for (int i= 0; i < fModel.pageElements.size(); i++) {
minNameWidth= Math.max(minNameWidth, computeWidth(table, labelProvider.getColumnText(fModel.pageElements.get(i), 0)) + ICON_AND_CHECKBOX_WITH);
}
nameColumn.setWidth(minNameWidth);
fOwnPageViewer.addCheckStateListener(new ICheckStateListener() {
public void checkStateChanged(CheckStateChangedEvent event) {
boolean checked= event.getChecked();
ModelElement element= (ModelElement) event.getElement();
element.setShouldDisplayOnOwnPage(checked);
}
});
table.addSelectionListener(new SelectionAdapter() {
public void widgetSelected(SelectionEvent e) {
handleOwnPageTableSelection();
}
});
}
/**
* <p>Create the Up and Down buttons for the own page viewer</p>
* @param parent {@link Composite} to add the button list to
*/
private void createOwnPageButtonList(Composite parent) {
Composite composite= new Composite(parent, SWT.NONE);
composite.setLayoutData(new GridData(SWT.BEGINNING, SWT.BEGINNING, false, false));
GridLayout layout= new GridLayout();
layout.marginWidth= 0;
layout.marginHeight= 0;
composite.setLayout(layout);
fPageOrderUpButton= new Button(composite, SWT.PUSH | SWT.CENTER);
fPageOrderUpButton.setText(SSEUIMessages.CodeAssistAdvancedConfigurationBlock_PagesUp);
fPageOrderUpButton.addSelectionListener(new SelectionAdapter() {
public void widgetSelected(SelectionEvent e) {
int index = fOwnPageViewer.getTable().getSelectionIndex();
if (index != -1) {
fModel.movePageUp(index);
fOwnPageViewer.refresh();
handleOwnPageTableSelection();
}
}
});
fPageOrderUpButton.setLayoutData(new GridData());
SWTUtil.setButtonDimensionHint(fPageOrderUpButton);
fPageOrderDownButton= new Button(composite, SWT.PUSH | SWT.CENTER);
fPageOrderDownButton.setText(SSEUIMessages.CodeAssistAdvancedConfigurationBlock_PagesDown);
fPageOrderDownButton.addSelectionListener(new SelectionAdapter() {
public void widgetSelected(SelectionEvent e) {
int index= fOwnPageViewer.getTable().getSelectionIndex();
if (index != -1) {
fModel.movePageDown(index);
fOwnPageViewer.refresh();
handleOwnPageTableSelection();
}
}
});
fPageOrderDownButton.setLayoutData(new GridData());
SWTUtil.setButtonDimensionHint(fPageOrderDownButton);
}
/**
* <p>Update the enablement of the Up and Down buttons for the own page table viewer</p>
*/
private void handleOwnPageTableSelection() {
ModelElement item= (ModelElement) ((IStructuredSelection) fOwnPageViewer.getSelection()).getFirstElement();
if (item != null) {
int index= fOwnPageViewer.getTable().getSelectionIndex();
fPageOrderUpButton.setEnabled(index > 0);
fPageOrderDownButton.setEnabled(index < fModel.pageElements.size() - 1);
} else {
fPageOrderUpButton.setEnabled(false);
fPageOrderDownButton.setEnabled(false);
}
}
/**
* <p>Update the enablement of the Up and Down buttons for the default page table viewer</p>
*/
private void handleDefaultPageTableSelection() {
ModelElement item= (ModelElement) ((IStructuredSelection) fDefaultPageViewer.getSelection()).getFirstElement();
if (item != null) {
int index = fDefaultPageViewer.getTable().getSelectionIndex();
fDefaultPageOrderUpButton.setEnabled(index > 0);
fDefaultPageOrderDownButton.setEnabled(index < fModel.defaultPageElements.size() - 1);
} else {
fDefaultPageOrderUpButton.setEnabled(false);
fDefaultPageOrderDownButton.setEnabled(false);
}
}
private void updateCheckedState() {
/* does not matter which set of elements we use here
* because order does not matter in this case
*/
final int size= fModel.pageElements.size();
List defaultChecked= new ArrayList(size);
List separateChecked= new ArrayList(size);
for (Iterator it= fModel.pageElements.iterator(); it.hasNext();) {
ModelElement element= (ModelElement) it.next();
if (element.shouldDisplayOnDefaultPage())
defaultChecked.add(element);
if (element.shouldDisplayOnOwnPage())
separateChecked.add(element);
}
fDefaultPageViewer.setCheckedElements(defaultChecked.toArray(new Object[defaultChecked.size()]));
fOwnPageViewer.setCheckedElements(separateChecked.toArray(new Object[separateChecked.size()]));
}
private int computeWidth(Control control, String name) {
if (name == null)
return 0;
GC gc= new GC(control);
try {
gc.setFont(JFaceResources.getDialogFont());
return gc.stringExtent(name).x + 10;
} finally {
gc.dispose();
}
}
private static BindingManager fgLocalBindingManager;
static {
fgLocalBindingManager= new BindingManager(new ContextManager(), new CommandManager());
final IBindingService bindingService= (IBindingService)PlatformUI.getWorkbench().getService(IBindingService.class);
final Scheme[] definedSchemes= bindingService.getDefinedSchemes();
if (definedSchemes != null) {
try {
for (int i = 0; i < definedSchemes.length; i++) {
final Scheme scheme= definedSchemes[i];
final Scheme copy= fgLocalBindingManager.getScheme(scheme.getId());
copy.define(scheme.getName(), scheme.getDescription(), scheme.getParentId());
}
} catch (final NotDefinedException e) {
Logger.logException(e);
}
}
fgLocalBindingManager.setLocale(bindingService.getLocale());
fgLocalBindingManager.setPlatform(bindingService.getPlatform());
}
private static String getKeyboardShortcut(ParameterizedCommand command) {
IBindingService bindingService= (IBindingService) PlatformUI.getWorkbench().getAdapter(IBindingService.class);
fgLocalBindingManager.setBindings(bindingService.getBindings());
try {
Scheme activeScheme= bindingService.getActiveScheme();
if (activeScheme != null)
fgLocalBindingManager.setActiveScheme(activeScheme);
} catch (NotDefinedException e) {
Logger.logException(e);
}
TriggerSequence[] bindings= fgLocalBindingManager.getActiveBindingsDisregardingContextFor(command);
if (bindings.length > 0)
return bindings[0].format();
return null;
}
/**
* <p>Gets and image based on an image descriptor, and stores the image so it
* does not have to be created more then once</p>
*
* @param imgDesc {@link ImageDescriptor} to get the {@link Image} for
* @return {@link Image} created from the {@link ImageDescriptor}, or stored
* {@link Image} associated with the given {@link ImageDescriptor} if an
* {@link Image} had already been created for the given {@link ImageDescriptor}
*/
private Image getImage(ImageDescriptor imgDesc) {
if (imgDesc == null)
return null;
Image img= (Image) fImages.get(imgDesc);
if (img == null) {
img= imgDesc.createImage(false);
fImages.put(imgDesc, img);
}
return img;
}
/**
* <p>Label provider for the table for configuring which categories should be displayed on the
* default assist page</p>
*/
private final class DefaultPageTableLabelProvider extends LabelProvider implements ITableLabelProvider {
/**
* @see org.eclipse.jface.viewers.ITableLabelProvider#getColumnImage(java.lang.Object, int)
*/
public Image getColumnImage(Object element, int columnIndex) {
if (columnIndex == 0)
return ((ModelElement) element).getImage();
return null;
}
/**
* @see org.eclipse.jface.viewers.ITableLabelProvider#getColumnText(java.lang.Object, int)
*/
public String getColumnText(Object element, int columnIndex) {
switch (columnIndex) {
case 0:
return ((ModelElement) element).getName();
default:
Assert.isTrue(false);
return null;
}
}
/**
* @see org.eclipse.jface.viewers.LabelProvider#getText(java.lang.Object)
*/
public String getText(Object element) {
return getColumnText(element, 0); // needed to make the sorter work
}
}
/**
* <p>Label provider for the table for configuring which categories should be displayed on their
* own content assist page</p>
*/
private final class OwnPageTableLabelProvider extends LabelProvider implements ITableLabelProvider {
/**
* @see org.eclipse.jface.viewers.ITableLabelProvider#getColumnImage(java.lang.Object, int)
*/
public Image getColumnImage(Object element, int columnIndex) {
if (columnIndex == 0)
return ((ModelElement) element).getImage();
return null;
}
/**
* @see org.eclipse.jface.viewers.ITableLabelProvider#getColumnText(java.lang.Object, int)
*/
public String getColumnText(Object element, int columnIndex) {
switch (columnIndex) {
case 0:
return ((ModelElement) element).getName();
default:
Assert.isTrue(false);
return null;
}
}
}
/**
* <p>PreferenceModel used to read and write the user preferences
* using the {@link ICompletionProposalCategoriesConfigurationWriter}</p>
*/
private final class PreferenceModel {
/** private modifiable page element list */
private final List fPageElements;
/** public unmodifiable page element list */
final List pageElements;
/** private modifiable default page element list */
private final List fDefaultPageElements;
/** public unmodifiable default page element list */
final List defaultPageElements;
/**
* <p>Create the preference model for the given categories</p>
*
* @param categories <code>{@link List}<{@link CompletionProposalCategory}></code>
*/
public PreferenceModel(List categories) {
//need separate lists because they will be ordered differently
this.fPageElements = new ArrayList();
this.fDefaultPageElements = new ArrayList();
for (Iterator it= categories.iterator(); it.hasNext();) {
CompletionProposalCategory category= (CompletionProposalCategory) it.next();
if (category.hasComputers()) {
ModelElement elem = new ModelElement(category);
fPageElements.add(elem);
fDefaultPageElements.add(elem);
}
}
//sort the lists
this.performDefaults();
pageElements = Collections.unmodifiableList(fPageElements);
defaultPageElements = Collections.unmodifiableList(fDefaultPageElements);
}
/**
* <p>Move the model element specified by the given index
* up in the content assist page order</p>
*
* @param elementIndex the index of the model element to move up
*/
public void movePageUp(int elementIndex) {
Object removed = fPageElements.remove(elementIndex);
fPageElements.add(elementIndex-1, removed);
fConfigurationWriter.setPageOrder(getPageOrderedCategoryIDs());
}
/**
* <p>Move the model element specified by the given index
* down in the content assist page order</p>
*
* @param elementIndex the index of the model element to move up
*/
public void movePageDown(int elementIndex) {
Object removed = fPageElements.remove(elementIndex);
fPageElements.add(elementIndex+1, removed);
fConfigurationWriter.setPageOrder(getPageOrderedCategoryIDs());
}
/**
* <p>Move the model element specified by the given index
* up in the content assist page order</p>
*
* @param elementIndex the index of the model element to move up
*/
public void moveDefaultPageCategoryUp(int elementIndex) {
Object removed = fDefaultPageElements.remove(elementIndex);
fDefaultPageElements.add(elementIndex-1, removed);
fConfigurationWriter.setDefaultPageOrder(getDefaultPageOrderedCategoryIDs());
}
/**
* <p>Move the model element specified by the given index
* down in the content assist page order</p>
*
* @param elementIndex the index of the model element to move up
*/
public void moveDefaultPageCategoryDown(int elementIndex) {
Object removed = fDefaultPageElements.remove(elementIndex);
fDefaultPageElements.add(elementIndex+1, removed);
fConfigurationWriter.setDefaultPageOrder(getDefaultPageOrderedCategoryIDs());
}
/**
* @return <code>{@link List}<{@link String}></code> -
* List of category IDs by page order
*/
private List getPageOrderedCategoryIDs() {
List ordered = new ArrayList(pageElements.size());
for(int i = 0; i < pageElements.size(); ++i) {
ordered.add(((ModelElement)pageElements.get(i)).getId());
}
return ordered;
}
/**
* @return <code>{@link List}<{@link String}></code> -
* List of category IDs by default page order
*/
private List getDefaultPageOrderedCategoryIDs() {
List ordered = new ArrayList(defaultPageElements.size());
for(int i = 0; i < defaultPageElements.size(); ++i) {
ordered.add(((ModelElement)defaultPageElements.get(i)).getId());
}
return ordered;
}
/**
* <p>need to re-sort the lists after performing defaults</p>
*/
public void performDefaults() {
Collections.sort(fPageElements, fCategoryPageComparator);
Collections.sort(fDefaultPageElements, fCategoryDefaultPageComparator);
}
}
/**
* <p>Wraps a {@link CompletionProposalCategory} for use in the {@link PreferenceModel}</p>
*/
private final class ModelElement {
/** The wrapped category */
private final CompletionProposalCategory fCategory;
/**
* <p>Create a new model element wrapping the given category</p>
*
* @param category {@link CompletionProposalCategory} to be wrapped by this model element
* for use in the {@link PreferenceModel}
*/
ModelElement(CompletionProposalCategory category) {
fCategory= category;
}
/**
* @return {@link Image} associated with the wrapped category
*/
Image getImage() {
return CodeAssistCyclingConfigurationBlock.this.getImage(fCategory.getImageDescriptor());
}
/**
* @return name of the wrapped category
*/
String getName() {
return fCategory.getDisplayName();
}
String getId() {
return fCategory.getId();
}
/**
* @return <code>true</code> if the wrapped category should be displayed on the
* default content assist page, <code>false</code> otherwise
*/
boolean shouldDisplayOnDefaultPage() {
return fConfigurationWriter.shouldDisplayOnDefaultPage(this.getId());
}
/**
* @param included <code>true</code> if the wrapped category should be displayed on the
* default content assist page, <code>false</code> otherwise
*/
void setShouldDisplayOnDefaultPage(boolean included) {
fConfigurationWriter.setShouldDisplayOnDefaultPage(this.getId(), included);
}
/**
* @return <code>true</code> if the wrapped category should be displayed on the
* its own content assist page, <code>false</code> otherwise
*/
boolean shouldDisplayOnOwnPage() {
return fConfigurationWriter.shouldDisplayOnOwnPage(this.getId());
}
/**
* @param shouldDisplay <code>true</code> if the wrapped category should be displayed on the
* its own content assist page, <code>false</code> otherwise
*/
void setShouldDisplayOnOwnPage(boolean shouldDisplay) {
fConfigurationWriter.setShouldDisplayOnOwnPage(this.getId(), shouldDisplay);
}
/**
* @return the wrapped categories content assist page sort rank compared to the
* other categories
*/
int getOwnPageRank() {
return fConfigurationWriter.getPageSortOrder(this.getId());
}
/**
* @return the wrapped categories content assist page sort rank compared to the
* other categories
*/
int getDefaultPageRank() {
return fConfigurationWriter.getDefaultPageSortOrder(this.getId());
}
}
private class ModelViewerComparator extends ViewerComparator {
/**
*
*/
public ModelViewerComparator(Comparator comparator) {
super(comparator);
}
/**
* @see org.eclipse.jface.viewers.ViewerComparator#compare(org.eclipse.jface.viewers.Viewer, java.lang.Object, java.lang.Object)
*/
public int compare(Viewer viewer, Object e1, Object e2) {
return this.getComparator().compare(e1, e2);
}
}
}