All Downloads are FREE. Search and download functionalities are using the official Maven repository.

org.eclipse.jface.viewers.TableViewer Maven / Gradle / Ivy

There is a newer version: 3.29.0
Show newest version
/*******************************************************************************
 * Copyright (c) 2000, 2009 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
 *     Tom Schindl  - concept of ViewerRow,
 *                                                 fix for 159597, refactoring (bug 153993),
 *                                                 widget-independency (bug 154329), fix for 187826, 191468
 *     Peter Centgraf - bug 251575
 *******************************************************************************/

package org.eclipse.jface.viewers;

import org.eclipse.core.runtime.Assert;
import org.eclipse.swt.SWT;
import org.eclipse.swt.graphics.Point;
import org.eclipse.swt.widgets.Composite;
import org.eclipse.swt.widgets.Control;
import org.eclipse.swt.widgets.Item;
import org.eclipse.swt.widgets.Table;
import org.eclipse.swt.widgets.TableItem;
import org.eclipse.swt.widgets.Widget;

/**
 * A concrete viewer based on a SWT Table control.
 * 

* This class is not intended to be subclassed outside the viewer framework. It * is designed to be instantiated with a pre-existing SWT table control and * configured with a domain-specific content provider, table label provider, * element filter (optional), and element sorter (optional). *

*

* Label providers for table viewers must implement either the * ITableLabelProvider or the ILabelProvider interface * (see TableViewer.setLabelProvider for more details). *

*

* As of 3.1 the TableViewer now supports the SWT.VIRTUAL flag. If the * underlying table is SWT.VIRTUAL, the content provider may implement {@link * ILazyContentProvider} instead of {@link IStructuredContentProvider} . Note * that in this case, the viewer does not support sorting or filtering. Also * note that in this case, the Widget based APIs may return null if the element * is not specified or not created yet. *

*

* Users of SWT.VIRTUAL should also avoid using getItems() from the Table within * the TreeViewer as this does not necessarily generate a callback for the * TreeViewer to populate the items. It also has the side effect of creating all * of the items thereby eliminating the performance improvements of SWT.VIRTUAL. *

*

* Users setting up an editable table with more than 1 column have to pass the * SWT.FULL_SELECTION style bit *

* * @see SWT#VIRTUAL * @see #doFindItem(Object) * @see #internalRefresh(Object, boolean) * @noextend This class is not intended to be subclassed by clients. */ public class TableViewer extends AbstractTableViewer { /** * This viewer's table control. */ private Table table; /** * The cached row which is reused all over */ private TableViewerRow cachedRow; /** * Creates a table viewer on a newly-created table control under the given * parent. The table control is created using the SWT style bits * MULTI, H_SCROLL, V_SCROLL, and BORDER. The * viewer has no input, no content provider, a default label provider, no * sorter, and no filters. The table has no columns. * * @param parent * the parent control */ public TableViewer(Composite parent) { this(parent, SWT.MULTI | SWT.H_SCROLL | SWT.V_SCROLL | SWT.BORDER); } /** * Creates a table viewer on a newly-created table control under the given * parent. The table control is created using the given style bits. The * viewer has no input, no content provider, a default label provider, no * sorter, and no filters. The table has no columns. * * @param parent * the parent control * @param style * SWT style bits */ public TableViewer(Composite parent, int style) { this(new Table(parent, style)); } /** * Creates a table viewer on the given table control. The viewer has no * input, no content provider, a default label provider, no sorter, and no * filters. * * @param table * the table control */ public TableViewer(Table table) { this.table = table; hookControl(table); } public Control getControl() { return table; } /** * Returns this table viewer's table control. * * @return the table control */ public Table getTable() { return table; } protected ColumnViewerEditor createViewerEditor() { return new TableViewerEditor(this, null, new ColumnViewerEditorActivationStrategy(this), ColumnViewerEditor.DEFAULT); } /** *

* Sets a new selection for this viewer and optionally makes it visible. The * TableViewer implementation of this method is inefficient for the * ILazyContentProvider as lookup is done by indices rather than elements * and may require population of the entire table in worse case. *

*

* Use Table#setSelection(int[] indices) and Table#showSelection() if you * wish to set selection more efficiently when using a ILazyContentProvider. *

* * @param selection * the new selection * @param reveal * true if the selection is to be made visible, and * false otherwise * @see Table#setSelection(int[]) * @see Table#showSelection() */ public void setSelection(ISelection selection, boolean reveal) { super.setSelection(selection, reveal); } protected ViewerRow getViewerRowFromItem(Widget item) { if( cachedRow == null ) { cachedRow = new TableViewerRow((TableItem) item); } else { cachedRow.setItem((TableItem) item); } return cachedRow; } /** * Create a new row with style at index * * @param style * @param rowIndex * @return ViewerRow * @since 1.0 */ protected ViewerRow internalCreateNewRowPart(int style, int rowIndex) { TableItem item; if (rowIndex >= 0) { item = new TableItem(table, style, rowIndex); } else { item = new TableItem(table, style); } return getViewerRowFromItem(item); } protected Item getItemAt(Point p) { TableItem[] selection = table.getSelection(); if( selection.length == 1 ) { int columnCount = table.getColumnCount(); for( int i = 0; i < columnCount; i++ ) { if( selection[0].getBounds(i).contains(p) ) { return selection[0]; } } } return table.getItem(p); } // Methods to provide widget independency protected int doGetItemCount() { return table.getItemCount(); } protected int doIndexOf(Item item) { return table.indexOf((TableItem)item); } protected void doSetItemCount(int count) { table.setItemCount(count); } protected Item[] doGetItems() { return table.getItems(); } protected int doGetColumnCount() { return table.getColumnCount(); } protected Widget doGetColumn(int index) { return table.getColumn(index); } protected Item doGetItem(int index) { return table.getItem(index); } protected Item[] doGetSelection() { return table.getSelection(); } protected int[] doGetSelectionIndices() { return table.getSelectionIndices(); } protected void doClearAll() { table.clearAll(); } protected void doResetItem(Item item) { TableItem tableItem = (TableItem) item; int columnCount = Math.max(1, table.getColumnCount()); for (int i = 0; i < columnCount; i++) { tableItem.setText(i, ""); //$NON-NLS-1$ if (tableItem.getImage(i) != null) { tableItem.setImage(i, null); } } } protected void doRemove(int start, int end) { table.remove(start, end); } protected void doRemoveAll() { table.removeAll(); } protected void doRemove(int[] indices) { table.remove(indices); } protected void doShowItem(Item item) { table.showItem((TableItem)item); } protected void doDeselectAll() { table.deselectAll(); } protected void doSetSelection(Item[] items) { Assert.isNotNull(items, "Items-Array can not be null"); //$NON-NLS-1$ TableItem[] t = new TableItem[items.length]; System.arraycopy(items, 0, t, 0, t.length); table.setSelection(t); } protected void doShowSelection() { table.showSelection(); } protected void doSetSelection(int[] indices) { table.setSelection(indices); } protected void doClear(int index) { table.clear(index); } protected void doSelect(int[] indices) { table.select(indices); } /** * Refreshes this viewer starting with the given element. Labels are updated * as described in refresh(boolean updateLabels). The methods * attempts to preserve the selection. *

* Unlike the update methods, this handles structural changes * to the given element (e.g. addition or removal of children). If only the * given element needs updating, it is more efficient to use the * update methods. *

* *

* Subclasses who can provide this feature can open this method for the * public *

* * @param element * the element * @param updateLabels * true to update labels for existing elements, * false to only update labels as needed, assuming that labels * for existing elements are unchanged. * @param reveal * true to make the preserved selection visible afterwards * * @since 1.0 */ public void refresh(final Object element, final boolean updateLabels, boolean reveal) { if (checkBusy()) return; if( isCellEditorActive() ) { cancelEditing(); } preservingSelection(new Runnable() { public void run() { internalRefresh(element, updateLabels); } }, reveal); } /** * Refreshes this viewer with information freshly obtained from this * viewer's model. If updateLabels is true then * labels for otherwise unaffected elements are updated as well. Otherwise, * it assumes labels for existing elements are unchanged, and labels are * only obtained as needed (for example, for new elements). *

* Calling refresh(true) has the same effect as * refresh(). *

* Note that the implementation may still obtain labels for existing * elements even if updateLabels is false. The intent is simply * to allow optimization where possible. * * @param updateLabels * true to update labels for existing elements, * false to only update labels as needed, assuming that labels * for existing elements are unchanged. * @param reveal * true to make the preserved selection visible afterwards * * @since 1.0 */ public void refresh(boolean updateLabels, boolean reveal) { refresh(getRoot(), updateLabels, reveal); } /* (non-Javadoc) * @see org.eclipse.jface.viewers.AbstractTableViewer#remove(java.lang.Object[]) */ public void remove(Object[] elements) { assertElementsNotNull(elements); if (checkBusy()) return; if (elements.length == 0) { return; } // deselect any items that are being removed, see bug 97786 boolean deselectedItems = false; Object elementToBeRemoved = null; CustomHashtable elementsToBeRemoved = null; if (elements.length == 1) { elementToBeRemoved = elements[0]; } else { elementsToBeRemoved = new CustomHashtable(getComparer()); for (int i = 0; i < elements.length; i++) { Object element = elements[i]; elementsToBeRemoved.put(element, element); } } int[] selectionIndices = doGetSelectionIndices(); for (int i = 0; i < selectionIndices.length; i++) { int index = selectionIndices[i]; Item item = doGetItem(index); Object data = item.getData(); if (data != null) { if ((elementsToBeRemoved != null && elementsToBeRemoved .containsKey(data)) || equals(elementToBeRemoved, data)) { table.deselect(index); deselectedItems = true; } } } super.remove(elements); if (deselectedItems) { ISelection sel = getSelection(); updateSelection(sel); firePostSelectionChanged(new SelectionChangedEvent(this, sel)); } } protected Widget doFindItem(Object element) { IContentProvider contentProvider = getContentProvider(); if (contentProvider instanceof IIndexableLazyContentProvider) { IIndexableLazyContentProvider indexable = (IIndexableLazyContentProvider) contentProvider; int idx = indexable.findElement(element); if (idx != -1) { return doGetItem(idx); } return null; } return super.doFindItem(element); } }





© 2015 - 2024 Weber Informatics LLC | Privacy Policy