/******************************************************************************* * Copyright (c) 2013 Association for Decentralized Information Management * in Industry THTH ry. * 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: * VTT Technical Research Centre of Finland - initial API and implementation *******************************************************************************/ package org.simantics.browsing.ui.swt; import java.text.MessageFormat; import java.util.regex.Pattern; import org.eclipse.core.runtime.Assert; import org.eclipse.jface.viewers.CellEditor; import org.eclipse.jface.viewers.ComboBoxCellEditor; import org.eclipse.swt.SWT; import org.eclipse.swt.events.FocusAdapter; import org.eclipse.swt.events.FocusEvent; import org.eclipse.swt.events.KeyAdapter; import org.eclipse.swt.events.KeyEvent; import org.eclipse.swt.events.SelectionAdapter; import org.eclipse.swt.events.SelectionEvent; import org.eclipse.swt.events.TraverseEvent; import org.eclipse.swt.events.TraverseListener; import org.eclipse.swt.graphics.GC; import org.eclipse.swt.widgets.Combo; import org.eclipse.swt.widgets.Composite; import org.eclipse.swt.widgets.Control; /** * Similar to org.eclipse.jface.viewers.ComboBoxCellEditor, but:
* Uses Combo instead of CCombo
* Set value when combo item is selected, does not wait for CR Key / Focus lost to apply the value.
* In ReadOnly mode uses alphanum keys to preselect items.
* * @author Marko Luukkainen * */ public class ComboBoxCellEditor2 extends CellEditor { private static final int KEY_INPUT_DELAY = 500; /** * The list of items to present in the combo box. */ private String[] items; /** * The zero-based index of the selected item. */ int selection; /** * The custom combo box control. */ Combo comboBox; /** * Default ComboBoxCellEditor style */ private static final int defaultStyle = SWT.NONE; /** * Creates a new cell editor with no control and no st of choices. * Initially, the cell editor has no cell validator. * * @since 2.1 * @see CellEditor#setStyle * @see CellEditor#create * @see ComboBoxCellEditor#setItems * @see CellEditor#dispose */ public ComboBoxCellEditor2() { setStyle(defaultStyle); } /** * Creates a new cell editor with a combo containing the given list of * choices and parented under the given control. The cell editor value is * the zero-based index of the selected item. Initially, the cell editor has * no cell validator and the first item in the list is selected. * * @param parent * the parent control * @param items * the list of strings for the combo box */ public ComboBoxCellEditor2(Composite parent, String[] items) { this(parent, items, defaultStyle); } /** * Creates a new cell editor with a combo containing the given list of * choices and parented under the given control. The cell editor value is * the zero-based index of the selected item. Initially, the cell editor has * no cell validator and the first item in the list is selected. * * @param parent * the parent control * @param items * the list of strings for the combo box * @param style * the style bits * @since 2.1 */ public ComboBoxCellEditor2(Composite parent, String[] items, int style) { super(parent, style); setItems(items); } /** * Returns the list of choices for the combo box * * @return the list of choices for the combo box */ public String[] getItems() { return this.items; } /** * Sets the list of choices for the combo box * * @param items * the list of choices for the combo box */ public void setItems(String[] items) { Assert.isNotNull(items); this.items = items; populateComboBoxItems(); } /* * (non-Javadoc) Method declared on CellEditor. */ protected Control createControl(Composite parent) { comboBox = new Combo(parent, getStyle()); comboBox.setFont(parent.getFont()); populateComboBoxItems(); if ((getStyle() & SWT.READ_ONLY) > 0) { comboBox.addKeyListener(new AutoCompleteAdapter(comboBox)); } comboBox.addKeyListener(new KeyAdapter() { // hook key pressed - see PR 14201 public void keyPressed(KeyEvent e) { keyReleaseOccured(e); } }); comboBox.addSelectionListener(new SelectionAdapter() { public void widgetDefaultSelected(SelectionEvent event) { applyEditorValueAndDeactivate(); } public void widgetSelected(SelectionEvent event) { selection = comboBox.getSelectionIndex(); if (!comboBox.getListVisible()) { /* * There seems to be no reliable way to detect if selection was done with * mouse or with arrow keys. The problem is that we want to close the editor, * if selection was changed with mouse, but keep it open if it was done with * arrow keys. */ // close the editor if list is visible. (Mouse selection hides the list) // Note that this prevents proper selections with arrow keys with hidden list. applyEditorValueAndDeactivate(); } } }); comboBox.addTraverseListener(new TraverseListener() { public void keyTraversed(TraverseEvent e) { if (e.detail == SWT.TRAVERSE_ESCAPE || e.detail == SWT.TRAVERSE_RETURN) { e.doit = false; } } }); comboBox.addFocusListener(new FocusAdapter() { public void focusLost(FocusEvent e) { ComboBoxCellEditor2.this.focusLost(); } }); return comboBox; } /** * The ComboBoxCellEditor implementation of this * CellEditor framework method returns the zero-based index * of the current selection. * * @return the zero-based index of the current selection wrapped as an * Integer */ protected Object doGetValue() { return new Integer(selection); } /* * (non-Javadoc) Method declared on CellEditor. */ protected void doSetFocus() { comboBox.setFocus(); } /** * The ComboBoxCellEditor implementation of this * CellEditor framework method sets the minimum width of the * cell. The minimum width is 10 characters if comboBox is * not null or disposed else it is 60 pixels * to make sure the arrow button and some text is visible. The list of * CCombo will be wide enough to show its longest item. */ public LayoutData getLayoutData() { LayoutData layoutData = super.getLayoutData(); if ((comboBox == null) || comboBox.isDisposed()) { layoutData.minimumWidth = 60; } else { // make the comboBox 10 characters wide GC gc = new GC(comboBox); layoutData.minimumWidth = (gc.getFontMetrics() .getAverageCharWidth() * 10) + 10; gc.dispose(); } return layoutData; } /** * The ComboBoxCellEditor implementation of this * CellEditor framework method accepts a zero-based index of * a selection. * * @param value * the zero-based index of the selection wrapped as an * Integer */ protected void doSetValue(Object value) { Assert.isTrue(comboBox != null && (value instanceof Integer)); selection = ((Integer) value).intValue(); comboBox.select(selection); } /** * Updates the list of choices for the combo box for the current control. */ private void populateComboBoxItems() { if (comboBox != null && items != null) { comboBox.removeAll(); for (int i = 0; i < items.length; i++) { comboBox.add(items[i], i); } setValueValid(true); selection = 0; } } /** * Applies the currently selected value and deactivates the cell editor */ void applyEditorValueAndDeactivate() { // must set the selection before getting value selection = comboBox.getSelectionIndex(); Object newValue = doGetValue(); markDirty(); boolean isValid = isCorrect(newValue); setValueValid(isValid); if (!isValid) { // Only format if the 'index' is valid if (items.length > 0 && selection >= 0 && selection < items.length) { // try to insert the current value into the error message. setErrorMessage(MessageFormat.format(getErrorMessage(), new Object[] { items[selection] })); } else { // Since we don't have a valid index, assume we're using an // 'edit' // combo so format using its text value setErrorMessage(MessageFormat.format(getErrorMessage(), new Object[] { comboBox.getText() })); } } fireApplyEditorValue(); deactivate(); } /* * (non-Javadoc) * * @see org.eclipse.jface.viewers.CellEditor#focusLost() */ protected void focusLost() { if (isActivated()) { applyEditorValueAndDeactivate(); } } /* * (non-Javadoc) * * @see org.eclipse.jface.viewers.CellEditor#keyReleaseOccured(org.eclipse.swt.events.KeyEvent) */ protected void keyReleaseOccured(KeyEvent keyEvent) { if (keyEvent.character == '\u001b') { // Escape character fireCancelEditor(); } else if (keyEvent.character == '\t') { // tab key applyEditorValueAndDeactivate(); } } protected int getDoubleClickTimeout() { // while we would want to allow double click closing the editor (Closing implementation is in org.eclipse.jface.viewers.ColumnViewerEditor) // using the double click detection prevents opening the combo, if the cell selection and edit commands are done "too fast". // // Hence, in order to use the double click mechanism so that is does not annoy users, the default ColumnViewerEditor must be overridden. return 0; } private class AutoCompleteAdapter extends KeyAdapter { private Combo combo; private String matcher = ""; private int prevEvent = 0; private int prevIndex = -1; private int toBeSelected = -1; protected Pattern alphaNum; public AutoCompleteAdapter(Combo combo) { this.combo = combo; alphaNum = Pattern.compile("\\p{Alnum}"); } @Override public void keyPressed(KeyEvent e) { if (combo.isDisposed()) return; if (e.keyCode == SWT.CR) { if (prevIndex != -1) { combo.select(toBeSelected); } } if (!alphaNum.matcher(Character.toString(e.character)).matches()) return; if ((e.time - prevEvent) > KEY_INPUT_DELAY ) matcher = ""; prevEvent = e.time; matcher = matcher += Character.toString(e.character); int index = findMatching(); if (index != -1) { combo.setText(combo.getItem(index)); toBeSelected = index; } prevIndex = index; e.doit = false; } public int findMatching() { int index = -1; if (prevIndex == -1) index = getMatchingIndex(matcher); else { index = getMatchingIndex(matcher,prevIndex); if (index == -1) { index = getMatchingIndex(matcher); } if (index == -1) { matcher = matcher.substring(matcher.length()-1); index = getMatchingIndex(matcher,prevIndex); if (index == -1) { index = getMatchingIndex(matcher); } } } return index; } public int getMatchingIndex(String prefix) { for (int i = 0; i < combo.getItemCount(); i++) { if (combo.getItem(i).toLowerCase().trim().startsWith(matcher)) { return i; } } return -1; } public int getMatchingIndex(String prefix, int firstIndex) { for (int i = firstIndex+1; i < combo.getItemCount(); i++) { if (combo.getItem(i).toLowerCase().trim().startsWith(matcher)) { return i; } } return -1; } } }