| /******************************************************************************* |
| * Copyright (c) 2000, 2016 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.swt.custom; |
| |
| |
| import org.eclipse.swt.*; |
| import org.eclipse.swt.events.*; |
| import org.eclipse.swt.graphics.*; |
| import org.eclipse.swt.widgets.*; |
| /** |
| * |
| * A TableTreeEditor is a manager for a Control that appears above a cell in a TableTree |
| * and tracks with the moving and resizing of that cell. It can be used to display a |
| * text widget above a cell in a TableTree so that the user can edit the contents of |
| * that cell. It can also be used to display a button that can launch a dialog for |
| * modifying the contents of the associated cell. |
| * |
| * <p> Here is an example of using a TableTreeEditor: |
| * <code><pre> |
| * final TableTree tableTree = new TableTree(shell, SWT.FULL_SELECTION | SWT.HIDE_SELECTION); |
| * final Table table = tableTree.getTable(); |
| * TableColumn column1 = new TableColumn(table, SWT.NONE); |
| * TableColumn column2 = new TableColumn(table, SWT.NONE); |
| * for (int i = 0; i < 10; i++) { |
| * TableTreeItem item = new TableTreeItem(tableTree, SWT.NONE); |
| * item.setText(0, "item " + i); |
| * item.setText(1, "edit this value"); |
| * for (int j = 0; j < 3; j++) { |
| * TableTreeItem subitem = new TableTreeItem(item, SWT.NONE); |
| * subitem.setText(0, "subitem " + i + " " + j); |
| * subitem.setText(1, "edit this value"); |
| * } |
| * } |
| * column1.setWidth(100); |
| * column2.pack(); |
| * |
| * final TableTreeEditor editor = new TableTreeEditor(tableTree); |
| * //The editor must have the same size as the cell and must |
| * //not be any smaller than 50 pixels. |
| * editor.horizontalAlignment = SWT.LEFT; |
| * editor.grabHorizontal = true; |
| * editor.minimumWidth = 50; |
| * // editing the second column |
| * final int EDITABLECOLUMN = 1; |
| * |
| * tableTree.addSelectionListener(new SelectionAdapter() { |
| * public void widgetSelected(SelectionEvent e) { |
| * // Clean up any previous editor control |
| * Control oldEditor = editor.getEditor(); |
| * if (oldEditor != null) oldEditor.dispose(); |
| * |
| * // Identify the selected row |
| * TableTreeItem item = (TableTreeItem)e.item; |
| * if (item == null) return; |
| * |
| * // The control that will be the editor must be a child of the Table |
| * Text newEditor = new Text(table, SWT.NONE); |
| * newEditor.setText(item.getText(EDITABLECOLUMN)); |
| * newEditor.addModifyListener(new ModifyListener() { |
| * public void modifyText(ModifyEvent e) { |
| * Text text = (Text)editor.getEditor(); |
| * editor.getItem().setText(EDITABLECOLUMN, text.getText()); |
| * } |
| * }); |
| * newEditor.selectAll(); |
| * newEditor.setFocus(); |
| * editor.setEditor(newEditor, item, EDITABLECOLUMN); |
| * } |
| * }); |
| * </pre></code> |
| * |
| * @deprecated As of 3.1 use TreeEditor with Tree, TreeItem and TreeColumn |
| * @noreference This API will be deleted in a future release. See bug 475833 for details. |
| * @noextend This API will be deleted in a future release. See bug 475833 for details. |
| */ |
| @Deprecated |
| public class TableTreeEditor extends ControlEditor { |
| |
| TableTree tableTree; |
| TableTreeItem item; |
| int column = -1; |
| ControlListener columnListener; |
| TreeListener treeListener; |
| /** |
| * Creates a TableTreeEditor for the specified TableTree. |
| * |
| * @param tableTree the TableTree Control above which this editor will be displayed |
| * |
| */ |
| public TableTreeEditor (TableTree tableTree) { |
| super(tableTree.getTable()); |
| this.tableTree = tableTree; |
| |
| treeListener = new TreeListener () { |
| final Runnable runnable = () -> { |
| if (editor == null || editor.isDisposed()) return; |
| if (TableTreeEditor.this.tableTree.isDisposed()) return; |
| layout(); |
| editor.setVisible(true); |
| }; |
| @Override |
| public void treeCollapsed(TreeEvent e) { |
| if (editor == null || editor.isDisposed ()) return; |
| editor.setVisible(false); |
| e.display.asyncExec(runnable); |
| } |
| @Override |
| public void treeExpanded(TreeEvent e) { |
| if (editor == null || editor.isDisposed ()) return; |
| editor.setVisible(false); |
| e.display.asyncExec(runnable); |
| } |
| }; |
| tableTree.addTreeListener(treeListener); |
| |
| columnListener = new ControlListener() { |
| @Override |
| public void controlMoved(ControlEvent e){ |
| layout (); |
| } |
| @Override |
| public void controlResized(ControlEvent e){ |
| layout (); |
| } |
| }; |
| |
| // To be consistent with older versions of SWT, grabVertical defaults to true |
| grabVertical = true; |
| } |
| @Override |
| Rectangle computeBounds () { |
| if (item == null || column == -1 || item.isDisposed() || item.tableItem == null) return new Rectangle(0, 0, 0, 0); |
| Rectangle cell = item.getBounds(column); |
| Rectangle area = tableTree.getClientArea(); |
| if (cell.x < area.x + area.width) { |
| if (cell.x + cell.width > area.x + area.width) { |
| cell.width = area.x + area.width - cell.x; |
| } |
| } |
| Rectangle editorRect = new Rectangle(cell.x, cell.y, minimumWidth, minimumHeight); |
| |
| if (grabHorizontal) { |
| editorRect.width = Math.max(cell.width, minimumWidth); |
| } |
| |
| if (grabVertical) { |
| editorRect.height = Math.max(cell.height, minimumHeight); |
| } |
| |
| if (horizontalAlignment == SWT.RIGHT) { |
| editorRect.x += cell.width - editorRect.width; |
| } else if (horizontalAlignment == SWT.LEFT) { |
| // do nothing - cell.x is the right answer |
| } else { // default is CENTER |
| editorRect.x += (cell.width - editorRect.width)/2; |
| } |
| |
| if (verticalAlignment == SWT.BOTTOM) { |
| editorRect.y += cell.height - editorRect.height; |
| } else if (verticalAlignment == SWT.TOP) { |
| // do nothing - cell.y is the right answer |
| } else { // default is CENTER |
| editorRect.y += (cell.height - editorRect.height)/2; |
| } |
| return editorRect; |
| } |
| /** |
| * Removes all associations between the TableTreeEditor and the cell in the table tree. The |
| * TableTree and the editor Control are <b>not</b> disposed. |
| */ |
| @Override |
| public void dispose () { |
| if (tableTree != null && !tableTree.isDisposed()) { |
| Table table = tableTree.getTable(); |
| if (table != null && !table.isDisposed()) { |
| if (this.column > -1 && this.column < table.getColumnCount()){ |
| TableColumn tableColumn = table.getColumn(this.column); |
| tableColumn.removeControlListener(columnListener); |
| } |
| } |
| if (treeListener != null) tableTree.removeTreeListener(treeListener); |
| } |
| treeListener = null; |
| columnListener = null; |
| tableTree = null; |
| item = null; |
| column = -1; |
| super.dispose(); |
| } |
| /** |
| * Returns the zero based index of the column of the cell being tracked by this editor. |
| * |
| * @return the zero based index of the column of the cell being tracked by this editor |
| */ |
| public int getColumn () { |
| return column; |
| } |
| /** |
| * Returns the TableTreeItem for the row of the cell being tracked by this editor. |
| * |
| * @return the TableTreeItem for the row of the cell being tracked by this editor |
| */ |
| public TableTreeItem getItem () { |
| return item; |
| } |
| public void setColumn(int column) { |
| Table table = tableTree.getTable(); |
| int columnCount = table.getColumnCount(); |
| // Separately handle the case where the table has no TableColumns. |
| // In this situation, there is a single default column. |
| if (columnCount == 0) { |
| this.column = (column == 0) ? 0 : -1; |
| layout(); |
| return; |
| } |
| if (this.column > -1 && this.column < columnCount){ |
| TableColumn tableColumn = table.getColumn(this.column); |
| tableColumn.removeControlListener(columnListener); |
| this.column = -1; |
| } |
| |
| if (column < 0 || column >= table.getColumnCount()) return; |
| |
| this.column = column; |
| TableColumn tableColumn = table.getColumn(this.column); |
| tableColumn.addControlListener(columnListener); |
| layout(); |
| } |
| public void setItem (TableTreeItem item) { |
| this.item = item; |
| layout(); |
| } |
| |
| /** |
| * Specify the Control that is to be displayed and the cell in the table that it is to be positioned above. |
| * |
| * <p>Note: The Control provided as the editor <b>must</b> be created with its parent being the Table control |
| * specified in the TableEditor constructor. |
| * |
| * @param editor the Control that is displayed above the cell being edited |
| * @param item the TableItem for the row of the cell being tracked by this editor |
| * @param column the zero based index of the column of the cell being tracked by this editor |
| */ |
| public void setEditor (Control editor, TableTreeItem item, int column) { |
| setItem(item); |
| setColumn(column); |
| setEditor(editor); |
| } |
| @Override |
| public void layout () { |
| if (tableTree == null || tableTree.isDisposed()) return; |
| if (item == null || item.isDisposed()) return; |
| Table table = tableTree.getTable(); |
| int columnCount = table.getColumnCount(); |
| if (columnCount == 0 && column != 0) return; |
| if (columnCount > 0 && (column < 0 || column >= columnCount)) return; |
| super.layout(); |
| } |
| } |