projects/dwt-addons: dwtx/jface/viewers/TableViewer.d comparison

comparison dwtx/jface/viewers/TableViewer.d @ 70:46a6e0e6ccd4

Merge with d-fied sources of 3.4M7

author	Frank Benoit <benoit@tionex.de>
date	Thu, 22 May 2008 01:36:46 +0200
parents	ea8ff534f622
children	7ffeace6c47f

comparison

equal deleted inserted replaced

-:07b9d96fd764
+:46a6e0e6ccd4
 import dwtx.jface.viewers.ColumnViewerEditor;
 import dwtx.jface.viewers.ISelection;
 import dwtx.jface.viewers.ViewerRow;
 import dwtx.jface.viewers.TableViewerEditor;
 import dwtx.jface.viewers.ColumnViewerEditorActivationStrategy;
 import dwt.DWT;
 import dwt.graphics.Point;
 import dwt.widgets.Composite;
 import dwt.widgets.Control;
 import dwt.widgets.Item;
 * configured with a domain-specific content provider, table label provider,
 * element filter (optional), and element sorter (optional).
 * </p>
 * <p>
 * Label providers for table viewers must implement either the
-* <code>ITableLabelProvider</code> or the <code>ILabelProvider</code>
+* <code>ITableLabelProvider</code> or the <code>ILabelProvider</code> interface
-* interface (see <code>TableViewer.setLabelProvider</code> for more details).
+* (see <code>TableViewer.setLabelProvider</code> for more details).
 * </p>
 * <p>
 * As of 3.1 the TableViewer now supports the DWT.VIRTUAL flag. If the
-* underlying table is DWT.VIRTUAL, the content provider may implement
+* underlying table is DWT.VIRTUAL, the content provider may implement {@link
-* {@link ILazyContentProvider} instead of {@link IStructuredContentProvider}.
+* ILazyContentProvider} instead of {@link IStructuredContentProvider} . Note
-* Note that in this case, the viewer does not support sorting or filtering.
+* that in this case, the viewer does not support sorting or filtering. Also
-* Also note that in this case, the Widget based APIs may return null if the
+* note that in this case, the Widget based APIs may return null if the element
-* element is not specified or not created yet.
+* is not specified or not created yet.
 * </p>
 * <p>
 * Users of DWT.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 DWT.VIRTUAL.
 * </p>
-*
+* <p>
+* Users setting up an editable table with more than 1 column <b>have</b> to pass the
+* DWT.FULL_SELECTION style bit
+* </p>
+*
 * @see DWT#VIRTUAL
 * @see #doFindItem(Object)
 * @see #internalRefresh(Object, bool)
 */
 public class TableViewer : AbstractTableViewer {
 * Creates a table viewer on a newly-created table control under the given
 * parent. The table control is created using the DWT style bits
 * <code>MULTI, H_SCROLL, V_SCROLL,</code> and <code>BORDER</code>. 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
+*      the parent control
 */
 public this(Composite parent) {
 this(parent, DWT.MULTI | DWT.H_SCROLL | DWT.V_SCROLL | DWT.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
+*      the parent control
 * @param style
-*            DWT style bits
+*      DWT style bits
 */
 public this(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
+*      the table control
 */
 public this(Table table) {
 this.table = table;
 hookControl(table);
 }
 return table;
 }
 /**
 * Returns this table viewer's table control.
 *
 * @return the table control
 */
 public Table getTable() {
 return table;
 }
 protected override ColumnViewerEditor createViewerEditor() {
-return new TableViewerEditor(this,null,new ColumnViewerEditorActivationStrategy(this),ColumnViewerEditor.DEFAULT);
+return new TableViewerEditor(this, null,
+new ColumnViewerEditorActivationStrategy(this),
+ColumnViewerEditor.DEFAULT);
 }
 /**
 * <p>
 * Sets a new selection for this viewer and optionally makes it visible. The
 * </p>
 * <p>
 * Use Table#setSelection(int[] indices) and Table#showSelection() if you
 * wish to set selection more efficiently when using a ILazyContentProvider.
 * </p>
 *
 * @param selection
-*            the new selection
+*      the new selection
 * @param reveal
-*            <code>true</code> if the selection is to be made visible,
+*      <code>true</code> if the selection is to be made visible, and
-*            and <code>false</code> otherwise
+*      <code>false</code> otherwise
 * @see Table#setSelection(int[])
 * @see Table#showSelection()
 */
 public override void setSelection(ISelection selection, bool reveal) {
 super.setSelection(selection, reveal);
 }
 protected override ViewerRow getViewerRowFromItem(Widget item) {
-if( cachedRow is null ) {
+if (cachedRow is null) {
 cachedRow = new TableViewerRow(cast(TableItem) item);
 } else {
 cachedRow.setItem(cast(TableItem) item);
 }
 return cachedRow;
 }
 /**
 * Create a new row with style at index
 *
 * @param style
 * @param rowIndex
 * @return ViewerRow
 * @since 3.3
 */
 }
 protected override Item getItemAt(Point p) {
 TableItem[] selection = table.getSelection();
-if( selection.length is 1 ) {
+if (selection.length is 1) {
 int columnCount = table.getColumnCount();
-for( int i = 0; i < columnCount; i++ ) {
+for (int i = 0; i < columnCount; i++) {
-if( selection[0].getBounds(i).contains(p) ) {
+if (selection[0].getBounds(i).contains(p)) {
 return selection[0];
 }
 }
 }
 protected override int doGetItemCount() {
 return table.getItemCount();
 }
 protected override int doIndexOf(Item item) {
-return table.indexOf(cast(TableItem)item);
+return table.indexOf(cast(TableItem) item);
 }
 protected override void doSetItemCount(int count) {
 table.setItemCount(count);
 }
 protected override void doRemove(int[] indices) {
 table.remove(indices);
 }
 protected override void doShowItem(Item item) {
-table.showItem(cast(TableItem)item);
+table.showItem(cast(TableItem) item);
 }
 protected override void doDeselectAll() {
 table.deselectAll();
 }
 table.select(indices);
 }
 /**
 * Refreshes this viewer starting with the given element. Labels are updated
-* as described in <code>refresh(bool updateLabels)</code>. The
+* as described in <code>refresh(bool updateLabels)</code>. The methods
-* methods attempts to preserve the selection.
+* attempts to preserve the selection.
 * <p>
 * Unlike the <code>update</code> 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
 * <code>update</code> methods.
 * </p>
 *
 * <p>
 * Subclasses who can provide this feature can open this method for the
 * public
 * </p>
 *
 * @param element
-*            the element
+*      the element
 * @param updateLabels
-*            <code>true</code> to update labels for existing elements,
+*      <code>true</code> to update labels for existing elements,
-*            <code>false</code> to only update labels as needed, assuming
+*      <code>false</code> to only update labels as needed, assuming that labels
-*            that labels for existing elements are unchanged.
+*      for existing elements are unchanged.
 * @param reveal
-*            <code>true</code> to make the preserved selection visible
+*      <code>true</code> to make the preserved selection visible afterwards
-*            afterwards
+*
-*
 * @since 3.3
 */
 public void refresh(Object element, bool updateLabels,
 bool reveal) {
-if (isBusy())
+if (checkBusy())
 return;
-if( isCellEditorActive() ) {
+if (isCellEditorActive()) {
 cancelEditing();
 }
 preservingSelection(new class(element,updateLabels) Runnable {
 Object element_;
 }, reveal);
 }
 /**
 * Refreshes this viewer with information freshly obtained from this
-* viewer's model. If <code>updateLabels</code> is <code>true</code>
+* viewer's model. If <code>updateLabels</code> is <code>true</code> then
-* then labels for otherwise unaffected elements are updated as well.
+* labels for otherwise unaffected elements are updated as well. Otherwise,
-* Otherwise, it assumes labels for existing elements are unchanged, and
+* it assumes labels for existing elements are unchanged, and labels are
-* labels are only obtained as needed (for example, for new elements).
+* only obtained as needed (for example, for new elements).
 * <p>
 * Calling <code>refresh(true)</code> has the same effect as
 * <code>refresh()</code>.
 * <p>
 * Note that the implementation may still obtain labels for existing
-* elements even if <code>updateLabels</code> is false. The intent is
+* elements even if <code>updateLabels</code> is false. The intent is simply
-* simply to allow optimization where possible.
+* to allow optimization where possible.
 *
 * @param updateLabels
-*            <code>true</code> to update labels for existing elements,
+*      <code>true</code> to update labels for existing elements,
-*            <code>false</code> to only update labels as needed, assuming
+*      <code>false</code> to only update labels as needed, assuming that labels
-*            that labels for existing elements are unchanged.
+*      for existing elements are unchanged.
 * @param reveal
-*            <code>true</code> to make the preserved selection visible
+*      <code>true</code> to make the preserved selection visible afterwards
-*            afterwards
+*
-*
 * @since 3.3
 */
 public void refresh(bool updateLabels, bool reveal) {
 refresh(getRoot(), updateLabels, reveal);
 }

Mercurial > projects > dwt-addons

comparison dwtx/jface/viewers/TableViewer.d @ 70:46a6e0e6ccd4