public abstract class ColumnViewer extends StructuredViewer
ColumnViewer
should implement a matching concrete subclass of ViewerColumn
.
This class is not intended to be subclassed outside of the JFace
viewers framework.StructuredViewer.ColorAndFontCollector, StructuredViewer.ColorAndFontCollectorWithProviders
WIDGET_DATA_KEY
Constructor and Description |
---|
ColumnViewer()
Create a new instance of the receiver.
|
Modifier and Type | Method and Description |
---|---|
protected void |
applyEditorValue()
Apply the value of the active cell editor if one is active.
|
void |
cancelEditing()
Cancels a currently active cell editor if one is active.
|
protected boolean |
checkBusy()
Checks if this viewer is currently busy, logging a warning and returning
true if it is busy. |
protected abstract ColumnViewerEditor |
createViewerEditor()
Creates the viewer editor used for editing cell contents.
|
protected abstract int |
doGetColumnCount()
Returns the number of columns contained in the receiver.
|
void |
editElement(Object element,
int column)
Starts editing the given element at the given column index.
|
ViewerCell |
getCell(Point point)
Returns the viewer cell at the given widget-relative coordinates, or
null if there is no cell at that location |
CellEditor[] |
getCellEditors()
Return the CellEditors for the receiver, or
null if no cell
editors are set. |
ICellModifier |
getCellModifier()
Returns the cell modifier of this viewer, or
null if none
has been set. |
Object[] |
getColumnProperties()
Returns the column properties of this table viewer.
|
ColumnViewerEditor |
getColumnViewerEditor() |
protected abstract Widget |
getColumnViewerOwner(int columnIndex)
Returns the column widget at the given column index.
|
protected Item |
getItem(int x,
int y)
Returns the item at the given display-relative coordinates, or
null if there is no item at that location or
the underlying SWT-Control is not made up of Item
(e.g ListViewer )
The default implementation of this method returns null . |
protected abstract Item |
getItemAt(Point point)
Returns the
Item at the given widget-relative coordinates, or
null if there is no item at the given coordinates. |
CellLabelProvider |
getLabelProvider(int columnIndex)
Returns the label provider associated with the column at the given index
or
null if no column with this index is known. |
protected Object[] |
getRawChildren(Object parent)
Returns the children of the given parent without sorting and filtering
them.
|
protected ViewerRow |
getViewerRow(Point point)
Returns the viewer row at the given widget-relative coordinates.
|
protected abstract ViewerRow |
getViewerRowFromItem(Widget item)
Returns a
ViewerRow associated with the given row widget. |
protected void |
handleDispose(DisposeEvent event)
Handles a dispose event on this viewer's control.
|
protected void |
hookControl(Control control)
Adds event listener hooks to the given control.
|
protected void |
hookEditingSupport(Control control)
Hook up the editing support.
|
boolean |
isBusy()
Returns
true if this viewer is currently busy processing a
refresh, add, remove, insert, replace, setItemCount, expandToLevel,
update, setExpandedElements, or similar method that may make calls to
client code. |
boolean |
isCellEditorActive()
Returns whether there is an active cell editor.
|
void |
refresh(Object element)
Refreshes this viewer starting with the given element.
|
void |
refresh(Object element,
boolean updateLabels)
Refreshes this viewer starting with the given element.
|
protected void |
setBusy(boolean busy)
Sets the busy state of this viewer.
|
void |
setCellEditors(CellEditor[] editors)
Sets the cell editors of this column viewer.
|
void |
setCellModifier(ICellModifier modifier)
Sets the cell modifier for this column viewer.
|
void |
setColumnProperties(String[] columnProperties)
Sets the column properties of this column viewer.
|
void |
setColumnViewerEditor(ColumnViewerEditor columnViewerEditor) |
void |
setLabelProvider(IBaseLabelProvider labelProvider)
The column viewer implementation of this
Viewer framework
method ensures that the given label provider is an instance of
ITableLabelProvider , ILabelProvider , or
CellLabelProvider . |
protected void |
triggerEditorActivationEvent(ColumnViewerEditorActivationEvent event)
Invoking this method fires an editor activation event which tries to
enable the editor but before this event is passed to
ColumnViewerEditorActivationStrategy to see if this event should really
trigger editor activation |
void |
update(Object element,
String[] properties)
Updates the given element's presentation when one or more of its
properties changes.
|
addDoubleClickListener, addDragSupport, addDropSupport, addFilter, addOpenListener, addPostSelectionChangedListener, assertContentProviderType, assertElementsNotNull, associate, buildLabel, disassociate, doFindInputItem, doFindItem, doUpdateItem, equals, filter, findItem, findItems, fireDoubleClick, fireOpen, firePostSelectionChanged, getColorAndFontCollector, getComparator, getComparer, getFilteredChildren, getFilters, getRoot, getSelection, getSelectionFromWidget, getSortedChildren, getSorter, handleDoubleSelect, handleInvalidSelection, handleLabelProviderChanged, handleOpen, handlePostSelect, handleSelect, hasFilters, internalRefresh, internalRefresh, internalUpdate, mapElement, needsRefilter, preservingSelection, refresh, refresh, refreshItem, removeDoubleClickListener, removeFilter, removeOpenListener, removePostSelectionChangedListener, resetFilters, reveal, setComparator, setComparer, setContentProvider, setFilters, setInput, setSelection, setSelectionToWidget, setSelectionToWidget, setSorter, setUseHashlookup, testFindItem, testFindItems, unmapAllElements, unmapElement, unmapElement, update, updateItem, updateSelection, usingElementMap
getContentProvider, getInput, getLabelProvider, labelProviderChanged
addHelpListener, addSelectionChangedListener, fireHelpRequested, fireSelectionChanged, getControl, getData, handleHelpRequest, inputChanged, removeHelpListener, removeSelectionChangedListener, scrollDown, scrollUp, setData, setSelection
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
addSelectionChangedListener, removeSelectionChangedListener, setSelection
protected void hookControl(Control control)
ContentViewer
All subclasses must call this method when their control is first established.
The ContentViewer
implementation of this method hooks
dispose events for the given control.
Subclasses may override if they need to add other control hooks;
however, super.hookControl
must be invoked.
hookControl
in class StructuredViewer
control
- the controlprotected void hookEditingSupport(Control control)
control
- the control you want to hook onprotected abstract ColumnViewerEditor createViewerEditor()
null
if this viewer does not support
editing cell contents.public ViewerCell getCell(Point point)
null
if there is no cell at that locationpoint
- the widget-relative coordinatesnull
if no cell is found at the given
pointprotected ViewerRow getViewerRow(Point point)
point
- the widget-relative coordinates of the viewer rownull
if no row is found at the
given coordinatesprotected abstract ViewerRow getViewerRowFromItem(Widget item)
ViewerRow
associated with the given row widget.
Implementations may re-use the same instance for different row widgets;
callers can only use the viewer row locally and until the next call to
this method.item
- the row widgetprotected abstract Widget getColumnViewerOwner(int columnIndex)
columnIndex
- the column indexprotected abstract Item getItemAt(Point point)
Item
at the given widget-relative coordinates, or
null
if there is no item at the given coordinates.point
- the widget-relative coordinatesItem
at the coordinates or null
if there
is no item at the given coordinatesprotected Item getItem(int x, int y)
StructuredViewer
null
if there is no item at that location or
the underlying SWT-Control is not made up of Item
(e.g ListViewer
)
The default implementation of this method returns null
.
getItem
in class StructuredViewer
x
- horizontal coordinatey
- vertical coordinatenull
if there is no item at the given
coordinatespublic void setLabelProvider(IBaseLabelProvider labelProvider)
Viewer
framework
method ensures that the given label provider is an instance of
ITableLabelProvider
, ILabelProvider
, or
CellLabelProvider
.
If the label provider is an ITableLabelProvider
, then it
provides a separate label text and image for each column. Implementers of
ITableLabelProvider
may also implement ITableColorProvider
and/or ITableFontProvider
to provide colors
and/or fonts.
If the label provider is an ILabelProvider
, then it
provides only the label text and image for the first column, and any
remaining columns are blank. Implementers of ILabelProvider
may also implement IColorProvider
and/or IFontProvider
to
provide colors and/or fonts.
setLabelProvider
in class StructuredViewer
labelProvider
- the label provider, or null
if nonepublic void cancelEditing()
protected void applyEditorValue()
public void editElement(Object element, int column)
element
- the model elementcolumn
- the column indexpublic CellEditor[] getCellEditors()
null
if no cell
editors are set.
Since 3.3, an alternative API is available, see ViewerColumn.setEditingSupport(EditingSupport)
for a more flexible way
of editing values in a column viewer.
ViewerColumn.setEditingSupport(EditingSupport)
,
EditingSupport
public ICellModifier getCellModifier()
null
if none
has been set.
Since 3.3, an alternative API is available, see ViewerColumn.setEditingSupport(EditingSupport)
for a more flexible way
of editing values in a column viewer.
null
ViewerColumn.setEditingSupport(EditingSupport)
,
EditingSupport
public Object[] getColumnProperties()
Since 3.3, an alternative API is available, see ViewerColumn.setEditingSupport(EditingSupport)
for a more flexible way
of editing values in a column viewer.
ViewerColumn.setEditingSupport(EditingSupport)
,
EditingSupport
public boolean isCellEditorActive()
Since 3.3, an alternative API is available, see ViewerColumn.setEditingSupport(EditingSupport)
for a more flexible way
of editing values in a column viewer.
true
if there is an active cell editor, and
false
otherwiseViewerColumn.setEditingSupport(EditingSupport)
,
EditingSupport
public void refresh(Object element)
StructuredViewer
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.
refresh
in class StructuredViewer
element
- the elementpublic void refresh(Object element, boolean updateLabels)
StructuredViewer
refresh(boolean updateLabels)
.
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.
refresh
in class StructuredViewer
element
- the elementupdateLabels
- true
to update labels for existing elements,
false
to only update labels as needed, assuming
that labels for existing elements are unchanged.public void update(Object element, String[] properties)
StructuredViewer
This does not handle structural changes (e.g. addition or removal of
elements), and does not update any other related elements (e.g. child
elements). To handle structural changes, use the refresh
methods instead.
This should be called when an element has changed in the model, in order to have the viewer accurately reflect the model. This method only affects the viewer, not the model.
Specifying which properties are affected may allow the viewer to optimize
the update. For example, if the label provider is not affected by changes
to any of these properties, an update may not actually be required.
Specifying properties
as null
forces a full
update of the element.
If the viewer has a sorter which is affected by a change to one of the
properties, the element's position is updated to maintain the sort order.
Note that resorting may not happen if properties
is
null
.
If the viewer has a filter which is affected by a change to one of the
properties, the element may appear or disappear if the change affects
whether or not the element is filtered out. Note that filtering may not
happen if properties
is null
.
update
in class StructuredViewer
element
- the elementproperties
- the properties that have changed, or null
to
indicate unknownpublic void setCellEditors(CellEditor[] editors)
Since 3.3, an alternative API is available, see ViewerColumn.setEditingSupport(EditingSupport)
for a more flexible way
of editing values in a column viewer.
Users setting up an editable TreeViewer
or TableViewer
with more than 1 column have
to pass the SWT.FULL_SELECTION style bit
editors
- the list of cell editorsViewerColumn.setEditingSupport(EditingSupport)
,
EditingSupport
public void setCellModifier(ICellModifier modifier)
Since 3.3, an alternative API is available, see ViewerColumn.setEditingSupport(EditingSupport)
for a more flexible way
of editing values in a column viewer.
Users setting up an editable TreeViewer
or TableViewer
with more than 1 column have
to pass the SWT.FULL_SELECTION style bit
modifier
- the cell modifierViewerColumn.setEditingSupport(EditingSupport)
,
EditingSupport
public void setColumnProperties(String[] columnProperties)
Since 3.3, an alternative API is available, see ViewerColumn.setEditingSupport(EditingSupport)
for a more flexible way
of editing values in a column viewer.
Users setting up an editable TreeViewer
or TableViewer
with more than 1 column have
to pass the SWT.FULL_SELECTION style bit
columnProperties
- the list of column propertiesViewerColumn.setEditingSupport(EditingSupport)
,
EditingSupport
protected abstract int doGetColumnCount()
public CellLabelProvider getLabelProvider(int columnIndex)
null
if no column with this index is known.columnIndex
- the column indexnull
if no column with this index is knownprotected void handleDispose(DisposeEvent event)
ContentViewer
The ContentViewer
implementation of this method disposes of this
viewer's label provider and content provider (if it has one).
Subclasses should override this method to perform any additional
cleanup of resources; however, overriding methods must invoke
super.handleDispose
.
handleDispose
in class StructuredViewer
event
- a dispose eventprotected void triggerEditorActivationEvent(ColumnViewerEditorActivationEvent event)
ColumnViewerEditorActivationStrategy
to see if this event should really
trigger editor activationevent
- the activation eventpublic void setColumnViewerEditor(ColumnViewerEditor columnViewerEditor)
columnViewerEditor
- the new column viewer editorpublic ColumnViewerEditor getColumnViewerEditor()
protected Object[] getRawChildren(Object parent)
StructuredViewer
Returns an empty array if the given parent is null
.
getRawChildren
in class StructuredViewer
parent
- the parent elementprotected boolean checkBusy()
true
if it is busy. A column viewer is busy when it is
processing a refresh, add, remove, insert, replace, setItemCount,
expandToLevel, update, setExpandedElements, or similar method that may
make calls to client code. Column viewers are not designed to handle
reentrant calls while they are busy. The method returns true
if the viewer is busy. It is recommended that this method be used by
subclasses to determine whether the viewer is busy to return early from
state-changing methods.
This method is not intended to be overridden by subclasses.
true
if the viewer is busy.protected void setBusy(boolean busy)
try
...finally
as follows to ensure that the busy flag is reset
to its original value:
boolean oldBusy = isBusy(); setBusy(true); try { // do work } finally { setBusy(oldBusy); }
This method is not intended to be overridden by subclasses.
busy
- the new value of the busy flagpublic boolean isBusy()
true
if this viewer is currently busy processing a
refresh, add, remove, insert, replace, setItemCount, expandToLevel,
update, setExpandedElements, or similar method that may make calls to
client code. Column viewers are not designed to handle reentrant calls
while they are busy. It is recommended that clients avoid using this
method if they can ensure by other means that they will not make
reentrant calls to methods like the ones listed above. See bug 184991 for
background discussion.
This method is not intended to be overridden by subclasses.
Copyright (c) 2000, 2013 Eclipse Contributors and others. All rights reserved.Guidelines for using Eclipse APIs.