| /******************************************************************************* |
| * Copyright (c) 2006, 2008 IBM Corporation and others. |
| * All rights reserved. This program and the accompanying materials |
| * are made available under the terms of the Eclipse Public License v1.0 |
| * which accompanies this distribution, and is available at |
| * http://www.eclipse.org/legal/epl-v10.html |
| * |
| * Contributors: |
| * IBM Corporation - initial API and implementation |
| * Matthew Hall - bugs 206839, 124684, 239302, 245647, 194734, 195222, |
| * 264286 |
| *******************************************************************************/ |
| |
| package org.eclipse.jface.databinding.viewers; |
| |
| import org.eclipse.core.databinding.observable.Observables; |
| import org.eclipse.core.databinding.observable.list.IObservableList; |
| import org.eclipse.core.databinding.observable.set.IObservableSet; |
| import org.eclipse.core.databinding.observable.value.IObservableValue; |
| import org.eclipse.jface.internal.databinding.viewers.ViewerObservableValueDecorator; |
| import org.eclipse.jface.viewers.CheckboxTableViewer; |
| import org.eclipse.jface.viewers.CheckboxTreeViewer; |
| import org.eclipse.jface.viewers.ICheckable; |
| import org.eclipse.jface.viewers.ISelectionProvider; |
| import org.eclipse.jface.viewers.IStructuredSelection; |
| import org.eclipse.jface.viewers.StructuredViewer; |
| import org.eclipse.jface.viewers.Viewer; |
| |
| /** |
| * Factory methods for creating observables for JFace viewers |
| * |
| * @since 1.1 |
| */ |
| public class ViewersObservables { |
| private static void checkNull(Object obj) { |
| if (obj == null) |
| throw new IllegalArgumentException(); |
| } |
| |
| /** |
| * Returns an observable which delays notification of value change events |
| * from <code>observable</code> until <code>delay</code> 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. |
| * |
| * @param delay |
| * the delay in milliseconds |
| * @param observable |
| * the observable being delayed |
| * @return an observable which delays notification of value change events |
| * from <code>observable</code> until <code>delay</code> |
| * milliseconds have passed since the last change event. |
| * |
| * @since 1.3 |
| */ |
| public static IViewerObservableValue observeDelayedValue(int delay, |
| IViewerObservableValue observable) { |
| return new ViewerObservableValueDecorator(Observables |
| .observeDelayedValue(delay, observable), observable.getViewer()); |
| } |
| |
| /** |
| * Returns an observable value that tracks the current selection of the |
| * given selection provider. If the selection provider provides selections |
| * of type {@link IStructuredSelection}, the observable value will be the |
| * first element of the structured selection as returned by |
| * {@link IStructuredSelection#getFirstElement()}. |
| * |
| * @param selectionProvider |
| * @return the observable value tracking the (single) selection of the given |
| * selection provider |
| */ |
| public static IObservableValue observeSingleSelection( |
| ISelectionProvider selectionProvider) { |
| checkNull(selectionProvider); |
| return ViewerProperties.singleSelection().observe(selectionProvider); |
| } |
| |
| /** |
| * Returns an observable list that tracks the current selection of the given |
| * selection provider. Assumes that the selection provider provides |
| * selections of type {@link IStructuredSelection}. Note that the observable |
| * list will not honor the full contract of <code>java.util.List</code> in |
| * that it may delete or reorder elements based on what the selection |
| * provider returns from {@link ISelectionProvider#getSelection()} after |
| * having called |
| * {@link ISelectionProvider#setSelection(org.eclipse.jface.viewers.ISelection)} |
| * based on the requested change to the observable list. The affected |
| * methods are <code>add</code>, <code>addAll</code>, and <code>set</code>. |
| * |
| * @param selectionProvider |
| * @return the observable value tracking the (multi) selection of the given |
| * selection provider |
| * |
| * @since 1.2 |
| */ |
| public static IObservableList observeMultiSelection( |
| ISelectionProvider selectionProvider) { |
| checkNull(selectionProvider); |
| return ViewerProperties.multipleSelection().observe(selectionProvider); |
| } |
| |
| /** |
| * Returns an observable value that tracks the current selection of the |
| * given viewer. If the viewer provides selections of type |
| * {@link IStructuredSelection}, the observable value will be the first |
| * element of the structured selection as returned by |
| * {@link IStructuredSelection#getFirstElement()}. |
| * |
| * @param viewer |
| * the viewer |
| * @return the observable value tracking the (single) selection of the given |
| * viewer |
| * @since 1.2 |
| */ |
| public static IViewerObservableValue observeSingleSelection(Viewer viewer) { |
| checkNull(viewer); |
| return ViewerProperties.singleSelection().observe(viewer); |
| } |
| |
| /** |
| * Returns an observable list that tracks the current selection of the given |
| * viewer. Assumes that the viewer provides selections of type |
| * {@link IStructuredSelection}. Note that the observable list will not |
| * honor the full contract of <code>java.util.List</code> in that it may |
| * delete or reorder elements based on what the viewer returns from |
| * {@link ISelectionProvider#getSelection()} after having called |
| * {@link ISelectionProvider#setSelection(org.eclipse.jface.viewers.ISelection)} |
| * based on the requested change to the observable list. The affected |
| * methods are <code>add</code>, <code>addAll</code>, and <code>set</code>. |
| * |
| * @param viewer |
| * @return the observable value tracking the (multi) selection of the given |
| * selection provider |
| * |
| * @since 1.2 |
| */ |
| public static IViewerObservableList observeMultiSelection(Viewer viewer) { |
| checkNull(viewer); |
| return ViewerProperties.multipleSelection().observe(viewer); |
| } |
| |
| /** |
| * Returns an observable value that tracks the input of the given viewer. |
| * <p> |
| * The returned observer is blind to changes in the viewer's input unless |
| * its {@link IObservableValue#setValue(Object)} method is called directly. |
| * |
| * @param viewer |
| * the viewer to observe |
| * @return an observable value tracking the input of the given viewer |
| * @since 1.2 |
| */ |
| public static IObservableValue observeInput(Viewer viewer) { |
| checkNull(viewer); |
| return ViewerProperties.input().observe(viewer); |
| } |
| |
| /** |
| * Returns an observable set that tracks the checked elements of the given |
| * <code>ICheckable</code>. |
| * |
| * @param checkable |
| * {@link ICheckable} containing the checked elements to track |
| * @param elementType |
| * element type of the returned set |
| * @return an observable set tracking the checked elements of the given |
| * checkable. |
| * @since 1.2 |
| */ |
| public static IObservableSet observeCheckedElements(ICheckable checkable, |
| Object elementType) { |
| checkNull(checkable); |
| return ViewerProperties.checkedElements(elementType).observe(checkable); |
| } |
| |
| /** |
| * Returns an observable set that tracks the checked elements of the given |
| * viewer. Assumes that the viewer implements {@link ICheckable}. |
| * |
| * @param viewer |
| * {@link CheckboxTableViewer} containing the checked elements to |
| * track. |
| * @param elementType |
| * element type of the returned set |
| * @return an observable set that tracks the checked elements of the given |
| * viewer. |
| * @since 1.2 |
| */ |
| public static IViewerObservableSet observeCheckedElements( |
| CheckboxTableViewer viewer, Object elementType) { |
| checkNull(viewer); |
| return ViewerProperties.checkedElements(elementType).observe(viewer); |
| } |
| |
| /** |
| * Returns an observable set that tracks the checked elements of the given |
| * viewer. Assumes that the viewer implements {@link ICheckable}. |
| * |
| * @param viewer |
| * {@link CheckboxTreeViewer} containing the checked elements to |
| * track. |
| * @param elementType |
| * element type of the returned set |
| * @return an observable set that tracks the checked elements of the given |
| * viewer. |
| * @since 1.2 |
| */ |
| public static IViewerObservableSet observeCheckedElements( |
| CheckboxTreeViewer viewer, Object elementType) { |
| checkNull(viewer); |
| return ViewerProperties.checkedElements(elementType).observe(viewer); |
| } |
| |
| /** |
| * 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 calling |
| * {@link StructuredViewer#addFilter(org.eclipse.jface.viewers.ViewerFilter) |
| * addFilter()}, |
| * {@link StructuredViewer#removeFilter(org.eclipse.jface.viewers.ViewerFilter) |
| * removeFilter()}, or |
| * {@link StructuredViewer#setFilters(org.eclipse.jface.viewers.ViewerFilter[]) |
| * setFilters()}) -- it is assumed that filters are only changed through the |
| * returned set. |
| * |
| * @param viewer |
| * viewer containing the filters to be tracked |
| * @return an observable set that tracks the filters of the given viewer. |
| * @since 1.3 |
| */ |
| public static IViewerObservableSet observeFilters(StructuredViewer viewer) { |
| checkNull(viewer); |
| return ViewerProperties.filters().observe(viewer); |
| } |
| } |
