Class ViewersObservables
- java.lang.Object
-
- org.eclipse.jface.databinding.viewers.ViewersObservables
-
@Deprecated public class ViewersObservables extends Object
Deprecated.This class will be removed in a future release. See https://bugs.eclipse.org/bugs/show_bug.cgi?id=546820 for more information. UseViewerProperties
instead.Factory methods for creating observables for JFace viewers- Since:
- 1.1
- Restriction:
-
-
Constructor Summary
Constructors Constructor Description ViewersObservables()
Deprecated.
-
Method Summary
All Methods Static Methods Concrete Methods Deprecated Methods Modifier and Type Method Description static IViewerObservableSet
observeCheckedElements(CheckboxTableViewer viewer, Object elementType)
Deprecated.Returns an observable set that tracks the checked elements of the given viewer.static IViewerObservableSet
observeCheckedElements(CheckboxTreeViewer viewer, Object elementType)
Deprecated.Returns an observable set that tracks the checked elements of the given viewer.static IObservableSet
observeCheckedElements(ICheckable checkable, Object elementType)
Deprecated.Returns an observable set that tracks the checked elements of the givenICheckable
.static <T> IViewerObservableValue<T>
observeDelayedValue(int delay, IViewerObservableValue<T> observable)
Deprecated.Returns an observable which delays notification of value change events fromobservable
untildelay
milliseconds have passed since the last change event, or until a FocusOut event is received from the underlying viewer control (whichever happens earlier).static IViewerObservableSet
observeFilters(StructuredViewer viewer)
Deprecated.Returns an observable set that tracks the filters of the given viewer.static IObservableValue
observeInput(Viewer viewer)
Deprecated.Returns an observable value that tracks the input of the given viewer.static IObservableList
observeMultiPostSelection(IPostSelectionProvider selectionProvider)
Deprecated.Returns an observable list that tracks the current post selection of the given post selection provider.static IViewerObservableList
observeMultiPostSelection(StructuredViewer viewer)
Deprecated.Returns an observable list that tracks the current post selection of the given structured viewer.static IObservableList
observeMultiSelection(ISelectionProvider selectionProvider)
Deprecated.Returns an observable list that tracks the current selection of the given selection provider.static IViewerObservableList
observeMultiSelection(Viewer viewer)
Deprecated.Returns an observable list that tracks the current selection of the given viewer.static IObservableValue
observeSinglePostSelection(IPostSelectionProvider selectionProvider)
Deprecated.Returns an observable value that tracks the current post selection of the given post selection provider.static IViewerObservableValue
observeSinglePostSelection(StructuredViewer viewer)
Deprecated.Returns an observable value that tracks the current post selection of the given structured viewer.static IObservableValue
observeSingleSelection(ISelectionProvider selectionProvider)
Deprecated.Returns an observable value that tracks the current selection of the given selection provider.static IViewerObservableValue
observeSingleSelection(Viewer viewer)
Deprecated.Returns an observable value that tracks the current selection of the given viewer.
-
-
-
Method Detail
-
observeDelayedValue
public static <T> IViewerObservableValue<T> observeDelayedValue(int delay, IViewerObservableValue<T> observable)
Deprecated.Returns an observable which delays notification of value change events fromobservable
untildelay
milliseconds have passed since the last change event, or until a FocusOut event is received from the underlying viewer control (whichever happens earlier). This class helps to delay validation until the user stops changing the value (e.g. until a user stops changing a viewer selection). To notify about pending changes, the returned observable value will fire a stale event when the wrapped observable value fires a change event, but this change is being delayed.- Parameters:
delay
- the delay in millisecondsobservable
- the observable being delayed- Returns:
- an observable which delays notification of value change events
from
observable
untildelay
milliseconds have passed since the last change event. - Since:
- 1.3
-
observeSingleSelection
public static IObservableValue observeSingleSelection(ISelectionProvider selectionProvider)
Deprecated.Returns an observable value that tracks the current selection of the given selection provider. If the selection provider provides selections of typeIStructuredSelection
, the observable value will be the first element of the structured selection as returned byIStructuredSelection.getFirstElement()
.- Parameters:
selectionProvider
- provider to get selection from; notnull
- Returns:
- the observable value tracking the (single) selection of the given selection provider
-
observeSinglePostSelection
public static IObservableValue observeSinglePostSelection(IPostSelectionProvider selectionProvider)
Deprecated.Returns an observable value that tracks the current post selection of the given post selection provider. If the selection provider provides selections of typeIStructuredSelection
, the observable value will be the first element of the structured selection as returned byIStructuredSelection.getFirstElement()
.- Parameters:
selectionProvider
- The selection provider on which to track the post selection.- Returns:
- the observable value tracking the (single) post selection of the given post selection provider
- Since:
- 1.4
-
observeMultiSelection
public static IObservableList observeMultiSelection(ISelectionProvider selectionProvider)
Deprecated.Returns an observable list that tracks the current selection of the given selection provider. Assumes that the selection provider provides selections of typeIStructuredSelection
. Note that the observable list will not honor the full contract ofjava.util.List
in that it may delete or reorder elements based on what the selection provider returns fromISelectionProvider.getSelection()
after having calledISelectionProvider.setSelection(org.eclipse.jface.viewers.ISelection)
based on the requested change to the observable list. The affected methods areadd
,addAll
, andset
.- Parameters:
selectionProvider
- provider to get selection from; notnull
- Returns:
- the observable value tracking the (multi) selection of the given selection provider
- Since:
- 1.2
-
observeMultiPostSelection
public static IObservableList observeMultiPostSelection(IPostSelectionProvider selectionProvider)
Deprecated.Returns an observable list that tracks the current post selection of the given post selection provider. Assumes that the selection provider provides selections of typeIStructuredSelection
. Note that the observable list will not honor the full contract ofjava.util.List
in that it may delete or reorder elements based on what the selection provider returns fromISelectionProvider.getSelection()
after having calledISelectionProvider.setSelection(org.eclipse.jface.viewers.ISelection)
based on the requested change to the observable list. The affected methods areadd
,addAll
, andset
.- Parameters:
selectionProvider
- The selection provider on which to track the post selection.- Returns:
- the observable value tracking the (multi) post selection of the given post selection provider
- Since:
- 1.4
-
observeSingleSelection
public static IViewerObservableValue observeSingleSelection(Viewer viewer)
Deprecated.Returns an observable value that tracks the current selection of the given viewer. If the viewer provides selections of typeIStructuredSelection
, the observable value will be the first element of the structured selection as returned byIStructuredSelection.getFirstElement()
.- Parameters:
viewer
- the viewer- Returns:
- the observable value tracking the (single) selection of the given viewer
- Since:
- 1.2
-
observeSinglePostSelection
public static IViewerObservableValue observeSinglePostSelection(StructuredViewer viewer)
Deprecated.Returns an observable value that tracks the current post selection of the given structured viewer. If the viewer provides selections of typeIStructuredSelection
, the observable value will be the first element of the structured selection as returned byIStructuredSelection.getFirstElement()
.- Parameters:
viewer
- The viewer on which to track the post selection.- Returns:
- the observable value tracking the (single) post selection of the given structured viewer
- Since:
- 1.4
-
observeMultiSelection
public static IViewerObservableList observeMultiSelection(Viewer viewer)
Deprecated.Returns an observable list that tracks the current selection of the given viewer. Assumes that the viewer provides selections of typeIStructuredSelection
. Note that the observable list will not honor the full contract ofjava.util.List
in that it may delete or reorder elements based on what the viewer returns fromISelectionProvider.getSelection()
after having calledISelectionProvider.setSelection(org.eclipse.jface.viewers.ISelection)
based on the requested change to the observable list. The affected methods areadd
,addAll
, andset
.- Parameters:
viewer
- The viewer on which to track the selection.- Returns:
- the observable value tracking the (multi) selection of the given selection provider
- Since:
- 1.2
-
observeMultiPostSelection
public static IViewerObservableList observeMultiPostSelection(StructuredViewer viewer)
Deprecated.Returns an observable list that tracks the current post selection of the given structured viewer. Assumes that the viewer provides selections of typeIStructuredSelection
. Note that the observable list will not honor the full contract ofjava.util.List
in that it may delete or reorder elements based on what the viewer returns fromISelectionProvider.getSelection()
after having calledISelectionProvider.setSelection(org.eclipse.jface.viewers.ISelection)
based on the requested change to the observable list. The affected methods areadd
,addAll
, andset
.- Parameters:
viewer
- The viewer on which to track the post selection.- Returns:
- the observable value tracking the (multi) post selection of the given structured viewer
- Since:
- 1.4
-
observeInput
public static IObservableValue observeInput(Viewer viewer)
Deprecated.Returns an observable value that tracks the input of the given viewer.The returned observer is blind to changes in the viewer's input unless its
IObservableValue.setValue(Object)
method is called directly.- Parameters:
viewer
- the viewer to observe- Returns:
- an observable value tracking the input of the given viewer
- Since:
- 1.2
-
observeCheckedElements
public static IObservableSet observeCheckedElements(ICheckable checkable, Object elementType)
Deprecated.Returns an observable set that tracks the checked elements of the givenICheckable
.- Parameters:
checkable
-ICheckable
containing the checked elements to trackelementType
- element type of the returned set- Returns:
- an observable set tracking the checked elements of the given checkable.
- Since:
- 1.2
-
observeCheckedElements
public static IViewerObservableSet observeCheckedElements(CheckboxTableViewer viewer, Object elementType)
Deprecated.Returns an observable set that tracks the checked elements of the given viewer. Assumes that the viewer implementsICheckable
.- Parameters:
viewer
-CheckboxTableViewer
containing the checked elements to track.elementType
- element type of the returned set- Returns:
- an observable set that tracks the checked elements of the given viewer.
- Since:
- 1.2
-
observeCheckedElements
public static IViewerObservableSet observeCheckedElements(CheckboxTreeViewer viewer, Object elementType)
Deprecated.Returns an observable set that tracks the checked elements of the given viewer. Assumes that the viewer implementsICheckable
.- Parameters:
viewer
-CheckboxTreeViewer
containing the checked elements to track.elementType
- element type of the returned set- Returns:
- an observable set that tracks the checked elements of the given viewer.
- Since:
- 1.2
-
observeFilters
public static IViewerObservableSet observeFilters(StructuredViewer viewer)
Deprecated.Returns an observable set that tracks the filters of the given viewer. Note that the returned set will not track changes that are made using direct API on StructuredViewer (by callingaddFilter()
,removeFilter()
, orsetFilters()
) -- it is assumed that filters are only changed through the returned set.- Parameters:
viewer
- viewer containing the filters to be tracked- Returns:
- an observable set that tracks the filters of the given viewer.
- Since:
- 1.3
-
-