Class SWTObservables

java.lang.Object
org.eclipse.jface.databinding.swt.SWTObservables

@Deprecated public class SWTObservables 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. Use WidgetProperties instead.
A factory for creating observables for SWT widgets
Since:
1.1
Restriction:
  • Constructor Details

    • SWTObservables

      public SWTObservables()
      Deprecated.
  • Method Details

    • getRealm

      @Deprecated public static Realm getRealm(Display display)
      Deprecated.
      please use DisplayRealm.getRealm(Display) instead.
      Returns the realm representing the UI thread for the given display.
      Parameters:
      display - the display to get realm for
      Returns:
      the realm representing the UI thread for the given display
    • observeDelayedValue

      @Deprecated public static ISWTObservableValue observeDelayedValue(int delay, ISWTObservableValue observable)
      Deprecated.
      use WidgetProperties instead
      Returns an observable which delays notification of value change events from observable until delay milliseconds have elapsed since the last change event, or until a FocusOut event is received from the underlying widget (whichever happens first). This observable helps to boost performance in situations where an observable has computationally expensive listeners (e.g. changing filters in a viewer) or many dependencies (master fields with multiple detail fields). A common use of this observable is to delay validation of user input until the user stops typing in a UI field.

      To notify about pending changes, the returned observable fires a stale event when the wrapped observable value fires a change event, and remains stale until the delay has elapsed and the value change is fired. A call to getValue() while a value change is pending will fire the value change immediately, short-circuiting the delay.

      Only updates resulting from the observed widget are delayed. Calls directly to IObservableValue.setValue(T) are not, and they cancel pending delayed values.

      Note that this observable will not forward ValueChangingEvent events from a wrapped IVetoableValue.

      Parameters:
      delay - the delay in milliseconds
      observable - the observable being delayed
      Returns:
      an observable which delays notification of value change events from observable until delay milliseconds have elapsed since the last change event.
      Since:
      1.2
    • observeEnabled

      @Deprecated public static ISWTObservableValue observeEnabled(Widget widget)
      Deprecated.
      use WidgetProperties instead
      Returns an observable value tracking the enabled state of the given widget. The supported types are:
      • org.eclipse.swt.widgets.Control
      • org.eclipse.swt.widgets.Menu
      • org.eclipse.swt.widgets.MenuItem
      • org.eclipse.swt.widgets.ScrollBar
      • org.eclipse.swt.widgets.ToolItem
      Parameters:
      widget - the widget to observe
      Returns:
      an observable value tracking the enabled state of the given widget.
      Since:
      1.5
    • observeEnabled

      @Deprecated public static ISWTObservableValue observeEnabled(Control control)
      Deprecated.
      use WidgetProperties instead
      Returns an observable value tracking the enabled state of the given control
      Parameters:
      control - the control to observe
      Returns:
      an observable value tracking the enabled state of the given control
    • observeVisible

      @Deprecated public static ISWTObservableValue observeVisible(Control control)
      Deprecated.
      use WidgetProperties instead
      Returns an observable value tracking the visible state of the given control
      Parameters:
      control - the control to observe
      Returns:
      an observable value tracking the visible state of the given control
    • observeTooltipText

      @Deprecated public static ISWTObservableValue observeTooltipText(Widget widget)
      Deprecated.
      use WidgetProperties instead
      Returns an observable tracking the tooltip text of the given item. The supported types are:
      • org.eclipse.swt.widgets.Control
      • org.eclipse.swt.custom.CTabItem
      • org.eclipse.swt.widgets.TabItem
      • org.eclipse.swt.widgets.TableColumn
      • org.eclipse.swt.widgets.ToolItem
      • org.eclipse.swt.widgets.TrayItem
      • org.eclipse.swt.widgets.TreeColumn
      Parameters:
      widget - the widget to observe
      Returns:
      an observable value tracking the tooltip text of the given item
      Since:
      1.3
    • observeTooltipText

      @Deprecated public static ISWTObservableValue observeTooltipText(Control control)
      Deprecated.
      use WidgetProperties instead
      Returns an observable value tracking the tooltip text of the given control
      Parameters:
      control - the control to observe
      Returns:
      an observable value tracking the tooltip text of the given control
    • observeSelection

      @Deprecated public static ISWTObservableValue observeSelection(Widget widget)
      Deprecated.
      use WidgetProperties instead
      Returns an observable observing the selection attribute of the provided control. The supported types are:
      • org.eclipse.swt.widgets.Spinner
      • org.eclipse.swt.widgets.Button
      • org.eclipse.swt.widgets.Combo
      • org.eclipse.swt.custom.CCombo
      • org.eclipse.swt.widgets.List
      • org.eclipse.swt.widgets.MenuItem (since 1.5)
      • org.eclipse.swt.widgets.Scale
      Parameters:
      widget - the widget to observe
      Returns:
      observable value
      Throws:
      IllegalArgumentException - if control type is unsupported
      Since:
      1.5
    • observeSelection

      @Deprecated public static ISWTObservableValue observeSelection(Control control)
      Deprecated.
      use WidgetProperties instead
      Returns an observable observing the selection attribute of the provided control. The supported types are:
      • org.eclipse.swt.widgets.Button
      • org.eclipse.swt.widgets.Combo
      • org.eclipse.swt.custom.CCombo
      • org.eclipse.swt.widgets.List
      • org.eclipse.swt.widgets.Scale
      • org.eclipse.swt.widgets.Slider (since 1.5)
      • org.eclipse.swt.widgets.Spinner
      Parameters:
      control - the control to observe
      Returns:
      observable value
      Throws:
      IllegalArgumentException - if control type is unsupported
    • observeMin

      @Deprecated public static ISWTObservableValue observeMin(Control control)
      Deprecated.
      use WidgetProperties instead
      Returns an observable observing the minimum attribute of the provided control. The supported types are:
      • org.eclipse.swt.widgets.Spinner
      • org.eclipse.swt.widgets.Slider (since 1.5)
      • org.eclipse.swt.widgets.Scale
      Parameters:
      control - the control to observe
      Returns:
      observable value
      Throws:
      IllegalArgumentException - if control type is unsupported
    • observeMax

      @Deprecated public static ISWTObservableValue observeMax(Control control)
      Deprecated.
      use WidgetProperties instead
      Returns an observable observing the maximum attribute of the provided control. The supported types are:
      • org.eclipse.swt.widgets.Spinner
      • org.eclipse.swt.widgets.Slider (since 1.5)
      • org.eclipse.swt.widgets.Scale
      Parameters:
      control - the control to observe
      Returns:
      observable value
      Throws:
      IllegalArgumentException - if control type is unsupported
    • observeText

      @Deprecated public static ISWTObservableValue observeText(Control control, int[] events)
      Deprecated.
      use WidgetProperties instead
      Returns an observable observing the text attribute of the provided control. The supported types are:
      • org.eclipse.swt.widgets.Text
      • org.eclipse.swt.custom.StyledText (as of 1.3)
      Parameters:
      control - the control to observe
      events - array of SWT event types to register for change events. May include SWT.None, SWT.Modify, SWT.FocusOut or SWT.DefaultSelection.
      Returns:
      observable value
      Throws:
      IllegalArgumentException - if control type is unsupported
      Since:
      1.3
    • observeText

      @Deprecated public static ISWTObservableValue observeText(Control control, int event)
      Deprecated.
      use WidgetProperties instead
      Returns an observable observing the text attribute of the provided control. The supported types are:
      • org.eclipse.swt.widgets.Text
      • org.eclipse.swt.custom.StyledText (as of 1.3)
      Parameters:
      control - the control to observe
      event - event type to register for change events
      Returns:
      observable value
      Throws:
      IllegalArgumentException - if control type is unsupported
    • observeText

      @Deprecated public static ISWTObservableValue observeText(Widget widget)
      Deprecated.
      use WidgetProperties instead
      Returns an observable observing the text attribute of the provided widget. The supported types are:
      • org.eclipse.swt.widgets.Button (as of 1.3)
      • org.eclipse.swt.custom.CCombo
      • org.eclipse.swt.custom.CLabel
      • org.eclipse.swt.widgets.Combo
      • org.eclipse.swt.widgets.Group (as of 1.7)
      • org.eclipse.swt.widgets.Item
      • org.eclipse.swt.widgets.Label
      • org.eclipse.swt.widgets.Link (as of 1.2)
      • org.eclipse.swt.widgets.Shell
      • org.eclipse.swt.widgets.StyledText (as of 1.3)
      • org.eclipse.swt.widgets.Text (as of 1.3)
      Parameters:
      widget - the widget to observe
      Returns:
      observable value
      Throws:
      IllegalArgumentException - if the type of widget is unsupported
      Since:
      1.3
    • observeText

      @Deprecated public static ISWTObservableValue observeText(Control control)
      Deprecated.
      use WidgetProperties instead
      Returns an observable observing the text attribute of the provided control. The supported types are:
      • org.eclipse.swt.widgets.Button (as of 1.3)
      • org.eclipse.swt.custom.CCombo
      • org.eclipse.swt.custom.CLabel
      • org.eclipse.swt.widgets.Combo
      • org.eclipse.swt.widgets.Group (as of 1.7)
      • org.eclipse.swt.widgets.Label
      • org.eclipse.swt.widgets.Link (as of 1.2)
      • org.eclipse.swt.widgets.Shell
      • org.eclipse.swt.custom.StyledText (as of 1.3)
      • org.eclipse.swt.widgets.Text (as of 1.3)
      Parameters:
      control - the control to observe
      Returns:
      observable value
      Throws:
      IllegalArgumentException - if control type is unsupported
    • observeMessage

      @Deprecated public static ISWTObservableValue observeMessage(Widget widget)
      Deprecated.
      use WidgetProperties instead
      Returns an observable observing the message attribute of the provided widget. the supported types are:
      • org.eclipse.swt.widgets.Text
      • org.eclipse.swt.widgets.ToolTip
      Parameters:
      widget - the widget to observe
      Returns:
      an observable observing the message attribute of the provided widget.
      Since:
      1.3
    • observeImage

      @Deprecated public static ISWTObservableValue observeImage(Widget widget)
      Deprecated.
      use WidgetProperties instead
      Returns an observable observing the image attribute of the provided widget. The supported types are:
      • org.eclipse.swt.widgets.Button
      • org.eclipse.swt.custom.CLabel
      • org.eclipse.swt.widgets.Item
      • org.eclipse.swt.widgets.Label
      Parameters:
      widget - the widget to observe
      Returns:
      observable value
      Throws:
      IllegalArgumentException - if widget type is unsupported
      Since:
      1.3
    • observeItems

      @Deprecated public static IObservableList observeItems(Control control)
      Deprecated.
      use WidgetProperties instead
      Returns an observable observing the items attribute of the provided control. The supported types are:
      • org.eclipse.swt.widgets.Combo
      • org.eclipse.swt.custom.CCombo
      • org.eclipse.swt.widgets.List
      Parameters:
      control - the control to observe
      Returns:
      observable list
      Throws:
      IllegalArgumentException - if control type is unsupported
    • observeSingleSelectionIndex

      @Deprecated public static ISWTObservableValue observeSingleSelectionIndex(Control control)
      Deprecated.
      use WidgetProperties instead
      Returns an observable observing the single selection index attribute of the provided control. The supported types are:
      • org.eclipse.swt.widgets.Table
      • org.eclipse.swt.widgets.Combo
      • org.eclipse.swt.custom.CCombo
      • org.eclipse.swt.widgets.List
      Parameters:
      control - the control to observe
      Returns:
      observable value
      Throws:
      IllegalArgumentException - if control type is unsupported
    • observeForeground

      @Deprecated public static ISWTObservableValue observeForeground(Control control)
      Deprecated.
      use WidgetProperties instead
      Returns an observable value tracking the foreground color of the given control
      Parameters:
      control - the control to observe
      Returns:
      an observable value tracking the foreground color of the given control
    • observeBackground

      @Deprecated public static ISWTObservableValue observeBackground(Control control)
      Deprecated.
      use WidgetProperties instead
      Returns an observable value tracking the background color of the given control
      Parameters:
      control - the control to observe
      Returns:
      an observable value tracking the background color of the given control
    • observeFont

      @Deprecated public static ISWTObservableValue observeFont(Control control)
      Deprecated.
      use WidgetProperties instead
      Returns an observable value tracking the font of the given control.
      Parameters:
      control - the control to observe
      Returns:
      an observable value tracking the font of the given control
    • observeSize

      @Deprecated public static ISWTObservableValue observeSize(Control control)
      Deprecated.
      use WidgetProperties instead
      Returns an observable value tracking the size of the given control.
      Parameters:
      control - the control to observe
      Returns:
      an observable value tracking the size of the given control
      Since:
      1.3
    • observeLocation

      public static ISWTObservableValue observeLocation(Control control)
      Deprecated.
      Returns an observable value tracking the location of the given control.
      Parameters:
      control - the control to observe
      Returns:
      an observable value tracking the location of the given control
      Since:
      1.3
    • observeFocus

      @Deprecated public static ISWTObservableValue observeFocus(Control control)
      Deprecated.
      use WidgetProperties instead
      Returns an observable value tracking the focus of the given control.
      Parameters:
      control - the control to observe
      Returns:
      an observable value tracking the focus of the given control
      Since:
      1.3
    • observeBounds

      @Deprecated public static ISWTObservableValue observeBounds(Control control)
      Deprecated.
      use WidgetProperties instead
      Returns an observable value tracking the bounds of the given control.
      Parameters:
      control - the control to observe
      Returns:
      an observable value tracking the bounds of the given control
      Since:
      1.3
    • observeEditable

      @Deprecated public static ISWTObservableValue observeEditable(Control control)
      Deprecated.
      use WidgetProperties instead
      Returns an observable observing the editable attribute of the provided control. The supported types are:
      • org.eclipse.swt.custom.CCombo (since 1.6)
      • org.eclipse.swt.custom.StyledText (since 1.6)
      • org.eclipse.swt.widgets.Text
      Parameters:
      control - the control to observe
      Returns:
      observable value
      Throws:
      IllegalArgumentException - if control type is unsupported