org.eclipse.jface.viewers
Class StructuredViewer

java.lang.Object
  

org.eclipse.jface.viewers.Viewer
      

org.eclipse.jface.viewers.ContentViewer
          
org.eclipse.jface.viewers.StructuredViewer

All Implemented Interfaces:

IInputProvider, IInputSelectionProvider, IPostSelectionProvider, ISelectionProvider

Direct Known Subclasses:

AbstractListViewer, ColumnViewer

public abstract class StructuredViewer
extends 
ContentViewer
implements 
IPostSelectionProvider

Abstract base implementation for structure-oriented viewers (trees, lists, tables). Supports custom sorting, filtering, and rendering.

Any number of viewer filters can be added to this viewer (using addFilter). When the viewer receives an update, it asks each of its filters if it is out of date, and refilters elements as required.

See Also:

ViewerFilter, ViewerComparator

Nested Class Summary
protected  class	StructuredViewer.ColorAndFontCollector           The ColorAndFontCollector collects fonts and colors without a a color or font provider.
protected  class	StructuredViewer.ColorAndFontCollectorWithProviders           The ColorAndFontCollector is a helper class for viewers that have color and font support ad optionally decorators.

 

Field Summary

 

Fields inherited from class org.eclipse.jface.viewers. Viewer
WIDGET_DATA_KEY

 

Constructor Summary
protected	StructuredViewer ()           Creates a structured element viewer.

 

Method Summary
void	addDoubleClickListener ( IDoubleClickListener listener)           Adds a listener for double-clicks in this viewer.
void	addDragSupport (int operations, Transfer[] transferTypes, DragSourceListener listener)           Adds support for dragging items out of this viewer via a user drag-and-drop operation.
void	addDropSupport (int operations, Transfer[] transferTypes, DropTargetListener listener)           Adds support for dropping items into this viewer via a user drag-and-drop operation.
void	addFilter ( ViewerFilter filter)           Adds the given filter to this viewer, and triggers refiltering and resorting of the elements.
void	addOpenListener ( IOpenListener listener)           Adds a listener for selection-open in this viewer.
void	addPostSelectionChangedListener ( ISelectionChangedListener listener)           Adds a listener for post selection changes in this selection provider.
protected  void	assertContentProviderType ( IContentProvider provider)           Assert that the content provider is of one of the supported types.
protected  void	assertElementsNotNull ( Object[] elements)           Asserts that the given array of elements is itself non- null and contains no null elements.
protected  void	associate ( Object element, Item item)           Associates the given element with the given widget.
protected  void	buildLabel ( ViewerLabel updateLabel, Object element)           Build a label up for the element using the supplied label provider.
protected  void	disassociate ( Item item)           Disassociates the given SWT item from its corresponding element.
protected abstract   Widget	doFindInputItem ( Object element)           Returns the widget in this viewer's control which represents the given element if it is the viewer's input.
protected abstract   Widget	doFindItem ( Object element)           Returns the widget in this viewer's control which represent the given element.
protected abstract  void	doUpdateItem ( Widget item, Object element, boolean fullMap)           Copies the attributes of the given element into the given SWT item.
protected  boolean	equals ( Object elementA, Object elementB)           Compares two elements for equality.
protected   Object[]	filter ( Object[] elements)           Returns the result of running the given elements through the filters.
protected   Widget	findItem ( Object element)           Finds the widget which represents the given element.
protected   Widget[]	findItems ( Object element)           Finds the widgets which represent the given element.
protected  void	fireDoubleClick ( DoubleClickEvent event)           Notifies any double-click listeners that a double-click has been received.
protected  void	fireOpen ( OpenEvent event)           Notifies any open event listeners that a open event has been received.
protected  void	firePostSelectionChanged ( SelectionChangedEvent event)           Notifies any post selection listeners that a post selection event has been received.
protected   StructuredViewer.ColorAndFontCollector	getColorAndFontCollector ()           Get the ColorAndFontCollector for the receiver.
ViewerComparator	getComparator ()           Return this viewer's comparator used to sort elements.
IElementComparer	getComparer ()           Returns the comparer to use for comparing elements, or null if none has been set.
protected   Object[]	getFilteredChildren ( Object parent)           Returns the filtered array of children of the given element.
ViewerFilter[]	getFilters ()           Returns this viewer's filters.
protected   Item	getItem (int x, int y)           Deprecated. This method is deprecated in 3.3 in favor of ColumnViewer.getItemAt(org.eclipse.swt.graphics.Point). Viewers who are not subclasses of ColumnViewer should consider using a widget relative implementation like ColumnViewer.getItemAt(org.eclipse.swt.graphics.Point).
protected   Object[]	getRawChildren ( Object parent)           Returns the children of the given parent without sorting and filtering them.
protected   Object	getRoot ()           Returns the root element.
ISelection	getSelection ()           The StructuredViewer implementation of this method returns the result as an IStructuredSelection.
protected abstract   List	getSelectionFromWidget ()           Retrieves the selection, as a List, from the underlying widget.
protected   Object[]	getSortedChildren ( Object parent)           Returns the sorted and filtered set of children of the given element.
ViewerSorter	getSorter ()           Returns this viewer's sorter, or null if it does not have one.
protected  void	handleDispose ( DisposeEvent event)           Handles a dispose event on this viewer's control.
protected  void	handleDoubleSelect ( SelectionEvent event)           Handles a double-click select event from the widget.
protected  void	handleInvalidSelection ( ISelection invalidSelection, ISelection newSelection)           Handles an invalid selection.
protected  void	handleLabelProviderChanged ( LabelProviderChangedEvent event)           The StructuredViewer implementation of this ContentViewer method calls update if the event specifies that the label of a given element has changed, otherwise it calls super.
protected  void	handleOpen ( SelectionEvent event)           Handles an open event from the OpenStrategy.
protected  void	handlePostSelect ( SelectionEvent e)           Handles a post select event from the widget.
protected  void	handleSelect ( SelectionEvent event)           Handles a select event from the widget.
protected  boolean	hasFilters ()           Returns whether this viewer has any filters.
protected  void	hookControl ( Control control)           Adds event listener hooks to the given control.
protected abstract  void	internalRefresh ( Object element)           Refreshes this viewer starting at the given element.
protected  void	internalRefresh ( Object element, boolean updateLabels)           Refreshes this viewer starting at the given element.
protected  void	internalUpdate ( Widget widget, Object element, String[] properties)           Updates the given element's presentation when one or more of its properties changes.
protected  void	mapElement ( Object element, Widget item)           Adds the element item pair to the element map.
protected  boolean	needsRefilter ( Object element, String property)           Determines whether a change to the given property of the given element would require refiltering and/or resorting.
protected  void	preservingSelection ( Runnable updateCode)           Attempts to preserves the current selection across a run of the given code.
void	refresh ()           Refreshes this viewer completely with information freshly obtained from this viewer's model.
void	refresh (boolean updateLabels)           Refreshes this viewer with information freshly obtained from this viewer's model.
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	refreshItem ( Widget widget, Object element)           Refreshes the given item with the given element.
void	removeDoubleClickListener ( IDoubleClickListener listener)           Removes the given double-click listener from this viewer.
void	removeFilter ( ViewerFilter filter)           Removes the given filter from this viewer, and triggers refiltering and resorting of the elements if required.
void	removeOpenListener ( IOpenListener listener)           Removes the given open listener from this viewer.
void	removePostSelectionChangedListener ( ISelectionChangedListener listener)           Removes the given listener for post selection changes from this selection provider.
void	resetFilters ()           Discards this viewer's filters and triggers refiltering and resorting of the elements.
abstract  void	reveal ( Object element)           Ensures that the given element is visible, scrolling the viewer if necessary.
void	setComparator ( ViewerComparator comparator)           Sets this viewer's comparator to be used for sorting elements, and triggers refiltering and resorting of this viewer's element.
void	setComparer ( IElementComparer comparer)           Sets the comparer to use for comparing elements, or null to use the default equals and hashCode methods on the elements themselves.
void	setContentProvider ( IContentProvider provider)           Sets the content provider used by this viewer.
void	setFilters ( ViewerFilter[] filters)           Sets the filters, replacing any previous filters, and triggers refiltering and resorting of the elements.
void	setInput ( Object input)           The ContentViewer implementation of this Viewer method invokes inputChanged on the content provider and then the inputChanged hook method.
void	setLabelProvider ( IBaseLabelProvider labelProvider)           Sets the label provider for this viewer.
void	setSelection ( ISelection selection, boolean reveal)           Sets a new selection for this viewer and optionally makes it visible.
protected  void	setSelectionToWidget ( ISelection selection, boolean reveal)           Converts the selection to a List and calls setSelectionToWidget(List, boolean).
protected abstract  void	setSelectionToWidget ( List l, boolean reveal)           Parlays the given list of selected elements into selections on this viewer's control.
void	setSorter ( ViewerSorter sorter)           Sets this viewer's sorter and triggers refiltering and resorting of this viewer's element.
void	setUseHashlookup (boolean enable)           Configures whether this structured viewer uses an internal hash table to speeds up the mapping between elements and SWT items.
Widget	testFindItem ( Object element)           Hook for testing.
Widget[]	testFindItems ( Object element)           Hook for testing.
protected  void	unmapAllElements ()           Removes all elements from the map.
protected  void	unmapElement ( Object element)           Removes the given element from the internal element to widget map.
protected  void	unmapElement ( Object element, Widget item)           Removes the given association from the internal element to widget map.
void	update ( Object[] elements, String[] properties)           Updates the given elements' presentation when one or more of their properties change.
void	update ( Object element, String[] properties)           Updates the given element's presentation when one or more of its properties changes.
protected  void	updateItem ( Widget widget, Object element)           Copies attributes of the given element into the given widget.
protected  void	updateSelection ( ISelection selection)           Updates the selection of this viewer.
protected  boolean	usingElementMap ()           Returns whether this structured viewer is configured to use an internal map to speed up the mapping between elements and SWT items.

 

Methods inherited from class org.eclipse.jface.viewers. ContentViewer
getContentProvider, getInput, getLabelProvider, labelProviderChanged

 

Methods inherited from class org.eclipse.jface.viewers. Viewer
addHelpListener, addSelectionChangedListener, fireHelpRequested, fireSelectionChanged, getControl, getData, handleHelpRequest, inputChanged, removeHelpListener, removeSelectionChangedListener, scrollDown, scrollUp, setData, setSelection

 

Methods inherited from class java.lang. Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

 

Methods inherited from interface org.eclipse.jface.viewers. ISelectionProvider
addSelectionChangedListener, removeSelectionChangedListener, setSelection

 

Constructor Detail

StructuredViewer

protected StructuredViewer()

Creates a structured element viewer. The viewer has no input, no content provider, a default label provider, no sorter, and no filters.

addDoubleClickListener

public void addDoubleClickListener(
IDoubleClickListener listener)

Adds a listener for double-clicks in this viewer. Has no effect if an identical listener is already registered.

Parameters:

listener - a double-click listener

addOpenListener

public void addOpenListener(
IOpenListener listener)

Adds a listener for selection-open in this viewer. Has no effect if an identical listener is already registered.

Parameters:

listener - an open listener

addPostSelectionChangedListener

public void addPostSelectionChangedListener(
ISelectionChangedListener listener)

Description copied from interface: IPostSelectionProvider

Adds a listener for post selection changes in this selection provider. Has no effect if an identical listener is already registered.

Specified by:

addPostSelectionChangedListener in interface IPostSelectionProvider

Parameters:

listener - a selection changed listener

addDragSupport

public void addDragSupport(int operations,
                           
Transfer[] transferTypes,
                           
DragSourceListener listener)

Adds support for dragging items out of this viewer via a user drag-and-drop operation.

Parameters:

operations - a bitwise OR of the supported drag and drop operation types ( DROP_COPY,DROP_LINK, and DROP_MOVE)

transferTypes - the transfer types that are supported by the drag operation

listener - the callback that will be invoked to set the drag data and to cleanup after the drag and drop operation finishes

See Also:

DND

addDropSupport

public void addDropSupport(int operations,
                           
Transfer[] transferTypes,
                           
DropTargetListener listener)

Adds support for dropping items into this viewer via a user drag-and-drop operation.

Parameters:

operations - a bitwise OR of the supported drag and drop operation types ( DROP_COPY,DROP_LINK, and DROP_MOVE)

transferTypes - the transfer types that are supported by the drop operation

listener - the callback that will be invoked after the drag and drop operation finishes

See Also:

DND

addFilter

public void addFilter(
ViewerFilter filter)

Adds the given filter to this viewer, and triggers refiltering and resorting of the elements. If you want to add more than one filter consider using setFilters(ViewerFilter[]).

Parameters:

filter - a viewer filter

See Also:

setFilters(ViewerFilter[])

assertElementsNotNull

protected void assertElementsNotNull(
Object[] elements)

Asserts that the given array of elements is itself non- null and contains no null elements.

Parameters:

elements - the array to check

associate

protected void associate(
Object element,
                         
Item item)

Associates the given element with the given widget. Sets the given item's data to be the element, and maps the element to the item in the element map (if enabled).

Parameters:

element - the element

item - the widget

disassociate

protected void disassociate(
Item item)

Disassociates the given SWT item from its corresponding element. Sets the item's data to null and removes the element from the element map (if enabled).

Parameters:

item - the widget

doFindInputItem

protected abstract 
Widget doFindInputItem(
Object element)

Returns the widget in this viewer's control which represents the given element if it is the viewer's input.

This method is internal to the framework; subclassers should not call this method.

Parameters:

element -

Returns:

the corresponding widget, or null if none

doFindItem

protected abstract 
Widget doFindItem(
Object element)

Returns the widget in this viewer's control which represent the given element. This method searches all the children of the input element.

This method is internal to the framework; subclassers should not call this method.

Parameters:

element -

Returns:

the corresponding widget, or null if none

doUpdateItem

protected abstract void doUpdateItem(
Widget item,
                                     
Object element,
                                     boolean fullMap)

Copies the attributes of the given element into the given SWT item. The element map is updated according to the value of fullMap. If fullMap is true then the current mapping from element to widgets is removed and the new mapping is added. If full map is false then only the new map gets installed. Installing only the new map is necessary in cases where only the order of elements changes but not the set of elements.

This method is internal to the framework; subclassers should not call this method.

Parameters:

item -

element - element

fullMap - true if mappings are added and removed, and false if only the new map gets installed

equals

protected boolean equals(
Object elementA,
                         
Object elementB)

Compares two elements for equality. Uses the element comparer if one has been set, otherwise uses the default equals method on the elements themselves.

Parameters:

elementA - the first element

elementB - the second element

Returns:

whether elementA is equal to elementB

filter

protected 
Object[] filter(
Object[] elements)

Returns the result of running the given elements through the filters.

Parameters:

elements - the elements to filter

Returns:

only the elements which all filters accept

findItem

protected final 
Widget findItem(
Object element)

Finds the widget which represents the given element.

The default implementation of this method tries first to find the widget for the given element assuming that it is the viewer's input; this is done by calling doFindInputItem. If it is not found there, it is looked up in the internal element map provided that this feature has been enabled. If the element map is disabled, the widget is found via doFindInputItem.

Parameters:

element - the element

Returns:

the corresponding widget, or null if none

findItems

protected final 
Widget[] findItems(
Object element)

Finds the widgets which represent the given element. The returned array must not be changed by clients; it might change upon calling other methods on this viewer.

This method was introduced to support multiple equal elements in a viewer (@see AbstractTreeViewer). Multiple equal elements are only supported if the element map is enabled by calling setUseHashlookup(boolean) and passing true.

The default implementation of this method tries first to find the widget for the given element assuming that it is the viewer's input; this is done by calling doFindInputItem. If it is not found there, the widgets are looked up in the internal element map provided that this feature has been enabled. If the element map is disabled, the widget is found via doFindInputItem.

Parameters:

element - the element

Returns:

the corresponding widgets

Since:

3.2

fireDoubleClick

protected void fireDoubleClick(
DoubleClickEvent event)

Notifies any double-click listeners that a double-click has been received. Only listeners registered at the time this method is called are notified.

Parameters:

event - a double-click event

See Also:

IDoubleClickListener.doubleClick(org.eclipse.jface.viewers.DoubleClickEvent)

fireOpen

protected void fireOpen(
OpenEvent event)

Notifies any open event listeners that a open event has been received. Only listeners registered at the time this method is called are notified.

Parameters:

event - a double-click event

See Also:

IOpenListener.open(OpenEvent)

firePostSelectionChanged

protected void firePostSelectionChanged(
SelectionChangedEvent event)

Notifies any post selection listeners that a post selection event has been received. Only listeners registered at the time this method is called are notified.

Parameters:

event - a selection changed event

See Also:

addPostSelectionChangedListener(ISelectionChangedListener)

getComparer

public 
IElementComparer getComparer()

Returns the comparer to use for comparing elements, or null if none has been set. If specified, the viewer uses this to compare and hash elements rather than the elements' own equals and hashCode methods.

Returns:

the comparer to use for comparing elements or null

getFilteredChildren

protected 
Object[] getFilteredChildren(
Object parent)

Returns the filtered array of children of the given element. The resulting array must not be modified, as it may come directly from the model's internal state.

Parameters:

parent - the parent element

Returns:

a filtered array of child elements

getFilters

public 
ViewerFilter[] getFilters()

Returns this viewer's filters.

Returns:

an array of viewer filters

See Also:

setFilters(ViewerFilter[])

getItem

protected 
Item getItem(int x,
                       int y)

Deprecated. This method is deprecated in 3.3 in favor of ColumnViewer.getItemAt(org.eclipse.swt.graphics.Point). Viewers who are not subclasses of ColumnViewer should consider using a widget relative implementation like ColumnViewer.getItemAt(org.eclipse.swt.graphics.Point).

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.

Parameters:

x - horizontal coordinate

y - vertical coordinate

Returns:

the item, or null if there is no item at the given coordinates

getRawChildren

protected 
Object[] getRawChildren(
Object parent)

Returns the children of the given parent without sorting and filtering them. The resulting array must not be modified, as it may come directly from the model's internal state.

Returns an empty array if the given parent is null.

Parameters:

parent - the parent element

Returns:

the child elements

getRoot

protected 
Object getRoot()

Returns the root element.

The default implementation of this framework method forwards to getInput. Override if the root element is different from the viewer's input element.

Returns:

the root element, or null if none

getSelection

public 
ISelection getSelection()

The StructuredViewer implementation of this method returns the result as an IStructuredSelection.

Subclasses do not typically override this method, but implement getSelectionFromWidget(List) instead.

Specified by:

getSelection in interface ISelectionProvider

Specified by:

getSelection in class Viewer

Returns:

ISelection

getSelectionFromWidget

protected abstract 
List getSelectionFromWidget()

Retrieves the selection, as a List, from the underlying widget.

Returns:

the list of selected elements

getSortedChildren

protected 
Object[] getSortedChildren(
Object parent)

Returns the sorted and filtered set of children of the given element. The resulting array must not be modified, as it may come directly from the model's internal state.

Parameters:

parent - the parent element

Returns:

a sorted and filtered array of child elements

getSorter

public 
ViewerSorter getSorter()

Returns this viewer's sorter, or null if it does not have one. If this viewer has a comparator that was set via setComparator(ViewerComparator) then this method will return null if the comparator is not an instance of ViewerSorter.

It is recommended to use getComparator() instead.

Returns:

a viewer sorter, or null if none or if the comparator is not an instance of ViewerSorter

getComparator

public 
ViewerComparator getComparator()

Return this viewer's comparator used to sort elements. This method should be used instead of getSorter().

Returns:

a viewer comparator, or null if none

Since:

3.2

handleDoubleSelect

protected void handleDoubleSelect(
SelectionEvent event)

Handles a double-click select event from the widget.

This method is internal to the framework; subclassers should not call this method.

Parameters:

event - the SWT selection event

handleOpen

protected void handleOpen(
SelectionEvent event)

Handles an open event from the OpenStrategy.

This method is internal to the framework; subclassers should not call this method.

Parameters:

event - the SWT selection event

handleInvalidSelection

protected void handleInvalidSelection(
ISelection invalidSelection,
                                      
ISelection newSelection)

Handles an invalid selection.

This framework method is called if a model change picked up by a viewer results in an invalid selection. For instance if an element contained in the selection has been removed from the viewer, the viewer is free to either remove the element from the selection or to pick another element as its new selection. The default implementation of this method calls updateSelection. Subclasses may override it to implement a different strategy for picking a new selection when the old selection becomes invalid.

Parameters:

invalidSelection - the selection before the viewer was updated

newSelection - the selection after the update, or null if none

handleLabelProviderChanged

protected void handleLabelProviderChanged(
LabelProviderChangedEvent event)

The StructuredViewer implementation of this ContentViewer method calls update if the event specifies that the label of a given element has changed, otherwise it calls super. Subclasses may reimplement or extend.

Overrides:

handleLabelProviderChanged in class ContentViewer

Parameters:

event - the event that generated this update

handleSelect

protected void handleSelect(
SelectionEvent event)

Handles a select event from the widget.

This method is internal to the framework; subclassers should not call this method.

Parameters:

event - the SWT selection event

handlePostSelect

protected void handlePostSelect(
SelectionEvent e)

Handles a post select event from the widget.

This method is internal to the framework; subclassers should not call this method.

Parameters:

e - the SWT selection event

hookControl

protected void hookControl(
Control control)

Description copied from class: ContentViewer

Adds event listener hooks to the given control.

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.

Overrides:

hookControl in class ContentViewer

Parameters:

control - the control

hasFilters

protected boolean hasFilters()

Returns whether this viewer has any filters.

Returns:

boolean

internalRefresh

protected abstract void internalRefresh(
Object element)

Refreshes this viewer starting at the given element.

Parameters:

element - the element

internalRefresh

protected void internalRefresh(
Object element,
                               boolean updateLabels)

Refreshes this viewer starting at the given element. Labels are updated as described in refresh(boolean updateLabels).

The default implementation simply calls internalRefresh(element), ignoring updateLabels.

If this method is overridden to do the actual refresh, then internalRefresh(Object element) should simply call internalRefresh(element, true).

Parameters:

element - the element

updateLabels - true to update labels for existing elements, false to only update labels as needed, assuming that labels for existing elements are unchanged.

Since:

2.0

mapElement

protected void mapElement(
Object element,
                          
Widget item)

Adds the element item pair to the element map.

This method is internal to the framework; subclassers should not call this method.

Parameters:

element - the element

item - the corresponding widget

needsRefilter

protected boolean needsRefilter(
Object element,
                                
String property)

Determines whether a change to the given property of the given element would require refiltering and/or resorting.

This method is internal to the framework; subclassers should not call this method.

Parameters:

element - the element

property - the property

Returns:

true if refiltering is required, and false otherwise

preservingSelection

protected void preservingSelection(
Runnable updateCode)

Attempts to preserves the current selection across a run of the given code. This method should not preserve the selection if {link #getPreserveSelection()} returns false.

The default implementation of this method:

• discovers the old selection (via getSelection)
• runs the given runnable
• attempts to restore the old selection (using setSelectionToWidget
• rediscovers the resulting selection (via getSelection)
• calls handleInvalidSelection if the resulting selection is different from the old selection

Parameters:

updateCode - the code to run see #getPreserveSelection()

refresh

public void refresh()

Description copied from class: Viewer

Refreshes this viewer completely with information freshly obtained from this viewer's model.

Specified by:

refresh in class Viewer

refresh

public void refresh(boolean updateLabels)

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.

Parameters:

updateLabels - true to update labels for existing elements, false to only update labels as needed, assuming that labels for existing elements are unchanged.

Since:

2.0

refresh

public void refresh(
Object element)

Refreshes this viewer starting with the given element.

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.

Parameters:

element - the element

refresh

public void refresh(
Object element,
                    boolean updateLabels)

Refreshes this viewer starting with the given element. Labels are updated as described in 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.

Parameters:

element - the element

updateLabels - true to update labels for existing elements, false to only update labels as needed, assuming that labels for existing elements are unchanged.

Since:

2.0

refreshItem

protected final void refreshItem(
Widget widget,
                                 
Object element)

Refreshes the given item with the given element. Calls doUpdateItem(..., false).

This method is internal to the framework; subclassers should not call this method.

Parameters:

widget - the widget

element - the element

removeOpenListener

public void removeOpenListener(
IOpenListener listener)

Removes the given open listener from this viewer. Has no affect if an identical listener is not registered.

Parameters:

listener - an open listener

removePostSelectionChangedListener

public void removePostSelectionChangedListener(
ISelectionChangedListener listener)

Description copied from interface: IPostSelectionProvider

Removes the given listener for post selection changes from this selection provider. Has no affect if an identical listener is not registered.

Specified by:

removePostSelectionChangedListener in interface IPostSelectionProvider

Parameters:

listener - a selection changed listener

removeDoubleClickListener

public void removeDoubleClickListener(
IDoubleClickListener listener)

Removes the given double-click listener from this viewer. Has no affect if an identical listener is not registered.

Parameters:

listener - a double-click listener

removeFilter

public void removeFilter(
ViewerFilter filter)

Removes the given filter from this viewer, and triggers refiltering and resorting of the elements if required. Has no effect if the identical filter is not registered. If you want to remove more than one filter consider using setFilters(ViewerFilter[]).

Parameters:

filter - a viewer filter

See Also:

setFilters(ViewerFilter[])

setFilters

public void setFilters(
ViewerFilter[] filters)

Sets the filters, replacing any previous filters, and triggers refiltering and resorting of the elements.

Parameters:

filters - an array of viewer filters

Since:

3.3

resetFilters

public void resetFilters()

Discards this viewer's filters and triggers refiltering and resorting of the elements.

reveal

public abstract void reveal(
Object element)

Ensures that the given element is visible, scrolling the viewer if necessary. The selection is unchanged.

Parameters:

element - the element to reveal

setContentProvider

public void setContentProvider(
IContentProvider provider)

Description copied from class: ContentViewer

Sets the content provider used by this viewer.

The ContentViewer implementation of this method records the content provider in an internal state variable. Overriding this method is generally not required; however, if overriding in a subclass, super.setContentProvider must be invoked.

Overrides:

setContentProvider in class ContentViewer

Parameters:

provider - the content provider

See Also:

ContentViewer.getContentProvider()

assertContentProviderType

protected void assertContentProviderType(
IContentProvider provider)

Assert that the content provider is of one of the supported types.

Parameters:

provider -

setInput

public final void setInput(
Object input)

Description copied from class: ContentViewer

The ContentViewer implementation of this Viewer method invokes inputChanged on the content provider and then the inputChanged hook method. This method fails if this viewer does not have a content provider. Subclassers are advised to override inputChanged rather than this method, but may extend this method if required.

Overrides:

setInput in class ContentViewer

Parameters:

input - the input of this viewer, or null if none

setSelection

public void setSelection(
ISelection selection,
                         boolean reveal)

Description copied from class: Viewer

Sets a new selection for this viewer and optionally makes it visible.

Subclasses must implement this method.

Specified by:

setSelection in class Viewer

Parameters:

selection - the new selection

reveal - true if the selection is to be made visible, and false otherwise

setSelectionToWidget

protected abstract void setSelectionToWidget(
List l,
                                             boolean reveal)

Parlays the given list of selected elements into selections on this viewer's control.

Subclasses should override to set their selection based on the given list of elements.

Parameters:

l - list of selected elements (element type: Object) or null if the selection is to be cleared

reveal - true if the selection is to be made visible, and false otherwise

setSelectionToWidget

protected void setSelectionToWidget(
ISelection selection,
                                    boolean reveal)

Converts the selection to a List and calls setSelectionToWidget(List, boolean). The selection is expected to be an IStructuredSelection of elements. If not, the selection is cleared.

Subclasses do not typically override this method, but implement setSelectionToWidget(List, boolean) instead.

Parameters:

selection - an IStructuredSelection of elements

reveal - true to reveal the first element in the selection, or false otherwise

setSorter

public void setSorter(
ViewerSorter sorter)

Sets this viewer's sorter and triggers refiltering and resorting of this viewer's element. Passing null turns sorting off.

It is recommended to use setComparator() instead.

Parameters:

sorter - a viewer sorter, or null if none

setComparator

public void setComparator(
ViewerComparator comparator)

Sets this viewer's comparator to be used for sorting elements, and triggers refiltering and resorting of this viewer's element. null turns sorting off. To get the viewer's comparator, call getComparator().

IMPORTANT: This method was introduced in 3.2. If a reference to this viewer object is passed to clients who call getSorter(), null may be returned from from that method even though the viewer is sorting its elements using the viewer's comparator.

Parameters:

comparator - a viewer comparator, or null if none

Since:

3.2

public void setUseHashlookup(boolean enable)

public void setComparer(
IElementComparer comparer)

public 
Widget testFindItem(
Object element)

public 
Widget[] testFindItems(
Object element)

protected void unmapAllElements()

protected void unmapElement(
Object element)

protected void unmapElement(
Object element,
                            
Widget item)

public void update(
Object[] elements,
                   
String[] properties)

public void update(
Object element,
                   
String[] properties)

protected void internalUpdate(
Widget widget,
                              
Object element,
                              
String[] properties)

protected final void updateItem(
Widget widget,
                                
Object element)

protected void updateSelection(
ISelection selection)

protected boolean usingElementMap()

public void setLabelProvider(
IBaseLabelProvider labelProvider)

protected void buildLabel(
ViewerLabel updateLabel,
                          
Object element)

protected 
StructuredViewer.ColorAndFontCollector getColorAndFontCollector()

protected void handleDispose(
DisposeEvent event)