ca.odell.glazedlists.swt
Class EventComboViewer<E>

java.lang.Object
  ca.odell.glazedlists.swt.EventComboViewer<E>

All Implemented Interfaces:

ListEventListener<E>, EventListener

public class EventComboViewer<E>
extends Object
implements ListEventListener<E>

A view helper that displays an EventList in a Combo component.

This class is not thread safe. It must be used exclusively with the SWT event handler thread.

Author:

Kevin Maltby

Constructor Summary

EventComboViewer(EventList<E> source, Combo combo)
Binds the contents of a Combo component to an EventList source.

EventComboViewer(EventList<E> source, Combo combo, ILabelProvider labelProvider)
Binds the contents of a Combo component to an EventList source.

Method Summary

void	dispose() Releases the resources consumed by this EventComboViewer so that it may eventually be garbage collected.
Combo	getCombo() Gets the Combo being managed by this EventComboViewer.
void	listChanged(ListEvent listChanges) When the source combo is changed, this forwards the change to the displayed combo.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

EventComboViewer

public EventComboViewer(EventList<E> source,
                        Combo combo)

Binds the contents of a Combo component to an EventList source. This allows the selection choices in a Combo to change dynamically to reflect chances to the source EventList. The String values displayed in the Combo compoment will be the result of calling toString() on the Objects found in source.

EventComboViewer

public EventComboViewer(EventList<E> source,
                        Combo combo,
                        ILabelProvider labelProvider)

Binds the contents of a Combo component to an EventList source. This allows the selection choices in a Combo to change dynamically to reflect chances to the source EventList. The String values displayed in the Combo compoment will be formatted using the provided ILabelProvider.

See Also:

ILabelProvider, GlazedListsSWT.beanLabelProvider(String)

Method Detail

getCombo

public Combo getCombo()

Gets the Combo being managed by this EventComboViewer.

listChanged

public void listChanged(ListEvent listChanges)

When the source combo is changed, this forwards the change to the displayed combo.

Specified by:

listChanged in interface ListEventListener<E>

dispose

public void dispose()

Releases the resources consumed by this EventComboViewer so that it may eventually be garbage collected.

An EventComboViewer will be garbage collected without a call to dispose(), but not before its source EventList is garbage collected. By calling dispose(), you allow the EventComboViewer to be garbage collected before its source EventList. This is necessary for situations where an EventComboViewer is short-lived but its source EventList is long-lived.

Warning: It is an error to call any method on a EventComboViewer after it has been disposed.